Fasttrack
[ Вход ]
  • База знаний
  • ЧАТ-ЦЕНТР
    • Интерфейс чат-центра
    • Работа в чат-центре
      • Счетчики в группах
      • Список чатов в группе
      • Что такое сессии
      • Чат-сессии
        • Забрать чат-сессию
        • Передать чат
        • Завершить чат-сессию
        • Контекст чат-сессии
      • Общение в чате
        • Отправка сообщений
        • Запуск сценариев
        • Быстрые ответы
        • WhatsApp-шаблоны
        • Контекст сообщения
        • Написать первым в WA
      • "Доступен для чата"
      • Служебные сообщения
      • Звуковые уведомления
      • Мультипроектный режим
    • Настройки чат-центра
      • Команды
      • Операторы
      • Темы чат-сессий
      • Быстрые ответы
      • Мультипроектный режим
  • КАСКАДНЫЕ РАССЫЛКИ
    • Что такое каскады
    • Как подключить каскады
    • Запуск через API
    • Ограничения запросов
    • Срок транзакции
    • Задержки маршрутов
    • Тег транзакции
    • Контекст транзакции
    • Ассинхронные события
    • События в Mindbox
    • Синхронный режим
    • Транзакции в Fasttrack
    • Рассылка через VK Notify
  • КАНАЛЫ
    • Telegram
    • WhatsApp
    • Viber
    • VK
    • Instagram
    • Одноклассники
    • Виджет для сайта
    • Avito
    • Свой канал (API)
  • ИНТЕГРАЦИИ
    • AmoCRM
    • Собственная CRM & CDP
    • RetailCRM
      • RetailCRM: Настройка
      • RetailCRM: Процедуры
    • AmoCRM
      • AmoCRM: Настройка
      • AmoCRM: Процедуры
    • Битрикс24
      • Битрикс24: Настройка
      • Битрикс24: Процедуры
      • Битрикс24: Операторам
    • GetCource
      • GetCource: Настройка
      • GetCource: Процедуры
    • Roistat
      • Roistat: Настройка
      • Roistat: Процедуры
    • Usedesk
      • Usedesk: Настройка
      • Usedesk: Процедуры
    • S2
      • S2: Настройка
      • S2: Процедуры
    • Hubspot
      • Hubspot: Настройка
      • Hubspot: Процедуры
    • Omnidesk
  • ПЕРСОНАЛЬНЫЕ РАССЫЛКИ
    • PUSH-рассылки через API
  • РАССЫЛКИ
    • Рассылки по аудитории
      • Интерфейс платформы
      • API & Webhooks
    • Рассылки в WhatsApp
      • Интерфейс платформы
      • API & Webhooks
    • Персональные рассылки
    • Каскадные рассылки
  • API
    • Формат запросов
  • Инструкции
    • Сценарий с опросом
    • Как отслеживать переход по ссылке из сценария чат-бота
    • Виджет Fasttrack для Salesbot в AmoCRM
  • Полезные процедуры для настройки сценариев
  • Интеграция приложения в Telegram с чат-ботом
Powered by GitBook
On this page
  • Настройка интеграции
  • Регистрация шаблонов
  • Отправка уведомлений по телефону
  • Получение статусов в Mindbox
  1. КАСКАДНЫЕ РАССЫЛКИ

Рассылка через VK Notify

PreviousТранзакции в FasttrackNextTelegram

Last updated 8 months ago

VK Notify – это сервис от ВКонтакте для отправки по номеру телефона сервисных и транзакционных уведомлений.

  • Сервисные уведомления – приходят от официальной группы компании (даже если пользователь не подписан на нее). Здесь пользователь может взаимодействовать с компанией и общаться с чат-ботом.

  • Бизнес-уведомления – приходят в специальный бизнес-раздел ВКонтакте. Пользователь не может ответить, но точно знает, что это официальное сообщение от компании.

Настройка интеграции

Для интеграции Fasttrack c VK Notify необходимо предоставить:

  • application – идентификатор приложения;

  • signature_key – токен для подписи запросов;

  • service – канал отправки, содержащий список шаблонов;

Данные предоставляются вашему менежеру на стороне Fasttrack.

Все 3 параметра хранятся в вашем аккаунте VK Notify, который доступен по ссылке -

Чтобы узнать 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": "<Дата и время выполнения (можно использовать для выполнения запроса задним числом)>"
}
https://notify.mail.ru/self/