README.md

amocrm

Пакет для работы с AmoCRM API в R.

UPD: Так как AmoCRM ввели OAUTH2, а пакет работает на старом методе (токенах) и не переписывался для нового — вот воркэраунд получения токена.

Документация и инструкции здесь. Пожалуйста, прочтите их перед началом работы с пакетом. Если возникают проблемы — оформляйте issue здесь или пишите в телеграм @grkhr.

Важно: База AmoCRM — документоориентированное хранилище, где какому-либо параметру каждой сущности может соответствовать несколько значений (например, мультисписки). Поэтому на выходе не всегда можно сразу получить tidy-датафрейм, рекомендуется разобраться в сущностях и связях AmoCRM перед использованием пакета.

Установка

#install.packages("devtools")
devtools::install_github("grkhr/amocrm")

Quick start

Для использования пакета нужны e-mail, API-ключ и домен. Их можно найти тут: xxx.amocrm.ru/settings/profile/, где xxx — ваш поддомен.

UPD: Так как AmoCRM ввели OAUTH2, а пакет работает на старом методе (токенах) и не переписывался для нового — вот воркэраунд получения токена.

library(amocrm)

# авторизационные данные
auth_list <- AmoAuthList(email = "test@test.ru", apikey = "test", domain = "test")

# получение списка пользователей
users <- AmoUsers(auth_list = auth_list)

# получение сделок
leads <- AmoLeads(auth_list = auth_list)

# получение изменений этапов сделок с 1 июня 2019
notes <- AmoNotes(auth_list = auth_list, type = 'lead', note_type = 3, if_modified_since = '2019-06-01 00:00:00')

Важно: Все параметры типа datetime возвращаются в таймзоне вашего аккаунта. С фильтрами то же самое. Пакет сам конвертирует время из/в UTC, дополнительных действий не требуется.

Документация

Подробное описание функций, параметров и выходных данных



grkhr/amocrm documentation built on May 24, 2021, 5:24 a.m.