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

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

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

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

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

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

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

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

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

  

  
  

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

       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": "Шаблон для Одноклассников"
}

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

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 -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 отобразится список со всеми вашими шаблонами. Для каждого шаблона будет указана следующая информация:

Для загрузки списка шаблонов нажмите кнопку 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. Измените значения требуемых параметров:

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"

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

.