Использование API amoCRM — различия между версиями

Материал из Oktell
Перейти к: навигация, поиск
(Новая страница: « Наверх __TOC__ '''amoCRM''' — это простая и понятная система учета п...»)
 
м
 
(не показаны 3 промежуточные версии этого же участника)
Строка 1: Строка 1:
 
[[Интеграции_с_CRM_системами | Наверх]]
 
[[Интеграции_с_CRM_системами | Наверх]]
−
 
−
__TOC__
 
  
  
Строка 15: Строка 13:
  
 
В этой статье описывается пример подключения и использования API-интерфейса средствами '''Oktell'''.  
 
В этой статье описывается пример подключения и использования API-интерфейса средствами '''Oktell'''.  
−
 
  
 
Рассмотрим задачу получения списка всех клиентов и выделения имени первого клиента с помощью команды API: '''/private/api/v2/json/contacts/list'''
 
Рассмотрим задачу получения списка всех клиентов и выделения имени первого клиента с помощью команды API: '''/private/api/v2/json/contacts/list'''
Строка 22: Строка 19:
  
  
−
[[Файл:API мегаплана-001.png|center]]
+
[[Файл:API amoCRM -001.png|center]]
  
  
 
'''Шаг 1.''' Для начала работы введите ваши авторизационные данные в компоненте "'''Учетная запись'''".  
 
'''Шаг 1.''' Для начала работы введите ваши авторизационные данные в компоненте "'''Учетная запись'''".  
−
* Переменной URL присваивается
+
* Переменной '''URL''' присвойте точный адрес вашего аккаунта - например, https://test.amocrm.ru
−
* Переменной Iser_Login
+
* Переменной '''User_Login''' присвойте логин пользователя
−
* Переменной Iser_Login
+
* Переменной '''User_Hash''' присвойте ключ для авторизации в API.
 +
 
 +
 
 +
[[Файл:API amoCRM -002.png|center|600px]]
 +
 
 +
 
 +
'''User Hash''' (ключ для авторизации в API) можно узнать в amoCRM в настройках пользователя (страница "'''Пользователи аккаунта'''").
 +
 
 +
 
 +
[[Файл:API amoCRM -003.png|center|800px]]
 +
 
 +
 
 +
'''Шаг 2.''' Введите необходимый запрос в компоненте "'''Запрос'''". В примере: '''/private/api/v2/json/contacts/list'''
 +
 
  
 +
[[Файл:API amoCRM -004.png|center]]
  
  
 +
'''Шаг 3.''' Для отладки сценария во всех компонентах типа '''Уведомление''' определите '''Адресата'''.
  
−
'''Шаг 2.''' Введите необходимый запрос в компоненте "'''Запрос'''". В примере: '''/BumsCrmApiV01/Contractor/list.xml'''
+
'''Шаг 4.''' Результат запроса от amoCRM приходит в формате JSON. Для определения параметров из выборки используйте парсер JSON. В примере показано как получить имя первого клиента из списка.  
  
 +
* '''Документ''' - переменная ans, в которой содержится JSON-структура со списком клиентов.
 +
* '''Алгоритм''' - Парсер JSON
 +
* '''Поисковый запрос''' - строка ''"response"/"contacts"/0/"name"''
 +
* '''Функция''' - Содержимое
 +
* '''Результат в переменную''' - переменная '''ans1''' (строковая)
  
−
[[Файл:API мегаплана-002.png|center|1000px]]
 
  
 +
[[Файл:API amoCRM -005.png|center]]
  
−
'''Шаг 3.''' Во всех компонентах типа '''Уведомление''' определите '''Адресата'''.
 
  
−
'''Шаг 4.''' Запустите сценарий. Вы должны получить список всех клиентов, определенных в вашем '''Мегаплане''' в формате XML.
+
'''Шаг 5.''' Запустите сценарий. Вы должны получить имя первого клиента, определенного в вашей '''amoCRM'''.  
  
  
−
[[Файл:API мегаплана-004.png|center]]
+
[[Файл:API amoCRM -006.png|center]]
  
  
−
С полученным списком вы сможете производить любые действия: подсчитывать количество клиентов в вашей компании, записывать в базу данных и т.д. Для выделения необходимой информации используйте [[Компонент Парсер|компонент '''Парсер''']].
+
Аналогичным образом вы сможете производить любые действия: подсчитывать количество клиентов в вашей компании, записывать в базу данных и т.д. Для выделения необходимой информации используйте JSON-парсер. Подробнее можно прочитать в статье [[Компонент Парсер|компонент Парсер]].
  
−
Вы можете не только получать информацию из системы, а также совершать служебные действия - создавать сделку, добавлять клиента. Для этого используйте необходимый запрос в компоненте "'''Запрос'''". Посмотреть список всех запросов можно в справке по API Мегаплана: [http://help.megaplan.ru/API http://help.megaplan.ru/API]
+
Вы можете не только получать информацию из системы, но и совершать служебные действия - создавать сделку, добавлять клиента. Для этого используйте необходимый запрос в компоненте "'''Запрос'''". Посмотреть список всех запросов можно в справке по API amoCRM: https://www.amocrm.ru/add-ons/api.php или https://developers.amocrm.ru/rest_api/
  
  
−
'''Скачать сценарий:''' [http://wiki.oktell.ru/images/7/79/API_%D0%9C%D0%B5%D0%B3%D0%B0%D0%BF%D0%BB%D0%B0%D0%BD%D0%B0.zip API Мегаплана.zip] (для версий старше 2.10 140331)
+
'''Скачать сценарий:''' [[Media:API_amoCRM.oscr|API_amoCRM.oscr]] (для версий старше 2.9 131007)

Текущая версия на 12:37, 31 марта 2023

Наверх


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)

Источник — «https://wiki.oktell.ru/index.php?title=Использование_API_amoCRM&oldid=13758»