Для этого необходимо сделать следующее:

  1. Перейдите в раздел Помощь API.
  2. На странице API скопируйте ваш авторизационный токен.



       3. Перейдите на страницу Twin Messaging API по следующему адресу: https://tcl.twin24.ai/doc/notify/index.html.

       4. Нажмите кнопку Authorize.



       5. В открывшемся окне укажите авторизационный токен, который вы получили на шаге 2 и нажмите кнопку Authorize.


      6. В разделе Messages раскройте форму Create message batch и нажмите кнопку Try it out.


       7. В разделе Edit Value нажмите кнопку Edit и введите следующий фрагмент кода:

{
    "messages": [
        {
            "destinations": [
                {
                    "phone": "79111715040"
                }
            ],
            "channels": {
                "vkontakte": {
                    "text": "Здравствуйте, #username#! Мы отправили вам на почту #email# приглашение на открытие магазина! Будем Вас ждать!",
                    "provider": "MAILRU",
                    "templateData": {
                        "username": "Иван Иванов",
                        "email": "Ivanov@mail.ru"
                    },
                    "templateName": "template_rec_001",
                    "validityPeriod": 10
                }
            }
        }
    ]
}

В указанном выше фрагменте кода используются следующие параметры:

Наименование параметраОписание
phone Номер телефона, который был использован для регистрации страницы пользователя в социальной сети «Вконтакте» и/или «Одноклассники».
channels

Имя канала (социальной сети), в который будет отправлено сообщение. Возможные значения:

    • vkontakte – «Вконтакте»
    • odnoklassniki – «Одноклассники»
text

Текст сообщения, шаблон которого вы отправляли на согласование.

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

provider

Всегда используется значение MAILRU.

templateData

Переменные, которые используется в шаблоне с текстом сообщения. Вы можете использовать только те переменные, имена которых указаны в согласованном шаблоне. Изменять можно только значения переменных. Переменные задаются в фигурных скобках в виде строки в следующем формате:{"имя переменной 1":"значение переменной 1","имя переменной 2":"значение переменной 2"}. В качестве разделителя используется запятая. Пробелы между переменными не допускаются.

templateName

Имя согласованного шаблона, который вы используете для отправки.

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


cURL отправки клиентской рассылки
curl -X POST "https://tcl.twin24.ai/api/v1/messages" -H  "accept: application/json" -H  "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzUxMiJ9.eyJpYXQiOjE2NzY0NTQ1OTQsImV4cCI6MTY3NzA1OTM5NCwidmVyc2lvbiI6NCwic3ViIjoiMzE1OSIsImNvbXBhbnlfaWQiOjE4MzB9.MyVC_SR9L8rk0XMoflFcM7lNV5SChVDceH7bT0xr6BcT2y_Ay5zMdF5gzqSddehGasiBlWrLAq74Eox0S5zpznQZ0CD2rwZPrYjPfuPdgVXX5uu97m3yok5KP_F9LD4oZryUZiCuLk3gQXOFNntajo8W9CAWlwpRUkoKXgCnpXtcz_N458d2X1bW_a7ioYf-kZrLZ40KWbAfLW8In439gaEwSzwNaaFwtCYLj2pXoymLjRpKAekYEnD_ARFjcQaBKO6PD-J8g0UCj1F9z42UzdcII15bIwhUyY1hz7IBFimx5Grqiu_zH94F8aRuSn9YwtiAUpam-KfwVnK_VosSYEEz2rEVNt5a-IW1T7QG9kzimwG51ieaOQV-xGVeNAsrKhjhysPpmmHTtZhVRS9XZx6Z3O7JxakPSp8lMym555sBEjwVN1lvXXB7NiZDMlXuOgXfBdkvxeYNU1d9mIH-vEoeLBkPcUDx-uuFrwSHw4xuv00D00V_4kJGQ6scGDUBkVSkU0GgtpqNI_f54A69ML7Ksda31ZTQgF6iKwEgwktO5eF3QbKZMOt9zQEyCby_QkA6R9HtDj-imcjo-3L01rSDOomHkHk3hTEF7DjhdDPIczUFCJ99x-TPc6-0rMKRK0uyAx-MgyyRRrKfvODwsqsBoYtQ0hjrnS0j5auBScg" -H  "Content-Type: application/json" -d "{\"companyId\":13,\"taskId\":\"bce7d22e-dde6-4427-b391-ebbdfda44de6\",\"bulkId\":\"bce7d22e-dde6-4427-b391-ebbdfda44de6\",\"messages\":[{\"groupId\":\"string\",\"callbackUrl\":\"string\",\"callbackData\":\"string\",\"useShortLinks\":false,\"sendAt\":\"2018-10-31T11:56:07+00:00\",\"allowedTimeRanges\":[[\"09:30:00\",\"12:00:00\"],[\"16:00:00\",\"20:45:00\"]],\"templateId\":\"bce7d22e-dde6-4427-b391-ebbdfda44de6\",\"destinations\":[{\"flowId\":\"string\",\"phone\":41793026731,\"email\":\"pupkin@contora.com\",\"messengerUserId\":\"string\",\"externalId\":\"string\",\"clientId\":\"bce7d22e-dde6-4427-b391-ebbdfda44de6\",\"pushRegistrationId\":\"string\",\"platform\":\"ANDROID\",\"chatSessionId\":\"bce7d22e-dde6-4427-b391-ebbdfda44de6\",\"variables\":{\"var1\":\"value1\",\"var2\":\"value2\",\"var3\":\"value3\"}}],\"channels\":{\"email\":{\"text\":\"string\",\"subject\":\"string\",\"fromEmail\":\"pupkin@contora.com\",\"fromName\":\"Vasya Pupkin\",\"provider\":\"APN\",\"validityPeriod\":10,\"required\":true},\"sms\":{\"text\":\"string\",\"from\":\"CompanyName\",\"provider\":\"APN\",\"validityPeriod\":10,\"required\":true},\"push\":{\"text\":\"string\",\"from\":\"string\",\"provider\":\"APN\",\"validityPeriod\":10,\"required\":false},\"viber\":{\"text\":\"string\",\"from\":\"string\",\"imageUrl\":\"string\",\"buttonUrl\":\"string\",\"buttonText\":\"string\",\"provider\":\"APN\",\"validityPeriod\":10,\"required\":false},\"whatsapp\":{\"from\":\"string\",\"templateName\":\"string\",\"templateNamespace\":\"string\",\"templateData\":[\"string\"],\"language\":\"string\",\"mediaUrl\":\"string\",\"text\":\"string\",\"provider\":\"APN\",\"required\":false},\"vkontakte\":{\"from\":\"string\",\"templateName\":\"string\",\"templateData\":[\"string\"],\"text\":\"string\",\"provider\":\"APN\",\"attachments\":[\"video-85635407_165186811\",\"wall-92255884_16\"]},\"odnoklassniki\":{\"templateName\":\"string\",\"templateData\":[\"string\"],\"text\":\"string\",\"provider\":\"APN\"},\"chat\":{\"chatId\":\"bce7d22e-dde6-4427-b391-ebbdfda44de6\",\"botId\":\"bce7d22e-dde6-4427-b391-ebbdfda44de6\",\"messengerType\":\"WHATSAPP\",\"chatSessionName\":\"string\",\"text\":\"string\",\"provider\":\"APN\",\"continueLastOrStartNewSession\":true}}}]}"

      8. Нажмите кнопку Execute.

.

  • Нет меток