# Mindbox

## Описание интеграции

[Mindbox](https://mindbox.ru/) — облачная платформа автоматизации маркетинга. Помогает собирать и обрабатывать данные о клиентах из онлайна и офлайна, автоматизировать коммуникации, управлять ими из одного окна и увеличивать выручку маркетинга.

## Инструкция по подключению

Отправка сообщений из Mindbox в Direct возможна при помощи функционала вебхуков, реализованного на платформе Mindbox. Данный функционал позволяет использовать [API Direct](https://api.docs.direct.i-dgtl.ru/) для отправки оповещений, авторизационных кодов, маркетинговых предложений.

В гайдах Mindbox есть инструкции как создавать вебхуки и как использовать ответы на них: 

* [Что такое вебхук и как его создать](https://help.mindbox.ru/docs/webhooks). 
* [Как использовать ответы вебхуков](https://help.mindbox.ru/docs/workflows-webhook-responses).

Для настройки вебхуков в Mindbox вам понадобятся следующие параметры:

* [URL](https://api.docs.direct.i-dgtl.ru/messages/sms-sending), на который нужно отправить запрос.
* Headers, в которых передается [токен](https://api.docs.direct.i-dgtl.ru/authorization) авторизации.
* Тело запроса, для которого в интерфейсе Mindbox нет строгих ограничений.\
  Подробное описание тела запроса можно найти в документации [API Direct](https://api.docs.direct.i-dgtl.ru/messages/sms-sending). \
  Mindbox позволяет задать в теле запроса переменные параметры, в которые можно подставлять разные номера получателей, имена отправителей, разный текст и канал отправки.

Если вам требуется помощь в настройке интеграции, вы можете обратиться к менеджеру из Mindbox и менеджеру из I-Digital.

**Чем может помочь менеджер из I-Digital**:

* Зарегистрироваться в личном кабинете [Direct](https://direct.i-dgtl.ru/login).
* Добавить имена отправителей, с которых будет осуществляться отправка сообщений. 
* Создать токен для отправки сообщений через [API Direct](https://api.docs.direct.i-dgtl.ru/authorization).
* Разобраться с описанием объектов сообщений [API Direct](https://api.docs.direct.i-dgtl.ru/).

**Чем может помочь менеджер из Mindbox**:

* Создать вебхук в Mindbox с учетом вашей маркетинговой стратегии, настроить обработку ответов на вебхук с учетом документации [API Direct](https://api.docs.direct.i-dgtl.ru/).
* Добавить переменные параметры в объект, который будет передаваться в Direct.
* Протестировать отправку сообщений из Mindbox в Direct. 

### SMPP-соединение в Mindbox <a href="#shag-2-dobavte-smpp-soedinenie-v-mindbox" id="shag-2-dobavte-smpp-soedinenie-v-mindbox"></a>

У Mindbox есть возможность отправлять сообщения по каналу SMPP. I-Digital есть в списке доступных партнёров. Чтобы добавить SMPP-подключение с I-Digital в Mindbox:&#x20;

1\. Напишите вашему менеджеру или в поддержку по адресу [support@i-dgtl.ru](mailto:support@i-dgtl.ru) с запросом на подключение SMPP-соединения в Mindbox. Приложите к письму [заполненную форму](https://docs.google.com/spreadsheets/d/1Bjfd6fD56mvTs1DJ1sAsrYrayIbbufkE3rbh3WVFQ5c/export?format=xlsx).&#x20;

Мы предоставим следующие данные:

* host
* port
* логин (или systemId)
* пароль
* имя отправителя

\
2\. Следуйте инструкции на [сайте Mindbox](https://help.mindbox.ru/docs/%D0%BA%D0%B0%D0%BA-%D0%BF%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B8%D1%82%D1%8C-sms-%D1%80%D0%B0%D1%81%D1%81%D1%8B%D0%BB%D0%BA%D0%B8) для создания подключения.&#x20;

Подробнее о канале SMPP вы можете узнать из [нашей документации](https://smsc.i-dgtl.ru/parametry-smpp).\
<br>