WhatsApp – Twilio

Готовы подключиться к каналу WhatsApp? Для начала вам понадобится учетная запись Twilio.

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

Если у вас уже есть платная учетная запись Twilio, вы можете пропустить эти инструкции и перейти к разделу "Как добавить канал WhatsApp в Creatio с использованием обновленной учетной записи Twilio".

Инструкции:

Как создать тестовую учетную запись Twilio

  1. Перейдите на https://www.twilio.com/try-twilio

  2. Заполните все обязательные поля

  1. Подтвердите свой адрес электронной почты и номер телефона

  1. Заполните поля, как показано на скриншоте:

  1. Нажмите Get started with Twilio

После создания тестовой учетной записи Twilio следуйте пошаговым инструкциям ниже, чтобы продолжить

Как добавить канал WhatsApp в Creatio с использованием тестовой учетной записи Twilio

  1. Войдите в Creatio под пользователем с лицензией Beesender Chat Master.

  2. Перейдите в дизайнер системы и откройте раздел Конфигурация чатов Beesender.

  3. На вкладке Каналы нажмите "+" и выберите WhatsApp.

  1. Введите имя для канала (например, WhatsApp) в поле Имя канала.

  2. Скопируйте Webhook из поля Webhook.

  3. Перейдите в свою учетную запись Twilio и войдите в систему.

  4. На левой панели страницы Twilio нажмите на Messaging, затем выберите Try it out и нажмите на Send a WhatsApp message.

  5. На вкладке Sandbox settings вставьте Webhook из Creatio в поле When a message comes in.

  6. Нажмите Save.

  7. Скопируйте Status Webhook в последнем поле.

  8. Вставьте Status Webhook из Creatio в поле Status callback URL.

  9. Нажмите Save.

  10. Скопируйте значение My Twilio phone number со страницы Twilio и вставьте его в поле Номер телефона в Creatio в формате: "14155238886".

  1. Нажмите на My first Twilio account. На вкладке Account Info вы увидите два поля:

  • Account SID

  • Auth Token

  1. Скопируйте значение Account SID с этой страницы и вставьте его в поле Twilio AccountSid в Creatio.

  2. Скопируйте значение Auth Token со страницы Twilio и вставьте его в поле Twilio AuthToken в Creatio.

  3. Введите вес чата.

  4. Нажмите Добавить.

Скопируйте код, сгенерированный Twilio через WhatsApp, с вашего номера на номер вашей тестовой учетной записи. Если сообщение будет доставлено успешно, вы получите уведомление в Twilio. В результате ваш номер будет добавлен в Sandbox Participants.

Вот и все! Вы успешно добавили канал WhatsApp в Creatio с использованием тестовой учетной записи Twilio.

Как добавить канал WhatsApp в Creatio с использованием обновленной учетной записи Twilio

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

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

  1. Войдите в Creatio под пользователем с лицензией Beesender Chat Master.

  2. Перейдите в дизайнер системы и откройте раздел Конфигурация чатов Beesender.

  3. На вкладке Каналы нажмите "+" и выберите WhatsApp.

  1. Введите имя для канала (например, WhatsApp) в поле Название канала.

  2. Скопируйте Webhook в последнем поле.

  3. Перейдите в свою учетную запись Twilio и войдите в систему.

  4. На левой панели страницы Twilio нажмите на Messaging, затем выберите Senders и нажмите на WhatsApp Senders.

  1. В разделе WhatsApp Senders найдите таблицу с вашим номером WhatsApp, скопируйте значение номера телефона со страницы Twilio и вставьте его в поле Номер телефона в Creatio в формате: "3700000000".

  2. Нажмите на ваш номер WhatsApp.

  3. В окне конфигурации конечной точки вставьте Webhook из Creatio в поле Webhook URL for incoming messages.

  4. Прокрутите вниз и нажмите Update WhatsApp Sender.

  1. Нажмите на My first Twilio account. На вкладке "Account Info" вы увидите поля:

  • Account SID

  • Auth Token

  1. Скопируйте значение Account SID с этой страницы и вставьте его в поле Twilio AccountSid в Creatio.

  2. Скопируйте значение Auth Token со страницы Twilio и вставьте его в поле Twilio AuthToken в Creatio.

  3. Введите вес чата.

  4. Нажмите Добавить.

Вот и все! Вы успешно добавили канал WhatsApp в Creatio с использованием обновленной учетной записи Twilio.

Как зарегистрировать HSM-сообщения для WhatsApp в Twilio

Чтобы зарегистрировать HSM-сообщения (Highly Structured Messages) для WhatsApp в Twilio, следуйте этим шагам:

  1. Войдите в свою учетную запись Twilio и перейдите на страницу Senders.

  2. Перейдите на страницу Content Template Builder.

  3. Нажмите Create new.

  4. Заполните следующие поля:

  • Template name (Имя шаблона)

  • Message language (Язык сообщения) – выберите язык из списка

  • Select Content Type (Выберите тип контента) - Текст

  1. Нажмите "Create"

  2. Заполните поле "Body"

Если вы хотите включить параметры в шаблон, просто напишите их в поле "Body" (Шаг 6) в формате {{1}}, {{2}} и так далее. Например, вы можете написать: "Привет, {{1}}. Позвони мне, пожалуйста, по этому номеру {{2}}". Позже агент сможет заменить {{1}} и {{2}} на свои собственные значения.

  1. Нажмите "Save and submit for WhatsApp approval" (Сохранить и отправить на утверждение в WhatsApp).

  1. В окне "Submit for WhatsApp review" (Отправить на проверку в WhatsApp) выберите "Marketing" .

  2. Нажмите "Submit".

После того как вы зарегистрировали свои HSM-шаблоны, вы можете использовать их в своих сообщениях WhatsApp, обращаясь к имени шаблона и предоставляя необходимые значения параметров. Twilio автоматически заменит параметры на правильные значения при отправке сообщения вашему получателю WhatsApp.

Как зарегистрировать HSM-сообщения для WhatsApp в Creatio

  1. Перейдите в Studio рабочего места и откройте раздел "Lookups" или перейдите в раздел "Lookups" из шестеренки дизайнера системы

  2. Нажмите "Add lookup" и выберите "Template Whatsapp". Установите имя справочника, например, "WhatsApp templates"

  1. Откройте содержимое добавленного справочника и нажмите "Add".

  2. Укажите имя шаблона, например, Greeting

  3. В поле "Description" предоставьте точное текстовое сообщение, соответствующее шаблону, зарегистрированному в Twilio. Этот текст автоматически заполнит поле ввода "Text" (Текст), когда этот конкретный шаблон будет выбран из панели коммуникаций. В конце текста обязательно добавьте [#HSM#]SID. Замените SID на значение Content Template SID из карточки вашего утвержденного шаблона.

  1. В поле "SID" также введите ваш Content Template SID из шаблона.

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

Как добавить интерактивное сообщение WhatsApp

Чтобы создать интерактивное меню сообщения для WhatsApp в Twilio, следуйте этим шагам:

Создание сервиса обмена сообщениями

  1. Войдите в свою учетную запись Twilio и перейдите на страницу Services

  2. Перейдите на страницу "Messaging Services".

  3. Нажмите "Create Messaging Service".

  4. Заполните следующие поля:

  • Messaging Service friendly name (Имя сервиса обмена сообщениями)

  • Select what you want to use Messaging for (Выберите, для чего вы хотите использовать обмен сообщениями)

  1. Нажмите "Create Messaging Service" (Создать сервис обмена сообщениями):

a) Нажмите "Add Senders" (Добавить отправителей), и в окне "Add Senders" заполните поле "Sender Type" (Тип отправителя) значением "WhatsApp Number"

b) Нажмите "Continue"

c) Активируйте флажок рядом с требуемым номером

d) Нажмите "Add WhatsApp Number"

  1. Нажмите "Step 3: Set up integration" (Шаг 3: Настройка интеграции):

a) Активируйте флажок "Send a webhook" в разделе "Integration"

b) Заполните поле "Request URL" значением из карточки добавления канала WhatsApp в CRM (из поля Webhook).

c) Заполните поле "Callback URL" значением из карточки добавления канала WhatsApp в CRM (из поля Status Webhook).

 

  1. Нажмите "Step 4: Add compliance info"

  2. Нажмите "Complete Messaging Service Setup" (Завершить настройку сервиса обмена сообщениями).

  3. Добавьте канал в CRM (прочитайте: 'Как добавить канал WhatsApp в Creatio с использованием обновленной учетной записи Twilio').

Интерактивное сообщение

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

  1. В элементе "Beesender: Ask a question" (Beesender: Задать вопрос) бизнес-процесса чат-бота заполните поле "Message" (Сообщение) следующим образом: [*MENU*]What would you like to do today?[Main menu]. Текст "Что бы вы хотели сделать сегодня" и "Главное меню" можно заменить на любой текст по вашему выбору.

  2. Заполните поля "Button"

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

Устранение неполадок

Сообщения агентов не доходят до WhatsApp в Beesender

Если сообщения агентов не доходят до WhatsApp, а вы получаете сообщения от клиентов после подключения канала, скорее всего, был указан неверный номер телефона при добавлении канала WhatsApp.

Чтобы решить эту проблему, перейдите в "Конфигурацию чатов Beesender", удалите канал WhatsApp и добавьте его снова.

Убедитесь, что номер телефона указан в формате {номер}.

Также убедитесь, что whatsapp написано правильно и что в номере телефона есть двоеточие, знак плюса и нет пробелов.

Если вы добавили канал с использованием "Messaging Services", но сообщения не поступают в систему, попробуйте перейти в настройки вашего сервиса, перейти на вкладку "Sender Pool" и удалить и снова добавить ваш номер WhatsApp.