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

Ключ

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

Якорь
Top
Top


Message Box
iconnone
titleНа этой странице:
typegeneric
Оглавление


CSS Stylesheet


Функции сервиса уведомлений

Основные функции сервиса уведомлений:

  1. Отправка текстовых уведомлений пользователям.

  2. Отложенная отправка (сообщение отправится в установленное время). При необходимости можно отменить отправку сообщения до наступления установленного времени. Благодаря этому можно контролировать, что сообщение не придет пользователю в неположенное время (например, ночью).

  3. Сокращение ссылок. Длинные ссылки сокращаются для уменьшения стоимости отправки сообщения. Это касается только канала SMS (подробнее см. в разделе "Отправка уведомлений через API").

  4. Использование шаблонов. Чтобы не передавать каждый раз весь массив данных уведомления через API, можно создать шаблон, описывающий всю структуру сообщения, и менять только номер телефона или электронный адрес получателя и переменные.

  5. Отправка уведомлений по различным каналам: SMS, e-mail, push, WhatsApp, Viber, Telegram, Vkontakte, Odnoklassniki, chat. По умолчанию сообщения отправляются последовательно: если сообщение было доставлено по одному из каналов, то по остальным каналам оно не отправляется.

Подсказка

Исключением являются случаи, когда необходимо отправить сообщение по нескольким каналам независимо от того, дошло оно по первому каналу или нет. Для этого существует параметр required (подробнее см. в разделе «Отправка уведомлений через API»).

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

Для отправки SMS-сообщений выполните следующее:

Откройте вкладку УведомленияЗадания на отправку и нажмите кнопку Добавление нового задания на отправку сообщений.
Image Removed
Введите наименование задания в соответствующее поле и скачайте шаблон нужного типа уведомления. Для скачивания шаблона нажмите на выделенный текст.
Image Removed
Откройте загруженный шаблон и заполните его согласно таблице описания полей.
Нажмите кнопку Выберите файл, чтобы загрузить заполненный шаблон. Установите Ограничитель по времени отправки текстовых сообщений и нажмите кнопку Создать.
Image Removed

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

Информация
titleИнструкция по получению идентификатора сессии с клиентом

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

Откройте вкладку ЧатыНастройки и нажмите кнопку Просмотреть диалоги напротив нужного чата.
Image Removed
Нажмите кнопку Image Removed в строке нужного чата, чтобы скопировать ID чат-сессии.
Image Removed

Запуск отправки сообщений

Чтобы запустить отправку сообщений по подготовленному заданию на отправку, откройте вкладку УведомленияЗадания на отправку и нажмите кнопку Image Removed в строке нужного задания.

Image Removed


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

Информация
Раскрыть
titlecURL
Блок кода
languagepy
themeDJango
firstline1
titlecURL отправки SMS уведомлений
linenumberstrue
curl --request POST \
     --url https://notify.twin24.ai/api/v1/messages \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOURTOKEN' \
     --header 'content-type: application/json' \
     --data '
{
     "messages": [
          {
               "useShortLinks": false,
               "destinations": [
                    {
                         "phone": "NUMBERPHONE"
                    }
               ],
               "channels": {
                    "sms": {
                         "from": "TwinService",
                         "text": "YOURTEXT"
                    }
               }
          }
     ]
}
'

Чтобы отправить уведомление через API, выполните следующие действия:

Откройте TWIN API. Там найдите метод Create message batch.
 Image Removed
В поле Bearer введите ваш авторизационный токен.
Image Removed
Информация
titleИнструкция по получению авторизационного токена
Чтобы получить авторизационный токен, откройте вкладку Помощь API и скопируйте оттуда ваш токен.
Image Removed
Нажмите ADD OBJECT в пункте messages.
Image Removed
Если вы хотите использовать шаблон уведомления, то введите идентификатор шаблона в поле templateId.
Image Removed
Информация
titleИнструкция по получению идентификатора шаблона
Чтобы получить идентификатор шаблона, откройте УведомленияШаблоны и скопируйте идентификатор нужного шаблона.
Image RemovedНажмите ADD OBJECT в пункте destinations.
Image Removed
Введите номер телефона, на который хотите отправить уведомление в поле phone.
Image Removed
Нажмите CHANNELS OBJECT в пункте channels.
Image Removed
Нажмите на SMS OBJECT.
Image Removed
Если вы не использовали шаблон, то заполните поле text.
Примечание

Если вы использовали шаблон, то поле text будет проигнорировано.

Image Removed
Заполните поле from. Туда нужно ввести имя отправителя, от лица которого будут рассылаться уведомления. 
Примечание

Если у вас нет собственного имени отправителя, то используйте TwinService.

Image Removed
Нажмите кнопку Try It
Image Removed
После этого убедитесь, что все прошло успешно. Для этого проверьте поле RESPONSE, там должно быть значение 201. Также результат можно увидеть в поле YOUR REQUEST HISTORY.
Image Removed
Примечание

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

Подсказка

Как создать запрос в сервис технической поддержки описано в этой статье.

Старт чат-сессии в Telegram через API

Чтобы отправить сообщение в Telegram через API, нужно добавить Telegram-бота.

Добавление Telegram бота:

  1. Открыть Telegram клиент.

  2. Написать боту BotFather команду /start

  3. Следовать инструкциям по созданию нового бота.

  4. Взять API token в настройках созданного бота.

  5. Привяжите бота к чату.
    Подсказка

    Как привязать бота к чату описано в этой статье.


После привязки бота к чату нужно написать боту команду /start для начала чат-сессии.




Отправка уведомлений через разные каналы связи

Отправка через WhatsApp


Чтобы отправлять сообщения через канал WhatsApp, нужно получить бизнес-аккаунт в Facebook* и подключить чат к WhatsApp. Для этого выполните следующие действия:

  1. Убедитесь, что его бизнес соответствует Коммерческой политике WhatsApp.

  2. Убедитесь, что сообщения будут соответствовать политике WhatsApp Business.

  3. Заполните анкету.
    Примечание



    В этом поле сумма должна быть равна не менее 100 евро. В противном случае анкета не будет одобрена.



  4. Подтвердить бизнес-аккаунт Facebook*.

  5. Принять запрос для WhatsApp Business API
    Информация

    На получение запроса может уйти 2-3 дня с момента заполнения анкеты.

  6. После того, как ваша учетная запись WhatsApp будет одобрена и учетная запись настроена, мы сможем завершить процедуру OTP (One Time Password) для активации вашего номера с помощью WhatsApp API.
    OTP можно отправить с помощью голосового вызова или SMS: предварительно согласовав время, вам поступит звонок или SMS, в зависимости от того, как вам будет удобнее, с уведомлением одноразового кода. Сообщите этот код вашему партнеру или свяжитесь со службой технической поддержки. Время жизни кода всего 5 минут.
    Примечание

    Если номер телефона, указанный в анкете, ранее был привязан к WhatsApp, его необходимо отвязать (удалить аккаунт в приложении WhatsApp).

  7. Подождите один день. Будет завершена настройка аккаунта WahtsApp и подключение к чатам Twin.
    После этого вы сможете создать и настроить шаблон для отправки уведомлений в WhatsApp и посмотреть, как будет выглядеть чат в WhatsApp с созданным им шаблоном.

    Информация

    При создании шаблона заполните поле Header, в которое можно загрузить изображения, документы, видео и геолокацию. Вы также можете написать туда написать текст приветствия. Он будет выделен в сообщении жирным шрифтом.
    Поле Body заполните основным текстом сообщения. Также есть возможность добавить кнопки быстрых ответов в самом сообщении.

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


Примечание

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

 

Отправка через VKontakte

Для отправки уведомления VKontakte необходимо создать шаблон mail.ru.

Примечание

Чтобы создавать Шаблоны mail.ru, нужно подключить соответствующую услугу, обратитесь в сервис технической поддержки.

Подсказка

Процесс создания шаблонов mail.ru описан в этой статье.


Отправка уведомления VKontakte через API

Подсказка

Процесс отправки уведомлений во VKontakte через API описан в этой статье.



Предупреждение

* Деятельность организации Meta Platforms Inc. и ее продуктов Instagram и Facebook запрещена в Российской Федерации.



Button Hyperlink
custom-icontop-button
idtop-button
title.
typestandard
classtop-button
url#Top