Рассылка через VK Notify
VK Notify – это сервис от ВКонтакте для отправки по номеру телефона сервисных и транзакционных уведомлений.
Сервисные уведомления – приходят от официальной группы компании (даже если пользователь не подписан на нее). Здесь пользователь может взаимодействовать с компанией и общаться с чат-ботом.
Бизнес-уведомления – приходят в специальный бизнес-раздел ВКонтакте. Пользователь не может ответить, но точно знает, что это официальное сообщение от компании.
Настройка интеграции
Для интеграции Fasttrack c VK Notify необходимо предоставить:
application
– идентификатор приложения;signature_key
– токен для подписи запросов;service
– канал отправки, содержащий список шаблонов;
Данные предоставляются вашему менежеру на стороне Fasttrack.
Все 3 параметра хранятся в вашем аккаунте VK Notify, который доступен по ссылке - https://notify.mail.ru/self/
Чтобы узнать application
и signature_key
, перейдите в настройки созданного сервиса, на вкладку [ Доступы API ]:
Если у вас еще нет зарегистрированного приложения, то его необходимо создать. Используйте кнопку [ + Добавить приложение ].
Все шаблоны в VK Notify регистрируются в рамках определенного "Сервиса" или канала отправки. Нам потребуется наименование вашего сервиса, чтобы иметь возможность отправлять шаблоны, которые с ним связаны.
Перейдите в раздел [ Сервисы и шаблоны ]. Если сервиса еще нет, то его необходимо создать. Для этого в разделе есть кнопка [ + Новый сервис ].
Название сервиса также нужно передать вашему менеджеру в Fasttrack.
Регистрация шаблонов
Откройте раздел [ Сервисы и шаблоны ]. Перейдите в сервис, чтобы открыть список шаблонов, связанных с этим сервисом.
Нажмите на кнопку [ Шаблон по телефону ], чтобы открыть форму создания нового шаблона.
Введите название для нового шаблона и добавьте текст сообщения. Если необходимо, то вы можете использовать переменные в сообщении. Значение переменных может быть заполнено в момент отправки сообщения персонально для каждого получателя.
Если необходимо, чтобы у пользователя была возможность ответить на ваше сообщение, то не забудьте отметить галочку на против пункта [ принимать от пользователей ответные сообщения ].
После того, как вы сохраните новый шаблон, он сразу будет отправлен на модерацию. Когда модерация будет пройдена, шаблон можно будет использовать в рассылках.
Отправка уведомлений по телефону
Для отправки уведомлений по номеру телефона в VK через VK Notify необходимо воспользоваться API для каскадных рассылок в Fasttrack.
Пример запроса на создание каскадной рассылки через VK Notify:
curl -i -X POST \
https://cascades.fstrk.io/api/v1/transactions/async/ \
-H 'api-key: <КЛЮЧ ДОСТУПА>' \
-H 'Content-Type: application/json' \
-d '{
"phone_number": "<НОМЕР ТЕЛЕФОНА>",
"routing": [
"VK_NOTIFY"
],
"vk_notify_template_name": "<НАЗВАНИЕ ШАБЛОНА>",
"vk_notify_template_variables": {
"v1": "<ЗНАЧЕНИЕ ПЕРЕМЕННОЙ>"
},
"waiting_time_route": 60
"validity_period_seconds": 600,
"tag": "nedozvon",
"context": {
"cascade": "nedozvon",
"deal_id": "18547661"
}
}'
Получение статусов в Mindbox
Для получения статусов отправленных уведолений в Mindbox, необходимо на стороне Mindbox настроить специальную операцию, которая будет принимать уведомления об изменении статуса.
Когда, операцию будет настроена, предоставьте вашему менеджеру в Fasttrack следующую информацию:
Название операции
Точку интеграции
Секретный ключ
Пример операции в MindBox для получения статуса каскадного сообщения:
{
"customerAction": {
"customFields": {
"cascade": "nedozvon",
"deal_id": "18547661",
"fasttackCascadeDetails": "<FasttackCascadeDetails>",
"fasttackCascadeStatus": "<FasttackCascadeStatus>",
"fasttrackDetailedStatus": "<Статус WhatsApp-сообщений>"
}
},
"customer": {
"ids": {
"mindboxId": "<Id клиента в Mindbox>"
},
"mobilePhone": "<Мобильный телефон>"
},
"executionDateTimeUtc": "<Дата и время выполнения (можно использовать для выполнения запроса задним числом)>"
}
Last updated