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. Заповніть усі необхідні поля

Open

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

Open

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • Account SID

    • Auth Token

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • Account SID

    • Auth Token

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

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

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

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

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

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

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

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

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

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

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

   • Категорія шаблону – виберіть категорію зі списку

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

   • Текст повідомлення

5. Натисніть "Зберегти шаблон для схвалення WhatsApp".

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

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

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

2. Натисніть Додати довідник (Add lookup) і виберіть Шаблон WhatsApp(Template Whatsapp). Встановіть назву списку, наприклад - Шаблони WhatsApp.

   • Примітка. Пропустіть кроки 1-2, якщо список був доданий раніше.

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

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

5. У полі Опис надайте точний текст повідомлення, який відповідає зареєстрованому у Twilio шаблону. Цей текст автоматично заповнить поле вводу тексту, коли цей конкретний шаблон буде вибраний з панелі комунікації.

6. У полі Тип шаблону відповіді виберіть тип шаблону, наприклад, Діалог.

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

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

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

1. Щоб виправити цю проблему, перейдіть до Конфігурації чату Beesender, видаліть канал WhatsApp, а потім додайте його знову.

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

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