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

Старая версия 4

changes.mady.by.user Кадубовский Андрей (Twin)

Сохранено

по сравнению с

Новая версия 5

changes.mady.by.user Кадубовский Андрей (Twin)

Сохранено

Ключ

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

...

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

Общая информация

Используя сервисы платформы Twin, вы можете рассылать сообщения вашим клиентам в социальных сетях «Вконтакте» и  «Одноклассники».

Предварительно необходимо отправить заявку в ООО «ВК» для получения разрешения на отправку клиентских рассылок. 

Как отправить заявку для получения разрешения на отправку клиентских рассылок

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

...

Подсказка

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


Как

...

Клиентскую рассылку можно выполнить одним из следующих способов:

  • Из личного кабинета администратора;
  • С помощью Twin API.

Ниже рассматриваются оба указанных варианта.

Как выполнить клиентскую рассылку из личного кабинета администратора

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

...

       2. Нажмите кнопку Добавление нового задания на отправку в верхней части страницы.

       3. В открывшемся окне укажите имя задания.

Информация

В качестве имен заданий рекомендуется использовать короткие и понятные слова и фразы. Имя, которое вы введете, в дальнейшем поможет вам найти это задание среди остальных заданий в списке. Например, можно порекомендовать использовать следующее имя: «Рассылка для новых клиентов».

      4. Нажмите кнопку Обзор и выберите файл для отправки сообщений. Если у вас еще нет заполненного файла, вы можете загрузить его шаблон по этой ссылке.

Image Removed

...

titleИнструкции по заполнению файла для отправки сообщений

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

...

Информация

Если в клиентской рассылке используются переменные, то имена переменных в тексте сообщения нужно указывать с помощью символов #. Например: «Здравствуйте, #userName#!»

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

Ниже приводится пример заполнения файла для рассылки:

Image Removed

...

6. Чтобы завершить создание задания, нажмите кнопку Создать.

7. Для запуска клиентской рассылки нажмите кнопку Image Removed в строке созданного задания.

Image Removed

Информация

Подробная информация о работе с заданиями на отправку сообщений содержится в разделе Задания на отправку.

Как выполнить клиентскую рассылку с помощью Twin API

...

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

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

...

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

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

...

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

Image Removed

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

Image Removed

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

Блок кода
languagepy
themeDJango
linenumberstrue
{
    "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.
  • templateName – переменные, которые используется в шаблоне с текстом сообщения. Вы можете использовать только те переменные, имена которых указаны в согласованном шаблоне. Изменять можно только значения переменных. Переменные задаются в фигурных скобках в виде строки в следующем формате:{"имя переменной 1":"значение переменной 1","имя переменной 2":"значение переменной 2"} . В качестве разделителя используется запятая. Пробелы между переменными не допускаются.
  • templateName – имя согласованного шаблона, который вы используете для отправки.
  • validityPeriod – период, в течение которого ваше сообщение будет отправлено. Рекомендуется использовать значение, которое установлено по умолчанию.
Блок кода
languagepy
themeDJango
firstline1
linenumberstrue
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.

...

самостоятельно отправлять на модерацию заявки на отправку клиентских рассылок

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

  • Из личного кабинета администратора
  • С помощью Twin API

Отправка заявок из личного кабинета

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

...

На странице Шаблоны mail.ru будет создана новая запись. Ваша заявка будет автоматически отправлена на модерацию в ООО «ВК». Вы самостоятельно можете отслеживать статус модерации вашей заявки. После согласования заявки в поле Подтвержденный будет отображаться значение Да.

Отправка заявок с помощью Twin API

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

...

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

Если у клиента в настройках страницы «Вконтакте» установлен запрет на получение сообщений от проверенных сообществ, то клиентские рассылки не будут доставлены.

Работа с шаблонами заявок на отправку клиентских сообщений с помощью Twin API

С помощью Twin API вы можете выполнять следующие действия с шаблонами заявок:

  • Получить список всех шаблонов заявок со страницы личного кабинета Шаблоны mail.ru
  • Изменять шаблоны заявок
  • Удалять шаблоны заявок

Получение списка всех шаблонов заявок

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

...

Для загрузки списка шаблонов нажмите кнопку Download, которая расположена в правом нижнем углу секции. Данные будут сохранены в виде файла в формате JSON.


Изменение шаблонов заявок

Чтобы изменить шаблон заявки,выполните следующее:

...

Произведенные изменения в шаблоне заявки будут сохранены.

Удаление шаблонов заявок

Чтобы удалить шаблон заявки,выполните следующее:

...