У цій статті ви дізнаєтесь як створити необхідний акаунт в Twilio, як до акаунта Twilio приєднати бізнес-номер WhatsApp, який ви використовуватимете для спілкування з клієнтами та як підключити WhatsApp номер до RemOnline.

Twilio - це платформа з комунікаційних API, яка дозволяє розробникам і компаніям легко інтегрувати засоби зв'язку, такі як телефонія, SMS, чати та відео, у свої додатки та вебсайт. За допомогою Twilio можна надсилати текстові повідомлення, здійснювати телефонні дзвінки, налаштовувати автоматичні відповіді та багато іншого. Нам Twilio допоможе інтегрувати WhatsApp в RemOnline.

Що потрібно для початку?

Важливо: на даний момент купівля українського номера неможлива у Twilio, тому якщо ви перебуваєте в Україні та хочете використовувати український номер, ви можете використати лише власний номер, а не номер Twilio. Якщо ви перебуваєте в іншій країні, ви можете придбати та використовувати номер телефону з кодом цієї країни, якщо такі номери доступні у Twilio.

Ваш власний номер повинен мати можливість приймати SMS або дзвінки. (Якщо номер може приймати тільки телефонні дзвінки, він не має використовувати Інтерактивне Голосове Меню (IVR)).

Після того, як ви отримали платну версію Twilio, потрібно зареєструвати відправника WhatsApp, який дає можливість надсилати та отримувати повідомлення WhatsApp від імені вашого бренду через API Twilio. Перед запуском, можливо, доведеться пройти перевірку Meta Business Verification, встановлену Meta (власником WhatsApp), перш ніж підключати відправників WhatsApp.

Щоб створити відправника WhatsApp:

1. Увійдіть в консоль Twilio.

2. Перейдіть до Messaging > Senders > WhatsApp senders.

3. Ознайомтеся з інформацією на цій сторінці та натисніть Get Started.

4. Ознайомтеся з Умовами використання WhatsApp і позначте чекбокс, якщо ви з ними згодні. Потім натисніть Confirm.

5. Далі виберіть номер телефону, який ви хочете підключити до Business API WhatsApp. Ви можете використовувати номер Twilio або власний WhatsApp номер телефону. Натисніть Continue.

На цьому кроці відкриється віконце з посиланням на Facebook. Не закривайте це віконце і не переходьте на іншу сторінку в консолі Twilio. Воно знадобиться вам для подальших кроків у цій інструкції.

1. Увійдіть у Facebook, якщо ви цього ще не зробили, або натисніть Continue as [ваше ім'я], якщо ви вже зареєстровані.

2. Після входу ви побачите наступні кроки процесу підключення вашого номера до WhatsApp. Натисніть Get started.

3. Після цього Facebook попросить вас дозволити Twilio керувати вашим WhatsApp Business Account. Натисніть Continue.

4. На наступному екрані виберіть зі списку Meta Business Account для вашої компанії. Якщо у вас його ще немає, ви можете створити новий, вибравши опцію Create a Business Account.

5. Далі ви зможете вибрати WhatsApp Business Account (WABA) або створити новий.

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

Важливо: Якщо у вас вже є затверджений бізнес-номер WhatsApp, який ви використовуєте в іншому сервісі, виконайте кроки, описані в цій статті.

6. На наступному екрані вам потрібно буде ввести наступну інформацію:

WhatsApp Business Account Name - використовується лише для внутрішніх цілей і не є доступним для користувачів. Якщо ви вибрали WABA на попередньому екрані, ви не зможете змінити назву тут.

WhatsApp Business Profile Display Name - це те, що бачитимуть ваші клієнти. Воно повинно відповідати вимогам, встановленим WhatsApp.

Category - Виберіть категорію, яка найкраще описує ваш бізнес. Користувачі бачитимуть її, коли переглядатимуть ваш профіль.

Business Description - Короткий опис вашої компанії, та чим ви займаєтесь. Він також відображається користувачам при перегляді вашого профілю в додатку WhatsApp.

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

Ми рекомендуємо використовувати назву вашої компанії для відображення при реєстрації відправників WhatsApp, оскільки WhatsApp відхилятиме все, що не збігається з назвою компанії у пов'язаному бізнес-акаунті.

Однак, можливо, у вас є торгова марка, яку ви хочете використовувати як назву для відображення у вашому WhatsApp Business Account, але вона відрізняється від назви вашої компанії. У такому випадку має бути чіткий зв'язок між вашою компанією та брендом. Цей зв'язок між брендом і вашим бізнесом має бути відображений на вашому вебсайті та в самому імені користувача.

Наприклад, якщо ваша компанія - Johnny Mobile, а ваш бренд - PizzaApp, ми рекомендуємо використовувати дисплейне ім'я "PizzaApp by Johnny Mobile". Ця асоціація повинна бути опублікована на вашому вебсайті, щоб WhatsApp міг її перевірити. Це означає, що десь на вебсайті має бути видимий зв'язок між двома назвами. Якщо ви хочете зберегти назву "PizzaApp", це, як правило, вимагає звернення до WhatsApp і може продовжити процес реєстрації.

Для отримання додаткової інформації ви можете перейти до правил відображення імен у WhatsApp.

1. Якщо ви використовуєте номер Twilio з можливістю надсилання SMS, скопіюйте свій номер Twilio і перейдіть до вікна Twilio Console, яке ви залишили відкритим на кроці 1.

2. Вставте номер у спливаюче вікно Facebook. Залиште вибраним метод перевірки SMS-повідомлення і натисніть Send code.

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

Не продовжуйте, якщо ви отримали попередження про перенесення вашого номера. Замість цього, будь ласка, відкрийте тікет в службу підтримки та зазначте, що вам потрібно перенести номер з Meta або попередньої компанії, з якою ви працювали (Business Solutions Provider).

3. Після цього код підтвердження з'явиться в консолі Twilio під пунктом Verification code. Натисніть Copy та вставте його у віконце Facebook.

4. Натисніть OK на наступному екрані, щоб закрити спливаюче вікно.

Вітаємо! Ваш WhatsApp Business Account тепер прив'язаний до вашого облікового запису Twilio. Після цього Twilio почне процес реєстрації вашого номера в WhatsApp. Цей процес може зайняти до 2 хвилин.

Після успішної реєстрації ваш номер буде відображено. Ви можете натиснути Edit sender, щоб скористатися службою обміну повідомленнями і оновити решту вашого профілю WhatsApp Business, включно з фотографією профілю.

Якщо ви ще не пройшли верифікацію Meta business verification, ваш доступ до WhatsApp спочатку буде обмежений. Якщо ви вже пройшли бізнес-верифікацію, ви матимете повний доступ до WhatsApp.

Щоб підключити додаткові номери, вам потрібно повторити цей процес, переконавшись, що ви вибрали той самий обліковий запис Meta Business Manager і WhatsApp Business Account. Облікові записи Meta Business Manager і WhatsApp Business Account, які наразі прив'язані до вашого облікового запису Twilio, відображаються в консолі Twilio Console.

Зверніть увагу: до завершення верифікації Meta Business деякі номери можуть залишатися в статусі очікування і не можуть бути використані для надсилання повідомлень. Після завершення бізнес-верифікації Meta вам може знадобитися видалити відправників WhatsApp і пройти процес ще раз, щоб підключення пройшло успішно.

Щоб створити Messaging Service, перейдіть у розділ Messaging > Services і натисніть Create Messaging Service.

Крок 1. Заповніть наступні поля:

Messaging Service friendly name – придумайте назву своєму Messaging Service (наприклад Order Chats)

Select what you want to use Messaging for – оберіть функцію, яка найкраще підходить для ваших чатів.

Натисніть Create Messaging Service.

Крок 2. Натисніть Add senders, оберіть WhatsApp Number і оберіть номер для якого ви хочете включити Messenger Service. На цьому ж кроці ви можете додатково налаштувати обраний номер.

Sticky Sender – забезпечує послідовність комунікації для одержувачів повідомлень, вибираючи той самий номер телефону відправника, який ви раніше використовували в розмові з даним клієнтом.

Area Code Geomatch – надсилаючи повідомлення до США та Канади, використовуйте місцеві телефонні номери з кодом міста, який збігається або накладається на номер телефону одержувача.

Ці функції за замовчуванням увімкнені. Щоб їх вимкнути – натисніть на перемикач.

Також ви можете додати ще номери, якщо не обрали кілька номерів на попередньому кроці, натиснувши на кнопку Add Senders або видалити вже доданий номер, натиснувши Remove навпроти нього.

Позначте ті номери, з якими ви хочете працювати, і натисніть Step 3. Set up integration.

Крок 3. На цьому кроці потрібно налаштувати вебхуки для автоматизації процесів і для синхронізації даних між вашими обліковими записами в Twilio та RemOnline.

Оберіть опцію Use webhooks, і вставте необхідні посилання в наступні поля:

https://web.remonline.app/chat-service/v1/webhook/twilio/whatsapp

https://web.remonline.app/chat-service/v1/webhook/twilio/whatsapp/status

Біля полей Request URL та Fallback URL має стояти опція HTTP Post.

В полі Validity period ми рекомендуємо залишити те значення, яке там стоїть по замовчуванню - 14400. Це кількість секунд, протягом яких повідомлення, надіслані з вашого поштового сервісу, залишатимуться на платформі Twilio. Якщо час, необхідний для відправлення повідомлення, перевищує Validity period, Twilio відхиляє повідомлення і надсилає запит на вашу Callback URL, щоб повідомити вас про помилку.

Щоб продовжити, натисніть Step 4: Add compliance info.

Крок 4. Додайте інформацію про дотримання вимог. Це можна зробити з допомогою реєстрації для A2P 10DLC (10-значного коду) в США.

Це система у США, яка дозволяє бізнесам надсилати повідомлення з програми людині (A2P) за допомогою 10-значних телефонних номерів (10DLC). Реєстрація для A2P повідомлень покращить якість доставки і зменшить фільтрацію.

Щоб завершити створення Messaging Service, натисніть Complete Messaging Service Setup.

Важливим кроком у налаштуванні акаунту Twilio є налаштування базової автентифікації HTTP у своєму акаунті Twilio для того, щоб отримання медіафайлів працювало коректно.

Для цього перейдіть у розділ Messaging > Settings > General > HTTP Basic Authentication for media access, оберіть опцію Disabled і натисніть Save внизу сторінки для збереження змін.

Готово! Останнім кроком є підключення до RemOnline, після чого ви зможете використовувати WhatsApp для спілкування з вашими клієнтами.

1. На дашборді Twilio перейдіть у розділ Account Info. Тут ви знайдете Account SID та Auth Token, які вам потрібні для підключення до чатів RemOnline. Скопіюйте ці дані.

2. Потім перейдіть у розділ Messaging > Services та знайдіть Messaging Service, який ви створили. Скопіюйте його Sid.

3. В RemOnline перейдіть у розділ Налаштування > Чати та натисніть + Канал. Оберіть ресурс WhatsApp by Twilio.

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

Назва каналу - придумайте назву своєму WhatsApp каналу, який використовувати для спілкування з клієнтами.

Account SID - вставте код Account SID скопійований з вашого Twilio акаунту.

Важливо: якщо канал з ідентичним Account SID вже підключений іншою компанією, система не дозволяє під'єднати новий канал з тим самим кодом в RemOnline. Щоб це виправити, необхідно видалити вже наявну інтеграцію в іншій компанії, і тоді додати канал з цим Account SID в RemOnline.

Auth Token - тут вставте код Auth Token, скопійований з вашого Twilio акаунту.

Номер телефону - впишіть той номер телефону, який ви зареєстрували в Twilio та використовуватиме для спілкування з клієнтами.

Messaging Service Sid – тут потрібно вставити код Messaging Service Sid скопійований з сторінки Messaging Service.

5. Налаштуйте Доступ до каналу:

Всі – доступ до налаштування Чату матимуть всі співробітники компанії при умові, що такий доступ дозволений їм системою;

Обрані – доступ до налаштування Чату матимуть лише обрані співробітники при умові, що такий доступ дозволений їм системою;

Власник – доступ до налаштувань матиме лише Власник компанії.

Щоб поміняти налаштування доступу співробітників до Чату і налаштувань Чату, потрібно перейти у Налаштування > Співробітники > Ролі та відредагувати необхідні налаштування.

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

Готово! Тепер ви можете спілкуватися з клієнтами за допомогою WhatsApp безпосередньо в RemOnline. Більше інформації про те, як користуватися шаблонами WhatsApp в RemOnline можна знайти тут.

Вартість використання WhatsApp розраховується на основі тарифу за розмову від Meta та тарифу за повідомлення від Twilio.

Перші 1000 розмов на місяць – безкоштовні, за умови, що вони відбуваються протягом перших 24 годин після отримання повідомлення від користувача. Будь-які розмови, ініційовані вами після цього періоду, є платними.

Наприклад, $0.025 за кожну розмову, та $0.005 за кожне повідомлення з українського номера.

Таким чином, загальна вартість використання WhatsApp включає як плату за розмову від Meta, так і плату за кожне окреме повідомлення від Twilio. Дізнатись детальнішу інформацію про ціни та розрахувати вартість використання WhatsApp від Twilio можна тут.