Интеграция
Получение событий из Клиентикс CRM → Запись значения в хранилище
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Приём событий из Клиентикс CRM через HTTP webhook: URL в clientix/admin/eventHandlers, настройка обработчика событий в админке CRM для выбранного типа события.
- Сохранение или обновление записи в хранилище проекта: выберите хранилище, укажите ключ и отметьте поля, которые нужно записать.
Отдельные инструкции: источник «Получение событий из Клиентикс CRM» · действие «Запись значения в хранилище»
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
В списке типов источника выберите «klientiks.ru» и нажмите кнопку «Выбрать».
Источник «klientiks.ru»
Клиентикс CRM отправляет события на webhook URL. Создайте обработчик в eventHandlers и укажите URL источника.
URL вебхука
- Выберите нужный тип источника и нажмите «Выбрать».
- Нажмите «Сохранить».
- Скопируйте «URL» целиком - адрес уже содержит параметры приёма данных.
Обработчик в Клиентикс
- В Клиентикс CRM откройте
https://klientiks.ru/clientix/admin/eventHandlers. - Создайте или отредактируйте обработчик нужного события.
- Вставьте скопированный URL источника.
- Сохраните обработчик событий.
Действие «Установить значение в хранилище»
В хранилище проекта сохранится или обновится запись по ключу. Выберите хранилище, укажите ключ и отметьте поля со значениями для записи.
Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
Для чего нужен
Действие «Установить значение в хранилище» создаёт или обновляет запись по ключу. Можно изменить только отмеченные поля, остальные значения записи сохранятся.
Как настроить
1. Выберите «Установить значение в хранилище» и нажмите «Выбрать».
2. В поле «Хранилище» выберите нужное хранилище проекта.
3. В поле «Ключ» укажите ключ записи: константу или значение из предыдущих шагов.
4. В блоке «Поля» отметьте поля для записи и задайте им значения.
5. Нажмите «Сохранить».
Когда использовать
Используйте, когда нужно сохранить состояние между запусками: последний статус, счётчик обращений, связь ID диалога с менеджером или другие общие данные проекта.
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».