Підключення Business WhatsApp
UA | US | RU |
|---|
1. Вступ
Розділ «Підключення Business WhatsApp» описує, як підключити WhatsApp Business до платформи Leeloo.AI через сервіс Twilio. Після інтеграції WhatsApp стає одним з каналів зв'язку з лідами та клієнтами — як у вхідних діалогах, так і в розсилках за шаблонами.
Канал WhatsApp належить до етапів Engage → Manage життєвого циклу клієнта: він дозволяє приймати звернення лідів, вести діалог у мережі та надсилати їм проактивні повідомлення (за умови підтвердження шаблонів). Інтеграція потребує облікового запису Twilio з апгрейдом до платного рівня та облікового запису Facebook Business.
З цієї інструкції ви дізнаєтеся:
як зареєструвати обліковий запис у Twilio та виконати апгрейд;
як підключити ваш номер телефону до WhatsApp через Twilio;
як з'єднати Twilio з Leeloo.AI;
як активувати функціонал кнопок (Messaging Service);
як працювати з обмеженнями WhatsApp та шаблонами повідомлень.
2. Основні терміни
Термін | Пояснення |
|---|---|
Twilio | Сервіс хмарної комунікації, через який Leeloo.AI підключається до WhatsApp Business API. |
Account SID / Auth Token | Дані доступу до облікового запису Twilio, які вказуються при підключенні інтеграції на платформі. |
WhatsApp Sender | Номер телефону, підключений до WhatsApp Business через Twilio та верифікований через Facebook. |
Messaging Service SID | Ідентифікатор сервісу повідомлень у Twilio, який дозволяє надсилати повідомлення з кнопками. |
Шаблон (Template) | Заздалегідь підготовлений текст повідомлення, верифікований WhatsApp. Потрібен для проактивних розсилок за межами 24-годинного вікна. |
24-годинне вікно | Період, протягом якого можна вільно листуватися з користувачем після його останнього повідомлення. Після — лише шаблони. |
3. Передумови
Перш ніж починати підключення, переконайтеся, що у вас є:
SIM-карта, яка може приймати SMS і яка ще не зареєстрована у WhatsApp Business;
обліковий запис Twilio (інструкція з реєстрації — у розділі 4);
обліковий запис Facebook — відкритий у сусідній вкладці, для верифікації номера на стороні WhatsApp.
Важливо: у разі використання WhatsApp розумні розсилки проводити не рекомендується. Якщо в короткий проміжок часу розсилається одне й те саме повідомлення багатьом одержувачам, є ризик блокування номера. WhatsApp не публікує чітких критеріїв, за які номер може бути заблокований — все індивідуально (скарги на спам, частота повідомлень без відповіді тощо). Явних обмежень на зовнішні посилання немає, але комунікацію слід будувати за інтерактивним принципом: вхідне повідомлення від клієнта → вихідне від платформи.
Рекомендуємо ознайомитися з правилами Twilio щодо WhatsApp:
4. Реєстрація облікового запису в Twilio
Крок 1. Перейдіть за посиланням: https://www.twilio.com/try-twilio
Крок 2. Заповніть усі реєстраційні дані.
Крок 3. Після реєстрації зі сторінки Dashboard перейдіть на сторінку з деталями вашого облікового запису.
Крок 4. Для підключення WhatsApp через Twilio необхідно підняти рівень облікового запису. Натисніть кнопку «Upgrade».
Крок 5. На наступній сторінці заповніть відповідні дані.
Крок 6. Заповніть дані вашої банківської картки. Мінімальна сума поповнення рахунку для підняття рівня — 20 USD.
Крок 7. Після оплати переходьте до підключення номера до Twilio (розділ 5).
5. Підключення номера до Twilio
Крок 1. У Twilio перейдіть у меню Senders → WhatsApp Senders та натисніть кнопку «Get Started».
Крок 2. Виберіть «My Own Phone Number», введіть у відповідне поле ваш номер телефону, який ще не зареєстрований у WhatsApp, і натисніть «Continue».
Крок 3. Натисніть «Continue with Facebook».
Крок 4. Виберіть потрібний обліковий запис Facebook і натисніть «Продовжити як…».
Крок 5. Далі дотримуйтеся інструкцій від Facebook і заповнюйте потрібні дані бізнес-профілю — наступні екрани з'являтимуться послідовно:
Після завершення налаштування ви отримаєте підтвердження підключення номера:
6. Підключення Twilio до Leeloo.AI
Крок 1. Перейдіть до параметрів облікового запису Twilio та скопіюйте Account SID і Auth Token.
Крок 2. Перейдіть на платформу: https://app.leeloo.ai/settings/integrations/messengers
Налаштування → Месенджери → Нове з'єднання. Виберіть нове з'єднання WhatsApp.
Крок 3. Заповніть дані для інтеграції:
Account SID — у поле «Акаунт»;
Auth Token — у поле «Токен»;
Телефон — ваш номер, який ви підключили до Twilio WhatsApp.
Натисніть кнопку «Приєднатися», щоб додати з'єднання.
Крок 4. Поверніться до Twilio у розділ Senders → WhatsApp Senders та натисніть «Edit» біля вашого номера телефону.
Крок 5. У полі «Webhook URL for Incoming Message» вкажіть: https://app.leeloo.ai/twillio-whatsapp/receive/ВАШ_ID. ID можна скопіювати на платформі Leeloo у вашому вже підключеному з'єднанні WhatsApp, натиснувши кнопку «Скопіювати id».
Крок 6. Після внесення змін натисніть «Update WhatsApp Sender».
На цьому процес підключення завершено. Тепер ви можете додати WhatsApp як ще один канал зв'язку на вашому LGT.
7. Активація функціоналу кнопок (Messaging Service)
Щоб з'явився функціонал надсилання кнопок лідам, необхідно налаштувати Twilio Messaging Service та отримати Messaging Service SID.
Крок 1. Зайдіть у Messaging → Services → Create Messaging Service.
Крок 2. Дайте сервісу будь-яке ім'я та заповніть поля згідно зі скриншотом нижче.
Крок 3. На наступному кроці натисніть «Add Senders».
Крок 4. Виберіть опцію «WhatsApp Number».
Крок 5. Виберіть потрібний номер телефону та перейдіть до наступного кроку.
Крок 6. Виберіть опцію «Send a Webhook».
Крок 7. Скопіюйте вебхук з Leeloo.AI і вставте його в поле «Request URL».
Крок 8. На останньому кроці натисніть «Complete Messaging Service Setup», потім «View My Messaging Service».
Крок 9. Зайдіть у Messaging → WhatsApp Senders.
Крок 10. Знайдіть ваш номер та натисніть «Edit Sender».
Крок 11. У меню «Endpoint Configuration» виберіть «Use Messaging Service» та виберіть назву сервісу, який ви створили.
Крок 12. Натисніть внизу «Update WhatsApp Sender».
Крок 13. Зайдіть у Messaging → Services, скопіюйте SID та вставте його у відповідне поле на Leeloo.AI.
Крок 14. Натисніть кнопку «Reconnect» на Leeloo.AI.
Крок 15. Готово! Перевірте можливість надсилання кнопок лідам:
8. Обмеження WhatsApp та шаблони повідомлень
Месенджер WhatsApp дозволяє надсилати користувачам повідомлення лише в межах 24-годинного вікна. Через 24 години з моменту останнього повідомлення від користувача ви не зможете комунікувати з ним напряму. Щоб мати можливість надсилати проактивні повідомлення поза вікном, необхідно створити шаблони повідомлень і відправити їх на верифікацію. Лише після підтвердження ви зможете безперешкодно надсилати раніше перевірений контент.
Таке повідомлення, як на скриншоті вище, з'явиться у вашому обліковому записі Twilio після того, як ваш бізнес-акаунт буде підтверджено. Натиснувши кнопку «Create Template», ви можете створити шаблони та відправити їх на перевірку. Шаблони потрібні для того, щоб ви могли надсилати повідомлення лідам, якщо вони не відповідають вашому боту понад 24 години.
Інструкція зі створення шаблонів від Facebook: https://developers.facebook.com/docs/whatsapp/message-templates/creation/
У нашому випадку підтвердження бізнес-акаунту зайняло 2 дні. Однак точний час може варіюватися — для уточнення зверніться до сервісу інтеграції (Twilio).
Для успішного використання WhatsApp у роботі обов'язково ознайомтеся з рекомендаціями сервісу: https://www.whatsapp.com/policies/commerce-policy/
Зверніть увагу, що компанія Leeloo.AI не має відношення до вимог Twilio/WhatsApp і не впливає на схвалення вашої заявки та верифікацію бізнес-профілю. Платформа Leeloo.AI лише надає можливість інтеграції з Twilio/WhatsApp, тому дотримуйтеся всіх інструкцій від Twilio/WhatsApp з їхніх сайтів та листів із запитами на додаткову інформацію.
Питання технічного характеру, які стосуються підключення вашого вже верифікованого бізнес-профілю WhatsApp, можна задавати в чат технічної підтримки Leeloo.AI.
8.1. Покрокова інструкція зі створення шаблонів WhatsApp у Twilio
Щоб мати можливість надсилати проактивні повідомлення своїй аудиторії поза межами 24-годинного вікна, потрібно підтвердити шаблон повідомлення, яке ви плануєте надіслати.
Для надсилання шаблону на підтвердження скористайтеся покроковою інструкцією:
Крок 1. Зайдіть до адміністративної панелі Twilio.
Крок 2. Зайдіть у меню Messaging → Senders → WhatsApp Templates.
Крок 3. Натисніть кнопку «New Message Template».
Крок 4. Заповніть відповідні поля.
Назва шаблону — будь-яка назва англійською мовою.
Категорія шаблону:
Marketing — будь-які розсилки маркетингового характеру;
Authentication — повідомлення транзакційного характеру (2FA, кодова верифікація);
Utility — системні повідомлення.
Крок 5. Натисніть кнопку «Send for WhatsApp Approval».
Крок 6. Дочекайтеся статусу підтвердження «Approved».
Після підтвердження текстового шаблону у Twilio ви можете надсилати текст безпосередньо з Leeloo.AI.
9. Супутні інструкції
Назва інструкції | Призначення |
|---|---|
Підключення інших месенджерів до платформи Leeloo.AI. |