Использование API amoCRM

Материал из Oktell
Перейти к: навигация, поиск

Наверх


amoCRM — это простая и понятная система учета потенциальных клиентов и сделок, которая поможет контролировать и увеличивать Ваши продажи. Она не требует установки или настройки — достаточно зарегистрироваться на этом сайте и ваша персональная CRM система готова к работе.

Сайт компании: https://www.amocrm.ru/


amoCRM имеет удобный API-интерфейс, позволяющий с помощью специальных запросов обмениваться данными со сторонними системами, в том числе и с Oktell. С помощью этого интерфейса вы сможете с помощью запросов создавать задачи, добавлять сотрудников, получать список клиентов. Например, при входящем звонке в Oktell возможно параллельное создание контакта в amoCRM с заполненным номером телефона. Если же использовать диалоговые карточки Call-центра, возможна упрощенная схема создания заявок с назначением ответственных менеджеров.

Справка по API amoCRM: https://www.amocrm.ru/add-ons/api.php или https://developers.amocrm.ru/rest_api/


В этой статье описывается пример подключения и использования API-интерфейса средствами Oktell.

Рассмотрим задачу получения списка всех клиентов и выделения имени первого клиента с помощью команды API: /private/api/v2/json/contacts/list

Сценарий выглядит следующим образом:


API amoCRM -001.png


Шаг 1. Для начала работы введите ваши авторизационные данные в компоненте "Учетная запись".

  • Переменной URL присвойте точный адрес вашего аккаунта - например, https://test.amocrm.ru
  • Переменной User_Login присвойте логин пользователя
  • Переменной User_Hash присвойте ключ для авторизации в API.


API amoCRM -002.png


User Hash (ключ для авторизации в API) можно узнать в amoCRM в настройках пользователя (страница "Пользователи аккаунта").


API amoCRM -003.png


Шаг 2. Введите необходимый запрос в компоненте "Запрос". В примере: /private/api/v2/json/contacts/list


API amoCRM -004.png


Шаг 3. Для отладки сценария во всех компонентах типа Уведомление определите Адресата.

Шаг 4. Результат запроса от amoCRM приходит в формате JSON. Для определения параметров из выборки используйте парсер JSON. В примере показано как получить имя первого клиента из списка.

  • Документ - переменная ans, в которой содержится JSON-структура со списком клиентов.
  • Алгоритм - Парсер JSON
  • Поисковый запрос - строка "response"/"contacts"/0/"name"
  • Функция - Содержимое
  • Результат в переменную - переменная ans1 (строковая)


API amoCRM -005.png


Шаг 5. Запустите сценарий. Вы должны получить имя первого клиента, определенного в вашей amoCRM.


API amoCRM -006.png


Аналогичным образом вы сможете производить любые действия: подсчитывать количество клиентов в вашей компании, записывать в базу данных и т.д. Для выделения необходимой информации используйте JSON-парсер. Подробнее можно прочитать в статье компонент Парсер.

Вы можете не только получать информацию из системы, но и совершать служебные действия - создавать сделку, добавлять клиента. Для этого используйте необходимый запрос в компоненте "Запрос". Посмотреть список всех запросов можно в справке по API amoCRM: https://www.amocrm.ru/add-ons/api.php или https://developers.amocrm.ru/rest_api/


Скачать сценарий: API_amoCRM.oscr (для версий старше 2.9 131007)