Получение событий из Клиентикс CRM Отправка сообщения в MAX

Интеграция

Получение событий из Клиентикс CRM Отправка сообщения в MAX

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

  1. Приём событий из Клиентикс CRM через HTTP webhook: URL в clientix/admin/eventHandlers, настройка обработчика событий в админке CRM для выбранного типа события.
  2. Настройка отправки сообщения в MAX: подключение, форматирование текста, опции уведомления и текст сообщения для чата или канала.

Отдельные инструкции: источник «Получение событий из Клиентикс CRM» · действие «Отправка сообщения в MAX»

Создание подключений

Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в WebJack, можно сразу перейти к настройке источника и действия ниже.

Подключение MAX

Создание подключения

  1. В меню откройте «Подключения» и нажмите «+».
    Подключение MAX: В меню откройте «Подключения» и нажмите «+»
  2. Выберите тип «MAX».
    Подключение MAX: Выберите тип «MAX»
  3. Укажите название подключения и нажмите «Подключить».
    Подключение MAX: Укажите название подключения и нажмите «Подключить»
  4. Скопируйте уникальное сообщение с токеном.
    Подключение MAX: Скопируйте уникальное сообщение с токеном

Личный чат

  1. Найдите в MAX бота WebJack (@id753610300851_bot).
  2. Отправьте ему скопированное сообщение с токеном.
    Подключение MAX: Отправьте ему скопированное сообщение с токеном
  3. Дождитесь ответа бота, что подключение создано.
    Подключение MAX: Дождитесь ответа бота, что подключение создано

Группа

  1. Добавьте бота WebJack (@id753610300851_bot) в группу и сделайте его администратором.
  2. Отправьте в группу скопированное сообщение нового подключения.
    Подключение MAX: Отправьте в группу скопированное сообщение нового подключения
  3. Дождитесь ответа бота, что подключение создано.
    Подключение MAX: Дождитесь ответа бота, что подключение создано

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

integrations: В левом меню откройте «Обработки» и нажмите «+»

В списке типов источника выберите «klientiks.ru» и нажмите кнопку «Выбрать».

Источник «klientiks.ru»

Клиентикс CRM отправляет события на webhook URL. Создайте обработчик в eventHandlers и укажите URL источника.

URL вебхука

  1. Выберите нужный тип источника и нажмите «Выбрать».
  2. Нажмите «Сохранить».
  3. Скопируйте «URL» целиком - адрес уже содержит параметры приёма данных.

Обработчик в Клиентикс

  1. В Клиентикс CRM откройте https://klientiks.ru/clientix/admin/eventHandlers.
  2. Создайте или отредактируйте обработчик нужного события.
  3. Вставьте скопированный URL источника.
  4. Сохраните обработчик событий.

Действие «Отправить сообщение в MAX»

Сообщение уходит в чат из выбранного подключения MAX. Выберите подключение, форматирование и заполните текст.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
actions: Перейдите в обработке во вкладку Действия и нажмите на кнопку Добавить действие

Подключение

  1. В поле «Подключение» выберите подключение MAX.

Параметры сообщения

  1. В поле «Форматирование» выберите «Текст», «Markdown» или «HTML».
  2. При необходимости включите «Отключить предпросмотр ссылок» и «Не уведомлять».
  3. В поле «Текст» введите сообщение или подставьте переменные из сценария.
    Отправка сообщения в MAX: В поле «Текст» введите сообщение или подставьте переменные из сценария
  4. Нажмите «Сохранить».

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

integrations: Входящие данные, статус и история отобразятся в «Истории операций»