Как настроить нотификации в Botmechanic на основе данных вашей CRM
Отправьте инструкцию вашему разработчику/программисту, если не понимаете, о чем здесь речь.

Прежде всего нужно:
  1. Создать в вашей базе хранения профилей (заказов, клиентских данных) числовое поле botmechanic_id.
  2. Определиться, по какому другому идентификатору мы будем относить ваших клиентов к их профилю в мессенджерах (чаще это email или телефон).
  3. Сообщить сотруднику Botmechanic, каким образом заполнять это поле. Чаще всего это POST запрос, где в теле содержится:
    1. телефон или email
    2. botmechanic_id
Глобально обмен данными будет выглядеть примерно так:
  1. Мы один раз присылаем botmechanic_id в привязке к номеру телефона/email'у
  2. Вы сколько угодно раз отправляете нам данные с botmechanic_id и любыми другими полями

В случае с нотификациями:
1. Сначала вы отправляете вебхук с обновлением полей подписчиков
2. Затем отправляете вебхук, который триггерит отправку сообщения в Botmechanic


Создаем поля подписчика Botmechanic на примере
Переходите в "Доп.поля" – будем на примере создавать дополнительные поля.
1. Определяемся с полями.
Представим, что нам нужно триггерная нотификация после совершения заказа.

Тогда нам нужны:
  1. Номер заказа
  2. Адрес доставки
  3. Сумма заказа

У каждого поля подписчика есть 3 параметра:
  1. Название – задаем человеку понятное
  2. Slug – машинное имя для передачи переменной во внешние системы
  3. Тип:
    1. число
    2. строка
    3. Email
    4. Телефон
    5. Булевая переменная

2. Создаем дополнительные поля.

Рассмотрим создание дополнительного поля на примере Суммы заказа, остальные – по аналогии.

У каждого поля подписчика есть 3 параметра:
  1. Название – задаем человеку понятное
  2. Slug – машинное имя для передачи переменной во внешние системы
  3. Тип:
    1. число
    2. строка
    3. Email
    4. Телефон
    5. Булевая переменная
Переходим на https://app.botmechanic.io/subscriber_fields/ и создаем Сумму заказа.
В итоге должно получиться так.
Обновляем поле подписчика Botmechanic вебхухом
1а. Получаем токен авторизации

Чтобы кто попало не мог редактировать профили ваших подписчиков вебхуком, мы требуем токен авторизации при каждом запросе обновления полей.

Получать токен авторизации пока что нужно тоже вебхуком.

Если вы не понимаете о чем речь, можете смело переходить к пункту "Получение токена авторизации с помощью Postman".

Это будет POST запрос с URL:

https://api.botmechanic.io/api/v1/auth/

Заголовки:
Conten-Type: application/json
Accept: application/json

Тело запроса:

{"username": "имейл, на который зарегистрирован аккаунт",
"password": "пароль, который лежит на почте"
}

В ответ на такой запрос придет токен авторизации от нашего сервера.
1б. Получаем токена авторизации с помощью Postman

Для этого вам потребуется сервис отправки вебхуков Postman, установите его.

1. В Postman нажимаем New и выбираем Request как на скриншоте ниже.
2. Копируем все, что ниже, чтобы получилось как на скриншоте:

1. В выпадающем списке выбираем POST
2. Копируем ссылку https://api.botmechanic.io/api/v1/auth/
3. На вкладке Headers создаем два поля: Content-Type и Accept, в значения подставляем application/json
У вас должно быть ровно так же
3. Перемещаемся во вкладку Body и:

1. выбираем raw
2. вставляем:

{"username": "имейл, на который зарегистрирован аккаунт",
"password": "пароль, который лежит на почте"
}

Должно получиться так же, только с вашим email'ом и паролем.
4. Отправляем вебху и получаем токен:

1. Нажимаем на кнопку Send
2. Ваш токен авторизации Botmechanic

Должно получиться так же, только с вашим email'ом и паролем.
2. Обновляем поля подписчика вебхуком

Скорее всего, вы будете обновлять поля подписчиков Botmechanic из информации о клиент в вашей CRM/CMS. Поэтому потребуется разработчик/программист, который отвечает за сайт/crm. Покажите ему эту инструкцию.

Теперь на пригодятся поля, которые мы создали в самом начале.

В нашем примере это будет POST запрос с URL:
https://api.botmechanic.io/api/v1/subscribers/{botmechanic_id}/update_fields/

где botmechanic_id – наш идентификатор, которые уже хранится в вашей базе

Заголовки:
Conten-Type: application/json
Accept: application/json
Authorization: Token {ваш_токен авторизации} <= между Token и самим токеном пробел


Тело запроса:

{"order_id": "номер заказа из вашей CRM",
"delivery_address": "адрес доставки из вашей CRM",
"value": "адрес доставки из вашей CRM"
}



Отправлям триггерное сообщение с помощью вебхука
1. Создаем триггерное сообщение в Botmechanic

1. Заходим на https://app.botmechanic.io/triggermailings/
2. Выбираем "по API"

Готовим место под бот
3. Далее определяемся, рассылаем мы отдельное сообщение или один из созданных ранее сценариев. В нашем примере нам нужна рассылка отдельного сообщения.


4. Нужно придумать текст сообщения. Пусть будет так:

Ваш заказ № {{profile.data.order_id}} на сумму {{profile.data.value}} будет доставлен по адресу {{profile.data.delivery_address}}.
Детали доставки сообщим немного позже.

*чтобы вставить данные из дополнительного поля подписчика в текст, всегда делайте это по формуле {{profile.data.slug_имя_вашей_переменной}}. Если забыли, что такое slug, то вот ссылка.

5. Нажимаем "Отправить", см. скриншот ниже.
Должно получиться так
6. На стороне вашей CRM/CMS нужно настроить POST запрос при каждом совершении заказа на сгенерированный URL из скриншота выше.

Вместо ":subscriber_id" нужно подтсавить botmechanic_id из вашей CRM.

*триггерным событием может быть не только заказ, а что вам захочется.

ГОТОВО!
Вам была полезна эта статья?