29.12.2020

Настройки интеграции Oki-Toki с AMOCRM

Подробная инструкция, как настроить интеграцию облачного сервиса для организации КЦ Оки-Токи с AMOCRM.

fon

Содержание:

  1. Интеграция: возможности
  2. Создание плагинов
  3. Подключение виджета в АмоСRМ
  4. Создание webhook-а для:
    • создания сделок\контактов в AMOCRM при событиях из Оки-Токи (входящих звонках, нажатиях по ИВР и т.д);
    • прозвона по событиям из AMOCRM: создание лида, смена статуса лида
  5. Подключение интеграции и настройка в личном кабинете

Интеграция: возможности

Интеграция Оки — Токи и AmoCRM предоставляет нашим клиентам следующие возможности: 

  •  Добавление для прозвона в Автодозвон Оки-Токи  сделок\лидов  из AmoCRM при таких действия как: 
    • Создание сделки;
    • Создание контакта;
    • Создание контакта и сделки;
    • Обновление статуса сделки;
    • Ручное добавление из Амо СРМ
  • Создание сделок в AmoCRM  при:
    • Изменения статуса звонка (задачи) в Оки-Токи;
    • При выбранных событиях в ИВР.

Создание плагина

Для начала необходимо создать плагин, где будут указаны все регистрационные данные Пользователя AmoCRM  в системе Оки-Токи. Для этого переходим в меню “Интеграции” — “Плагины” — нажимаем “ Добавить”.

Далее приступаем к заполнению: укажите название плагина и укажите в “Интеграции” пункт AmoCRM.

Создание плагина Оки-Токи

АмоСРМ больше не предоставляет открытые апи-ключи и авторизацию необходимо будет настроить после создания первого плагина. После нажатия на кнопку “Сохранить” у вас будет такой  запрос на добавление авторизации, нажимаем на кнопку установить интеграцию и в открывшемся окне выберите аккаунт АмоСРМ с каким нужно интегрироваться и нажмите “Разрешить”. Интеграция будет установлена в автоматическом режиме и в настройках плагина вы увидите что  ваш АмоСРМ аккаунт связан. Если в будущем понадобится изменить аккаунт в плагине вы можете изменить текущие настройки или создать новый плагин.

Оки-Токи и АмоСРМ

Второй плагин необходим для  работы с запросами с нашей стороны. Создаете так  же как и первый, только в пункте “Интеграция” выбираете Web-Hook и сохраните его. Больше никаких действий и дополнительных настроек в Оки-Токи не требуется. 

Оки-Токи плагин амосрм

Если Вы все сделали верно то у вас должно быть 2 плагина: для  AmoCRM и веб хуков. 

В АмоСРМ необходимо будет создать интеграцию с Оки-Токи. Для этого заходим в “Настройки” — “Интеграции” — “Web Hooks”

oki-roki amocrm

oki-roki amocrm

В поле URL необходимо прописать такую ссылку :
https://comp_domain.oki-toki.net/api/v1/amo?api_token=f5926f28c7**********85b6c4957955&plugin=123 , где нужно подставить свои данные из Личного кабинета.
comp_domain — указан в адресной строке Вашего личного кабинета

Оки-Токи
api_token — берется в настройках пользователя Администратора.

Оки-токи плагин амосрм
plugin — номер плагина также можно взять из адресной строки, зайдя в настройки необходимого плагина

Подключение и настройка виджета в АмоСRМ

Чтобы подключить виджет Оки-Токи для АмоСРМ необходимо:

● В аккаунте АмоСРМ зайти в настройки (нужны соответствующие права) в строке поиска начать вводить имя виджета и после того как нужный виджет будет найден — нажать установить

● Ставим галочку подтверждения передачи информации м жмем “Установить”

● После установки виджета нужно будет прописать апи-токен пользователя (генерируется в настройках пользователя в Оки токи) в соответствующее поле сотрудника АмоСРМ для возможности звонков из карточки лида в АмоСРМ через оперместо
Для каждого пользователя (оператора) нужно отдельно генерировать и вносить его апи-токен в виджет.

● В настройках личного кабинета в разделе “Интеграции” выбираем пункт “Внешние ресурсы” , нажимаем “Подключить“ и в списке выбираем АмоСРМ

● В настройках даем название виджету, обязательно указываем плагин (тот где привязана авторизация с АмоСРМ, а также в этом виджете подключаются необходимые очереди и автодозвоны (для автоматического открытия анкет) и логирование событий по ним
АмоСРМ в Оки-Токи
После того как интеграцию и настройку виджетов закончили вам будут доступны следующие функции:
● Звонки из карточки лида в АмоСРМ по клику (для совершения звонка оператор должен быть в оперместе)
● Ручное добавление задач через управление списками. Нужно только выделить необходимые задачи и через меню можно добавить или удалить из нужного автообзвона.
● Логирование истории звонков по автодозвонам и очередям, а также прослушивание записей разговоров из карточки клиента.

Webhook для создания сделок\контактов в AMOCRM при событиях из Оки-Токи

Переходим к решению первого кейса — создание вебхука для создания сделок при событиях из Оки-Токи.

Зададим условие для кейса, что у нас поступают звонки, клиент слушает сообщение и в зависимости от его выбора (например клиент нажимает “1” после прослушивания сообщения информатора) создается сделка в АмоСРМ.

Переходим в меню Интеграции — События

Даем название интеграции, выбираем необходимое событие (возьмем например Функцию звонка), выбираем наш созданный ранее плагин для АмоСРМ, выбираем необходимое действие для нашего хука (например, создание сделки и контакта в АмоСРМ, состояние хука — Активно. Далее переходим к Условиям срабатывания.

Для нашего кейса необходимо при нажатии на “1” в кубике ИВР 2.0 отправлять сделку в АмоСРМ.
Порядок действий:
● Сначала указываем в каком сценарии находится необходимый нам элемент (Сценарий.ID)
● Дальше выбираем элемент (“кубик”) в этом сценарии (Номер кубика сценария)
● для кубика ИВР 2.0 с DTMF-нажатиями требуется указать номер выхода из кубика

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

Следующим этапом будет настройка Параметров действия — эти поля отвечают за то, где в АмоСРМ создавать лида. Для завершения создания вебхука нужно заполнить все обязательные поля.
амосрм
Поле авторизации заполняется автоматически, его не заполняем.

Потом надо указать как будет называться сделка в АмоСРМ — Если вы хотите чтобы в имени было присвоено определенное значение передаваемое переменной, его нужно указать через двойные фигурные скобки — {{}}. Например, нашей сделка будет содержать номер телефона клиента который нажал на определенный вариант ответа. Это будет выглядеть так: “Клиент 7916******* нажал 1”, а в поле “Название” мы пропишем это как “Клиент {{dnis}} нажал 1”, где переменная {{dnis}} — это номер клиента которому набрал автодозвон (со списком переменных можно ознакомиться тут .

Поле “Статус” — Выбираете необходимый статус который соответствует одному из статусов в Вашей АмоСРМ ;

Поле “Воронка” — выбираете необходимую воронку из АмоСРМ;

Поле “Ответственный” — аналогично предыдущим полям, назначаем ответственного.

Остальные поля также соответствуют таковым в АмоСРМ, необходимо только указывать какие будут заполнены (по необходимости).

Обратите внимание, если плагин с данными был заполнен корректно и подключен вебхук в АмоСРМ, то Ваши данные из АмоСРМ корректно подтягиваются в Оки-Токи в соответствующих полях “Статус”, “Воронка” и т.д.

Теперь у Вас есть рабочая интеграция, которая срабатывает при нажатии определенной цифры пользователем после прослушивания сообщения в ИВР и создает лида в АмоСРМ с заданными параметрами.

Webhook для создания задачи на прозвон в автодозвоне Оки-Токи при событиях из AmoCRM

Вторым важным кейсом является создание задачи на прозвон при событиях в АмоСРМ.

Некоторые элементы (плагины) мы уже создавали на предыдущем шаге, они нам понадобятся и в будущем.

Заходим в меню Интеграции — События — создаем новое событие.

Даем ему название, Событие — AmoCRM, подключаем второй плагин (там где вебхук), Действие по умолчанию, Состояние активно, Описание по желанию.

Далее идет настройка “Условий срабатывания”.
Тут необходимо выбрать при каких условиях будет срабатывать наш вебхук, например мы хотим чтобы только при создании сделки в статусе “Новая заявка” он попадал на прозвон. Условий может быть несколько, но мы сейчас рассматриваем самый простой кейс.
После того как выбраны условия срабатывания — настроим ссылку, по какой будем отправлять событие. Сделать это можно в следующем пункте — Параметры действия.

Пример ссылки: https://compdomain.oki-toki.net/api/v1/dialers/create_task?api_token=********************&dialer_id=1&phones={{phone}}&&details={«lead»:»{{lead_id}}»}
Тип действия — POST.

Некоторые данные (compdomain, API-token, dialer_id) мы уже рассматривали где получить в Оки-Токи, остальные параметры — это то что мы передаем из АмоСРМ: номера телефонов и доп. параметры (details) если они нужны.

В данном случае мы еще дополнительно передаем уникальный ID сделки для последующего открытия карточки клиента из АмоСРМ при соединении с оператором.

Со стороны АмоСРМ в разделе Настройки — Интеграция — Webhooks (для активации нужна расширенная учетная запись в АмоСРМ) мы уже прописали ранее ссылку на наши плагины, не забываем также выставить параметры срабатывания, желательно оставлять только те события по которым ожидаем события, иначе АмоСРМ может принять много запросов за спам и отключить вебхук.

вебхуки Оки-Токи

В целом это все что необходимо. Далее можно проводить разные комбинации условий и действий как со стороны Оки-Токи, так и АмоСРМ.

Оцените новость:
1 Звезда2 Звезды3 Звезды4 Звезды5 Звезд (1 оценок, среднее: 5,00 из 5)
Загрузка...

Читайте так же

photo
15.05.2020 Дайджест новостей Оки-Токи за апрель 2020

Новости Оки-Токи за апрель 2020: определение часового пояса в операторском месте и большая чистка багов. Читайте подробнее!

Подробнее
photo
17.06.2019 Как хранятся файлы записей разговоров? Надёжно и просто!

Для хранения файлов вы можете использовать хранилище Оки-Токи, а также хранилище Google, Yandex, Dropbox. Как? Читайте в этой заметке!

Подробнее