МАКС

Материал из Planfix

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

Возможности

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

Как подключить

Зарегистрируйтесь в МАКС Business

  • Перейдите в МАКС Business
  • Создайте корпоративный аккаунт.
  • После регистрации вы сможете добавить бота, через которого будут поступать сообщения в ПланФикс.

Создайте бота

  • В личном кабинете МАКС создайте бота по инструкции
  • Бот будет отправлен на модерацию со стороны МАКС.

Дождитесь модерации

  • После проверки бот получит соответствующий статус.
  • В интерфейсе МАКС станет доступен токен доступа — уникальный ключ для интеграции.

Добавьте токен в ПланФикс

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

Как принимать сообщения из МАКС в ПланФикс

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

  • Клиент пишет в МАКС
  • Сообщение через интеграцию попадает в ПланФикс
  • Создаётся задача
  • Назначается ответственный
  • Вся переписка ведется и сохраняется внутри задачи

Пример обработки таких заявок в ПланФиксе смотрите в видео:

Групповые чаты

  • Для того, чтобы получать сообщения в ПланФиксе из группового чата в МАКСе, добавьте бота МАКС в этот групповой чат в качестве администратора. Для этого активируйте добавление бота МАХ в групповые чаты. Подробности настройки в документации МАКСа.

Установка секрета для внешнего вебхука

Если вебхук бота MAX настраивается и управляется внешним сервисом, укажите его секрет в ПланФиксе через REST API. После этого ПланФикс будет проверять секрет во всех входящих webhook-запросах. 

  curl -X POST \
    "https://ваш_аккаунт.planfix.ru/rest/integration/max/bots/идентификатор_бота/webhook" \
    -H "Authorization: Bearer REST-токен" \
    -H "Content-Type: application/json" \
    -d '{
      "secret": "ваш-секрет",
      "webhookManagedExternally": true
    }'

где:

  • идентификатор_бота — идентификатор бота MAX в ПланФиксе;
  • REST-токен — REST-токен администратора аккаунта с правом доступа к системным настройкам;
  • secret — секрет для проверки входящих webhook-запросов;
  • webhookManagedExternally — признак того, что вебхук управляется внешним сервисом.

Секрет должен содержать от 5 до 256 символов. Допустимы латинские буквы, цифры, дефис (-) и подчёркивание (_).

В каждом webhook-запросе внешний сервис должен передавать тот же секрет в HTTP-заголовке: 

X-Max-Bot-Api-Secret: ваш-секрет

Если заголовок отсутствует или содержит неверный секрет, ПланФикс возвращает ответ 401 Unauthorized.

Пример успешного ответа REST API: 

  {
    "result": "success",
    "botId": 12345,
    "webhookManagedExternally": true,
    "webhookSecretConfigured": true
  }

Значение секрета не возвращается в ответе.

Дополнительно

Перейти