Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
Предупреждение
titleОбратите внимание

Рассылка сообщений в вайбер через номер телефона невозможна, вместо номера телефона используется айди клиента, полученный в вайбере при помощи переменной {messengerUserId} внутри сценария.

Подготовка к рассылке

Для того, чтобы рассылать сообщения в вайбер, нужно создать бота в вайбере, о том, как его создать, можно почитать в этой статье.Затем нужно привязать бота к чату, что описано в этой статье создайте сценарий бота и интегрируйте его с вайбером.

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

Шаг 1: подготовка рассылки в Twin API

переходить к подготовке рассылки.

Рассылка через Twin API

Пример итогового запроса:

Блок кода
languagephp
themeDJango
titleCURL
collapsetrue
curl --request POST 
     --url https://notify.twin24.ai/api/v1/messages \
     --header 'accept: application/json' \
     --header 'authorization: Bearer ваш токен' \
     --header 'content-type: application/json' \
     --data '
{
  "messages": [
    {
      "useShortLinks": false,
      "channels": {
        "chat": {
          "provider": "TWIN",
          "messengerType": "VIBER",
          "chatId": "айди чата, привязанного к боту в вайбер",
          "botId": "айди бота, сценарий которого будет использован в этой сессии"
        }
      },
      "sendAt": "2023-01-24T10:25:07+00:00",
      "destinations": [
        {
          "messengerUserId": "айди клиента в вайбере"
        }
      ]
    }
  ]
}
'

...

  1. Зайдите в Twin API и найдите метод Create message batch.
    Image Modified

...


  1. В поле Bearer введите свой токен авторизации из личного кабинета.
    Image Modified

...

  1. Раскрыть
    title

...

  1. Как получить токен авторизации

    Чтобы получить авторизационный токен, откройте вкладку

...

  1. Помощь

...

...

  1. API

...

  1. и скопируйте оттуда ваш токен.

    Image Added

  2.    Для добавления необходимых для отправления сообщения параметро, в пункте messages нажмите ADD OBJECT.
    Image Added
  3. Для определения даты и времени, когда будет отправлено сообщение, нужно ввести дату и время в поле sendAt.
    Подсказка
    titleФормат даты и времени

    2023-01-24T10:25:07+00:00

    Для отправки сообщения без задержки, можно оставить поле пустым.

    Image Added
    Также можно отправлять сообщения в определённый промежуток времени, для этого нужно в поле allowedTimeRanges нажать кнопку ADD ARRAY OF STRINGS, затем добавить 2 даты в подходящем формате.

  4. Для определения адресата сообщения, в пункте destinations нажмите ADD OBJECT.
    Image Added
  5. В поле messengerUserId записывается айди пользователя в вайбере, который получается в сценарии через переменную {messengerUserId} во время общения с пользователем в чате вайбер.
    Image Added
  6. В поле channels нужно нажать кнопку CHANNELS OBJECT.
    Image Added

    В открывшемся списке в поле chat нужно нажать на кнопку CHAT OBJECT.
    Image Added
  7. Внутри объекта chat, нужно заполнить следующие поля:
    Image Added
  • chatId - Айди чата из личного кабинета. К чату должен быть привязан бот, созданный в вайбере, ссылка на инструкцию по его созданию приведена в начале статьи.
  • botId - Айди сценария бота из личного кабинета, с которым будет начата сессия, сценарий должен быть из того же личного кабинета, через токен которого вы авторизовались.
  • messengerType - VIBER
  • provider - TWIN


Если после нажатия кнопки Try It! вы увидели код 201, значит всё прошло успешно и у клиента должна начаться чат сессия в вайбер с выбранным сценарием.

Примечание

Если после нажатия кнопки Try It! вместо кода 201 появляется код 400, либо 500, значит произошла ошибка и стоит перепроверить введённые значения.Image Removed