Рассылка через 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 Notify через Fasttrack используйте только шаблоны с текстом и переменными (без кнопок и вложений).

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

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

Не заполняйте раздел Одноклассники. На текущий момент уведомления в одноклассники через VK Notify не поддерживается.

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

Отправка уведомлений по телефону

Для отправки уведомлений по номеру телефона в 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