Интеграция Mindbox с TextBack

TextBack — это платформа для общения с клиентами в WhatsApp, Telegram или любом другом мессенджере.

Возможности интеграции Mindbox с TextBack

Доступна двусторонняя интеграция:

• TextBack → Mindbox — передача событий клиентов и изменение данных профиля.
• Mindbox → TextBack — отправка рассылок через вебхуки.

Передача данных из TextBack в MindboxПередача данных из TextBack в Mindbox

Из TextBack можно вызывать:

• Выдачу действия клиенту в Mindbox;
• Редактирование поля в карточке клиента в Mindbox.

От задачи зависит набор создаваемых сущностей, но для передачи данных в любом случае нужно создать интеграцию.

Создание интеграцииСоздание интеграции

Добавьте интеграцию по пресету «Другое».
Задайте название интеграции, остальные настройки — по умолчанию:

Для выдачи действийДля выдачи действий

С помощью действий можно фиксировать статус отправленного сообщения. Для настройки нужно создать:

1. Шаблон действия;
2. Дополнительные поля для данных по действию (сообщению);
3. Операцию, в которой это действие выдается.

Создание шаблона действияСоздание шаблона действия

Добавьте шаблон действия для выдачи статуса рассылки:

Создание дополнительных полейСоздание дополнительных полей

Добавьте дополнительные поля для передачи в действии названия рассылки и ее статуса.

• Для сущности — Действие клиента
• Тип поля — Перечисление
• Создавать значение перечисления, если не найдено — включить

Создание операцииСоздание операции

Добавьте операцию для выдачи действия (операцию нужно создать в той же папке, в которой был создан выдаваемый шаблон действия):

Для заполнения данных клиентаДля заполнения данных клиента

Для заполнения поля клиента, нужно:

1. Настроить дополнительное поле для клиента или определить, какое основное поле будет отвечать за данные о событии в TextBack;
2. Настроить операцию для редактирования поля.

Создание дополнительных полейСоздание дополнительных полей

Добавьте нужные дополнительные поля, например, для отметки о наличии контакта в WhatsApp

Создание операцииСоздание операции

Добавьте операцию для заполнения созданного поля:

Передача данных из Mindbox в TextBack (отправка рассылок)Передача данных из Mindbox в TextBack (отправка рассылок)

Отправка осуществляется через вебхук. Для настройки нужно:

1. Создать интеграцию для вебхуков;
2. Создать вебхук с рассылкой;
3. Настроить вызов вебхука через сценарий.

Создание интеграцииСоздание интеграции

Добавьте интеграцию по пресету «Интеграция для вебхуков»:

• Общие настройки:

  • URL — https://api.textback.io
  • Ограничение скорости отправки запросов в секунду — 8

• Заголовки:

  • Content-Type — application/json — Публичный
  • Authorization — Bearer {сгенерированный токен из раздела «Интеграции» ЛК TextBack} — Секретный
  • User-Agent — Mindbox — Публичный

  

Создание вебхукаСоздание вебхука

Добавьте вебхук в созданной интеграции:

• Метод — POST

• Корневой URL — https://api.textback.io

• URL — можно дополнить:

  • /api/messages — метод для отправки сообщения в textBack
  • transactionalId=${WebhookRequest.TransactionalId} — ключ идемпотентности для повторных попыток подключения при получении ошибки (можно добавить по кнопке из интерфейса создания вебхука)

  

• Добавленные заголовки:

  • ClientPhone — ${Recipient.MobilePhone}
  • ClientId — ${Recipient.Id}

  

• Заполнение тела запроса проходит по документации.

  • Для remoteAddress используется параметр Mindbox — ${Recipient.MobilePhone}
  • Дополнительно в переменные можно добавить другие параметры из шаблонизатора.

  

Сохраните вебхук и добавьте новую пару ключ-значение: webhookId и идентификатор созданного вебхука из адресной строки:

Этот заголовок нужен для того, чтобы упростить процесс диагностики со стороны TextBack.

Создание сценарияСоздание сценария

Рассылки через вебхуки отправляются с помощью сценариев.

Настройте логику механики в сценарии; для отправки рассылки в блоке «Группа шагов» укажите вызов созданного вебхука. Так как отправка вебхуков не фиксируется на проектах, можно дополнительно создать для него шаблон-пометку, который будет выдаваться вместе с вызовом вебхука:

Рекомендуем сначала протестировать отправку на тестовом пользователе. Для этого задайте любой его идентификатор через блок Условие.