/
WhatsApp (Twilio)

WhatsApp (Twilio)

Готові підключитися до потужного каналу WhatsApp? Спочатку вам знадобиться обліковий запис Twilio, щоб розпочати.

Якщо у вас ще немає облікового запису, немає проблем! Створити його легко. Просто дотримуйтесь наведених нижче інструкцій, щоб налаштувати свій обліковий запис та почати тестування каналу.

Якщо у вас вже є платний обліковий запис Twilio, ви можете пропустити ці інструкції та перейти до розділу "Як додати канал WhatsApp до Creatio, використовуючи оновлений обліковий запис Twilio".

Інструкції:

 

Як створити тестовий обліковий запис Twilio Sandbox

Як створити тестовий обліковий запис Twilio Sandbox

  1. Перейдіть за посиланням Twilio Cloud Communications | Web Service API for building Voice and SMS Applications

  2. Заповніть усі необхідні поля

  1. Підтвердіть свою електронну пошту та номер телефону

 

  1. Заповніть поля так, як показано на знімку екрана нижче:

  1. Натисніть "Get started with Twilio" Після створення вашого тестового облікового запису Twilio слідуйте цим покроковим інструкціям нижче, щоб продовжити

Як додати канал WhatsApp до Creatio, використовуючи Twilio Sandbox

  1. Увійдіть до Creatio користувачем з ліцензією Beesender Chat Master.

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

  3. На вкладці Канали натисніть + та виберіть WhatsApp.

 

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

  2. Скопіюйте Webhook із поля Webhook.

  3. Перейдіть до свого облікового запису Twilio та увійдіть.

  4. У лівій панелі сторінки Twilio натисніть на Повідомлення(Messaging), потім виберіть "Спробувати"(Try it out) та натисніть "Відправити повідомлення WhatsApp"(Send a WhatsApp message).

  5. На вкладці налаштувань Sandbox(Sandbox settings) вставте webhook із Creatio у поле "Коли надходить повідомлення" (When a message comes in).

  6. Натисніть Зберегти(Save).

  7. Скопіюйте Status Webhook у останньому полі.

  8. Вставте Status Webhook із Creatio у поле URL для зворотного виклику статусу.

  9. Натисніть Зберегти.

  10. Скопіюйте значення Мій номер телефону Twilio (My Twilio phone number) зі сторінки Twilio та вставте його у поле Номер телефону в Creatio у форматі: "14155238886".

  1. Натисніть на Мій перший обліковий запис Twilio(My first Twilio account). На вкладці Інформація про обліковий запис ви побачите три поля:

  • Account SID

  • Auth Token

  1. Скопіюйте значення Account SID з цієї сторінки та вставте його у поле Twilio AccountSid у Creatio.

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

  3. Введіть вагу чату.

  4. Натисніть Додати.

Скопіюйте код, згенерований Twilio через WhatsApp з вашого номера на номер вашого тестового облікового запису. Якщо повідомлення успішно доставлено, ви отримаєте сповіщення у Twilio. В результаті ваш номер буде додано до учасників Sandbox.

Ось і все! Ви успішно додали канал WhatsApp до Creatio, використовуючи Sandbox Twilio.

Як додати канал WhatsApp до Creatio, використовуючи платний обліковий запис Twilio

Налаштування оновленого облікового запису Twilio схоже на налаштування Sandbox, але є кілька невеликих відмінностей.

Слідуйте простим крокам, і ви швидко налаштуєте все! Крім того, ми виділили відмінності, на які вам потрібно звернути увагу, щоб ви могли легко орієнтуватися в процесі налаштування.

  1. Увійдіть до Creatio користувачем з ліцензією Beesender Chat Master.

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

  3. На вкладці Канали натисніть + та виберіть WhatsApp.

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

  2. Скопіюйте Webhook із останнього поля.

  3. Перейдіть до свого облікового запису Twilio та увійдіть.

  4. У лівій панелі сторінки Twilio натисніть на Повідомлення (Messaging), потім виберіть Відправники (Senders) та натисніть на Відправники WhatsApp (WhatsApp Senders).

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

  2. Натисніть на свій номер WhatsApp.

  3. У вікні налаштування кінцевої точки вставте webhook із Creatio у поле URL вебхука для вхідних повідомлень.

  4. Прокрутіть вниз і натисніть Оновити відправника WhatsApp (Update WhatsApp Sender).

  1. Натисніть на Мій перший обліковий запис Twilio (My first Twilio account). На вкладці Інформація про обліковий запис ви побачите поля:

    • Account SID

    • Auth Token

  1. Скопіюйте значення Account SID з цієї сторінки та вставте його у поле Twilio AccountSid у Creatio.

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

  3. Введіть вагу чату.

  4. Натисніть Додати.

Ось і все! Ви успішно додали канал WhatsApp до Creatio, використовуючи платний обліковий запис Twilio.

 

 

Як зареєструвати повідомлення HSM (Highly Structured Messages) для WhatsApp у Twilio

Щоб зареєструвати повідомлення HSM для WhatsApp у Twilio, слідуйте цим крокам:

  1. Увійдіть у свій обліковий запис Twilio та перейдіть на сторінку Відправників (Senders).

  2. Перейдіть на сторінку шаблонів WhatsApp (WhatsApp templates).

  3. Натисніть "Новий шаблон повідомлення"(New message Template).

  4. Заповніть наступні поля:

    • Назва шаблону

    • Мова повідомлення – виберіть мову зі списку

    • Вибрати тип контенту - Текст

  1. Натисніть "Створити"

  2. Заповніть поле "Тіло"

Якщо ви хочете включити параметри в шаблон, просто напишіть їх у полі "Тіло" (крок 6) як текст у форматі {{1}}, {{2}} тощо. Наприклад, ви можете мати: Привіт, {{1}}. Зателефонуйте мені, будь ласка, за цим номером {{2}}.
Пізніше агент зможе замінити {{1}} та {{2}} на свої власні значення.

  1. Натисніть "Зберегти та подати на затвердження WhatsApp"

  1. У вікні "Подати на перегляд WhatsApp" виберіть "Маркетинг"

  2. Натисніть "Подати"

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

Як зареєструвати HSM-повідомлення для WhatsApp у Creatio

  1. Перейдіть до робочого місця Studio та відкрийте розділ довідники або перейдіть до розділу довідники зі значка Конструктор системи

  2. Натисніть Додати пошук та виберіть Шаблон WhatsApp. Встановіть назву пошуку, наприклад - Шаблони WhatsApp.

  1. Відкрийте вміст доданого пошуку та натисніть Додати.

  2. Вкажіть Назву шаблону, наприклад, Привітання.

  3. У полі Опис надайте точний текст повідомлення, який відповідає шаблону, зареєстрованому в Twilio. Цей текст автоматично заповнить поле Текст, коли буде вибрано цей конкретний шаблон з панелі комунікацій. В кінці тексту обов'язково додайте [#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. Заповніть наступні поля:

  • Зручне ім'я для служби обміну повідомленнями

  • Виберіть, для чого ви хочете використовувати службу обміну повідомленнями

  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".

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 за допомогою Upgraded Twilio account').

Інтерактивне повідомлення

Щоб переконатися, що кнопки у вашому чат-боті відображаються як інтерактивне меню, виконайте наступне:

  1. У елементі "Beesender: Ask a question" бізнес-процесу чат-бота заповніть поле “Message” наступним чином: [*MENU*]Що б ви хотіли зробити сьогодні?[Головне меню].
    Текст "Що б ви хотіли зробити сьогодні" і "Головне меню" можна замінити на будь-який інший текст за вашим вибором.

  2. Заповніть поля Button.

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

Можливі труднощі та помилки

Повідомлення оператора не доходять до WhatsApp у Beesender

Якщо повідомлення від агента не доходять до WhatsApp, а ви отримуєте повідомлення від клієнтів після підключення каналу, ймовірно, було надано неправильний номер телефону під час додавання каналу WhatsApp.

Щоб вирішити цю проблему, перейдіть до Beesender Chat Configuration, видаліть канал WhatsApp і додайте його знову.

Переконайтеся, що номер телефону вказано у форматі {номер}.

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

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