Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 7 Следующий »

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

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

Используя сервисы платформы 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 -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\":\"Общий шаблон\",\"vkBody\":\"Шаблон для Вконтакте\",\"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 -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 -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 -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"

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

.

  • Нет меток