На этой странице:

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

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

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

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

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

  1. Перейдите в службу технической поддержки по следующему адресу: https://support.twin24.ai.
  2. Выберите раздел Чаты и рассылки Иное.


 

       3. На открывшейся странице заполните форму заявки.


  • В поле Номер ЛК укажите ID вашего кабинета.

    Идентификатор кабинета отображается в правом верхнем углу страницы.


  • В поле Краткий смысл и задача вашего обращения введите MAILRU.
  • В поле Описание введите следующую информацию:
    • Укажите ссылку на официальное сообщество в социальной сети «Вконтакте» и/или вашу группу в в социальной сети «Одноклассники», от имени которых вы будете выполнять рассылки (имя указанного сообщества/группы будет отображаться в качестве имени отправителя сообщений).

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

    • Введите шаблон текста сообщения, которое вы будете рассылать клиентам.

      Если вы собираетесь отправлять одинаковые сообщения в указанные социальные сети, то нужно указать только один шаблон текста сообщения. Если сообщения, которые вы будете отправлять в указанные социальные сети, будут отличаться, то потребуется указать шаблон текста сообщения для каждой сети отдельно.

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

После этого сотрудник компании Twin отправит заявку на модерацию в ООО «ВК», а также внесет соответствующую информацию в систему.

Вы можете отслеживать статус модерации из личного кабинета на странице Шаблоны mail.ru (Уведомления Шаблоны mail.ru).


После согласования заявки в поле Подтвержденный будет отображаться значение Да.

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

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

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

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

Создание заявок в личном кабинете

  1. Перейдите в раздел Уведомления Шаблоны mail.ru.


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

       3. В открывшемся окне заполните форму создания шаблона:



Наименование поляОписание
Имя шаблона

Имя вашего шаблона.

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

Email Адрес электронной почты, на который зарегистрированы ваше сообщество в социальной сети «Вконтакте» и/или группа в социальной сети «Одноклассники», от имени которой вы будете выполнять рассылки (имя сообщества/группы будет отображаться в качестве имени отправителя).
Тело шаблона общее для всех

Шаблон текста сообщения, которое вы хотите отправить клиентам в указанных социальных сетях.

При отправке разных сообщений в указанные социальные сети нужно указать шаблон текста сообщения для каждой сети.

Тело шаблона для Вконтакте

Шаблон текста сообщения, которое вы хотите отправить вашим клиентам в социальной сети «Вконтакте».

Группа Вконтакте(url) 

Ссылка на ваше официальное сообщество в социальной сети «Вконтакте».

Тело шаблона для Одноклассники

Шаблон текста сообщения, которое вы хотите отправить вашим клиентам в социальной сети «Одноклассники».

Группа Одноклассники (url)

Ссылка на вашу группу в социальной сети «Одноклассники».


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

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

       4. Для сохранения изменений нажмите кнопку Сохранить.

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

Создание заявок с помощью Twin API

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

       2. Выполните авторизацию.

       3. В разделе MailRu Templates раскройте форму Create mailru template и нажмите кнопку Try it out.


       4. В разделе Edit Value | Model отобразится следующий фрагмент кода:

{
  "email": "test@mail.ru",
  "name": "template001test",
  "createNewService": false,
  "vkGroupUrl": "https://vk.com/club12345678",
  "okGroupUrl": "https://ok.ru/group/12345678",
  "body": "Общий шаблон",
  "vkBody": "Шаблон для Вконтакте",
  "okBody": "Шаблон для Одноклассников"
}

Измените значения указанных ниже параметров:

Имя параметраОписание
email Адрес электронной почты, на который зарегистрированы ваше сообщество в социальной сети «Вконтакте» и/или группа в социальной сети «Одноклассники», от имени которой вы будете выполнять рассылки (имя сообщества/группы будет отображаться в качестве имени отправителя).
name Имя вашего шаблона. Имя шаблона должно быть указано на латинице и не должно содержать пробелов.
vkGroupUrl

Ссылка на официальное сообщество вашей организации в социальной сети «Вконтакте».

okGroupUrl Ссылка на вашу группу в в социальной сети «Одноклассники».
body Шаблон текста сообщения, которое вы будете рассылать вашим клиентам в обеих социальных сетях.
vkBody Шаблон текста сообщения, которое вы будете рассылать вашим клиентам в социальной сети «Вконтакте».
okBody Шаблон текста сообщения, которое вы будете рассылать вашим клиентам в социальной сети «Одноклассники».

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

 

cURL создания заявки на отправку клиентских рассылок
curl - X POST "https://tcl.twin24.ai/api/v1/mailru/createTemplates"
    - 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
'{
  "email":"test@mail.ru",
  "name":"template001test",
  "createNewService":false,
  "vkGroupUrl":"https://vk.com/club12345678",
  "okGroupUrl":"https://ok.ru/group/12345678",
  "body":"Общий шаблон",
  "okBody":"Шаблон для Одноклассников"
}'

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

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

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

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

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

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

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

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

  1. Перейдите на страницу Twin Messaging API и выполните авторизацию.
  2. В разделе MailRu Templates раскройте форму Mailru template list и нажмите кнопку Try it out.


cURL получения списка всех шаблонов заявок со страницы личного кабинета
curl -X GET "https://tcl.twin24.ai/api/v1/mailru/templates" -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"

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


В секции Response body отобразится список со всеми вашими шаблонами. Для каждого шаблона будет указана следующая информация:

Имя параметраОписание
name Имя шаблона.
email Адрес электронной почты, на который зарегистрировано ваше сообщество в социальной сети «Вконтакте и/или группа в социальной сети «Одноклассники», от имени которой выполняются рассылки.
is active Является ли шаблон активным.
ok_group_urlСсылка на официальное сообщество вашей организации в социальной сети «Одноклассники».
vk_group_urlСсылка на официальное сообщество вашей организации в социальной сети «Вконтакте».
templШаблон текста сообщения, которое отправляется вашим клиентам в обеих социальных сетях.
vk_templШаблон текста сообщения, которое отправляется вашим клиентам в социальной сети «Вконтакте».
is confirmed Прошла ли заявка модерацию.
ok_tmplШаблон текста сообщения, которое отправляется вашим клиентам в социальной сети «Одноклассники».

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


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

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

  1. Перейдите на страницу Twin Messaging API и выполните авторизацию.
  2. В разделе MailRu Templates раскройте форму Update mailru template и нажмите кнопку Try it out.


В разделе Edit Value | Model отобразится информация о вашем шаблоне:

{
  "name": "template001test",
  "newName": "newTemplate002",
  "vkGroupUrl": "https://vk.com/club12345678",
  "okGroupUrl": "https://ok.ru/group/12345678",
  "body": "Общий шаблон",
  "vkBody": "Шаблон для Вконтакте",
  "okBody": "Шаблон для Одноклассников"
}

      3. Измените значения требуемых параметров:

Имя параметраОписание
name имя шаблона
newNameновое имя шаблона
VkGroupUrl ссылка на официальное сообщество вашей организации в социальной сети «Вконтакте»
okGroupUrl ссылка на группу вашей организации в социальной сети «Одноклассники»
body шаблон текста сообщения, которое отправляется вашим клиентам в обеих социальных сетях
vkBody шаблон текста сообщения, которое отправляется вашим клиентам в социальной сети «Вконтакте»
okBody шаблон текста сообщения, которое отправляется вашим клиентам в социальной сети «Одноклассники»

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

 

cURL изменения шаблона заявки
curl -X POST "https://tcl.twin24.ai/api/v1/mailru/updateTemplates" 
     -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
'{
   "name":"template001test",
   "newName":\"newTemplate002\",
   "vkGroupUrl":"https://vk.com/club12345678",
   "okGroupUrl":"https://ok.ru/group/12345678",
   "body":"Общий шаблон",
   "vkBody":"Шаблон для Вконтакте",
   "okBody":"Шаблон для Одноклассников"
}'

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

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

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

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

  1. Перейдите на страницу Twin Messaging API и выполните авторизацию.
  2. В разделе MailRu Templates раскройте форму Delete mailru template и нажмите кнопку Try it out.


      3. В поле name введите название шаблона и нажмите кнопку Execute.


cURL удаления шаблона заявки
curl -X POST "https://tcl.twin24.ai/api/v1/mailru/templates/New_clients" 
     -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"

Выбранный шаблон заявки будет удален из вашего личного кабинета.

.

  • No labels