Open

UA	US	RU Open

UA	US	RU Open

1. Введение

Определение

«Подключение Business WhatsApp» — инструкция по интеграции WhatsApp Business API с платформой Leeloo.AI через сервис Twilio. После подключения WhatsApp становится одним из каналов связи с лидами и клиентами — как во входящих диалогах, так и в проактивных рассылках по верифицированным шаблонам. Используется на стадиях Привлечение (Attract), Вовлечение (Engage) и Управление (Manage) — WhatsApp становится touchpoint входящих лидов и каналом нотификаций существующих клиентов.

Контекст: интеграция требует аккаунт Twilio с апгрейдом до платного уровня (минимум $20 USD на балансе) и аккаунт Facebook Business для верификации номера. Поддерживается работа как с личным номером клиента, так и с номером, купленным в Twilio (если личный недоступен или имеет ограничения). После настройки можно использовать функционал кнопок (Messaging Service) и отправлять верифицированные шаблоны за пределами 24-часового окна.

B2B оператор (маркетолог / sales manager / системный администратор) выполняет 8 этапов настройки: регистрация Twilio → апгрейд → подключение номера (личный или покупной) → соединение Twilio с Leeloo.AI → активация Messaging Service для кнопок → создание шаблонов для проактивных рассылок.

B2C клиент (подписчик) попадает в туннель через подписку на WhatsApp как канал связи — получает прогревные сообщения и нотификации в WhatsApp Business. В 24-часовом окне может свободно общаться с менеджером; вне окна — получает только верифицированные шаблоны.

К Client's Card записываются: подписка через WhatsApp (с указанием номера и канала Twilio), история сообщений и шаблонов, события сегментации по WhatsApp.

После ознакомления вы поймёте:

• как зарегистрировать аккаунт в Twilio и выполнить апгрейд;

• как подключить личный номер к WhatsApp через Twilio;

• как купить и подключить номер Twilio (если личного нет);

• как соединить Twilio с Leeloo.AI;

• как активировать функционал кнопок (Messaging Service);

• как работать с ограничениями WhatsApp и шаблонами сообщений.

Назначение

Подключение Business WhatsApp превращает один из самых популярных мессенджеров в полноценный канал коммерческой коммуникации в Leeloo.AI — со входящими диалогами, проактивными рассылками и интерактивными кнопками.

Привлечение (Attract): WhatsApp Business как touchpoint захвата лидов через LGT с выбором канала; интеграция с FB Lead Ads и WhatsApp click-to-chat кампаниями. Задача — захватывать лидов через предпочитаемый ими мессенджер.

Вовлечение (Engage): прогревные туннели в WhatsApp с интерактивными кнопками и шаблонами; ответы на типовые вопросы через ИИ Поддержку. Задача — поддерживать вовлечение в туннеле через персональный канал WhatsApp.

Управление (Manage): операторские чаты с подписчиками, проактивные нотификации (заказ оплачен / напоминание о вебинаре / статус доставки) через верифицированные шаблоны. Задача — управлять портфелем подписчиков и снимать рутину менеджеров через WhatsApp как managed channel.

2. Предусловия

Прежде чем начинать подключение, убедитесь, что у вас есть:

• номер телефона: либо личная SIM-карта, которая может принимать SMS и ещё не зарегистрирована в WhatsApp Business, либо номер, купленный непосредственно в Twilio (см. раздел 6);

• аккаунт Twilio (инструкция по регистрации — в разделе 4);

• аккаунт Facebook — открытый в соседней вкладке, для верификации номера на стороне WhatsApp.

3. Регистрация аккаунта в Twilio

Шаг 1. Перейдите по ссылке: https://www.twilio.com/try-twilio

Шаг 2. Заполните все регистрационные данные.

Open

Шаг 3. После регистрации со страницы Dashboard перейдите на страницу с деталями вашего аккаунта.

Open

Шаг 4. Для подключения WhatsApp через Twilio необходимо поднять уровень аккаунта. Нажмите кнопку «Upgrade».

Open

Шаг 5. На следующей странице заполните соответствующие данные.

Open

Open

Шаг 6. Подтвердите вашу личность и заполните данные вашей банковской карты. Минимальная сумма пополнения счёта для поднятия уровня — 20 USD.

Шаг 7. После оплаты переходите к подключению номера к Twilio (раздел 5).

4. Подключение личного номера к Twilio

Шаг 1. В Twilio перейдите в меню Senders → WhatsApp Senders и нажмите кнопку «Create new sender».

Open

Шаг 2. Выберите «My Own Phone Number», введите в соответствующее поле ваш номер телефона, который ещё не зарегистрирован в WhatsApp, и нажмите «Continue».

Open

Шаг 3. Нажмите «Continue with Facebook».

Open

Шаг 4. Выберите нужный аккаунт Facebook и нажмите «Продолжить как…».

Open

Шаг 5. Далее следуйте инструкциям от Facebook и заполняйте нужные данные бизнес-профиля — следующие экраны появятся последовательно:

Open

Open

Open

Open

Open

Open

Open

Open

Open

После завершения настройки вы получите подтверждение подключения номера:

Open

5. Покупка и подключение номера Twilio

Если у вас нет личного номера, который подходит для WhatsApp Business, либо ваш номер уже зарегистрирован в WhatsApp / имеет GEO-ограничения, вы можете купить номер прямо в Twilio и использовать его как WhatsApp Sender.

5.1. Покупка номера в Twilio

Шаг 1. В Twilio Console перейдите в меню Phone Numbers → Manage → Buy a number (или прямая ссылка: https://console.twilio.com/us1/develop/phone-numbers/manage/search).

Open

Шаг 2. В фильтре Country выберите страну, в которой хотите купить номер. Доступность номеров для WhatsApp Business зависит от страны — рекомендуется выбирать United States, United Kingdom, Canada или другие страны с активной поддержкой WhatsApp.

Open

Шаг 3. В блоке Capabilities выберите чекбоксы:

• Voice — голосовые вызовы;

• SMS — текстовые сообщения (обязательно для верификации);

• MMS — мультимедиа;

• FAX — номера с возможностью отправки факсов.
  
  

  Open

  

Шаг 4. Нажмите Search — Twilio покажет список доступных номеров с ежемесячной стоимостью.

Шаг 5. Выберите подходящий номер и нажмите Buy. Списание произойдёт с баланса вашего Twilio-аккаунта (минимум $20 USD должно быть на счету после апгрейда — см. раздел 4).

Open

5.2. Подключение купленного номера к WhatsApp Senders

Шаг 1. После покупки перейдите в Senders → WhatsApp Senders и нажмите «Create new sender» (как в разделе 5).

Open

Шаг 2. Выберите опцию «Twilio Phone Number» (вместо «My Own Phone Number») и выберите ваш только что купленный номер из списка.

Open

Шаг 3. Нажмите «Continue» и далее следуйте инструкции из раздела 5 (шаги 3–5): «Continue with Facebook» → выбор Facebook-аккаунта → заполнение данных бизнес-профиля → подтверждение подключения.

5.3. Стоимость покупного номера

При работе с покупным номером Twilio оплачиваются две позиции:

• Ежемесячная аренда номера — от $1 до $15 USD/месяц в зависимости от страны и типа номера (мобильный / local / toll-free). Списывается автоматически с баланса Twilio.

• Стоимость отправки сообщений — рассчитывается посегментно через WhatsApp Conversation Pricing. Тариф зависит от страны получателя и типа сообщения (user-initiated / business-initiated / template). Актуальные цены: https://www.twilio.com/en-us/whatsapp/pricing

6. Подключение Twilio к Leeloo.AI

Шаг 1. Перейдите в настройки аккаунта Twilio и скопируйте Account SID и Auth Token.

Open

Open

Шаг 2. Перейдите на платформу: https://app.leeloo.ai/settings/integrations/messengers

Настройки → Мессенджеры → Новое соединение. Выберите новое соединение WhatsApp.

Open

Шаг 3. Заполните данные для интеграции:

• Account SID — в поле «Аккаунт»;

• Auth Token — в поле «Токен»;

• Телефон — ваш номер, который вы подключили к Twilio WhatsApp.

Нажмите кнопку «Присоединиться», чтобы добавить соединение.

Шаг 4. Вернитесь в Twilio в раздел Senders → WhatsApp Senders и нажмите «Edit» возле вашего номера телефона.

Open

Open

Шаг 5. В поле «Webhook URL for Incoming Message» укажите: https://app.leeloo.ai/twillio-whatsapp/receive/ВАШ_ID. ID можно скопировать на платформе Leeloo в вашем уже подключённом соединении WhatsApp, нажав кнопку «Скопировать id».

Open

Шаг 6. После внесения изменений нажмите «Update WhatsApp Sender».

Open

7. Активация функционала кнопок (Messaging Service)

Шаг 1. Зайдите в Messaging → Services → Create Messaging Service.

Open

Шаг 2. Дайте сервису любое имя и заполните поля согласно скриншоту ниже.

Open

Шаг 3. На следующем шаге нажмите «Add Senders».

Open

Шаг 4. Выберите опцию «WhatsApp Number».

Open

Шаг 5. Выберите нужный номер телефона и перейдите к следующему шагу.

Open

Шаг 6. Выберите опцию «Send a Webhook».

Open

Шаг 7. Скопируйте вебхук из Leeloo.AI и вставьте его в поле «Request URL».

Open

Open

Шаг 8. На последнем шаге нажмите «Complete Messaging Service Setup», затем «View My Messaging Service».

Шаг 9. Зайдите в Messaging → WhatsApp Senders.

Open

Шаг 10. Найдите ваш номер и нажмите «Edit Sender».

Open

Шаг 11. В меню «Endpoint Configuration» выберите «Use Messaging Service» и выберите название сервиса, который вы создали.

Open

Шаг 12. Нажмите внизу «Update WhatsApp Sender».

Шаг 13. Зайдите в Messaging → Services, скопируйте SID и вставьте его в соответствующее поле на Leeloo.AI.

Open

Open

Шаг 14. Нажмите кнопку «Reconnect».

Шаг 15. Готово! Проверьте возможность отправки кнопок лидам:

Open

8. Ограничения WhatsApp и шаблоны сообщений

Open

Такое уведомление, как на скриншоте выше, появится у вас в аккаунте Twilio после того, как ваш бизнес-аккаунт будет подтверждён. Нажав кнопку «Create Template», вы можете создать шаблоны и отправить их на проверку. Шаблоны нужны для того, чтобы вы могли отправлять сообщения лидам, если они не отвечают вашему боту более 24 часов.

Инструкция по созданию шаблонов от Facebook: https://leelooai.atlassian.net/wiki/spaces/DOC/pages/3359637505/Whatsapp+24

В нашем случае подтверждение бизнес-аккаунта заняло 2 дня. Однако точное время может варьироваться — для уточнения обратитесь к сервису интеграции (Twilio).

8.1. Пошаговая инструкция по созданию шаблонов WhatsApp в Twilio

Для отправки шаблона на подтверждение воспользуйтесь пошаговой инструкцией:

Шаг 1. Зайдите в административную панель Twilio.

Open

Шаг 2. Зайдите в меню Messaging → Senders → WhatsApp Templates.

Шаг 3. Нажмите кнопку «New Message Template».

Open

Шаг 4. Заполните соответствующие поля.

Open

Open

Название шаблона — любое название на английском языке.

Категория шаблона:

• Marketing — любые рассылки маркетингового характера;

• Authentication — сообщения транзакционного характера (2FA, кодовая верификация);

• Utility — системные сообщения.

Шаг 5. Нажмите кнопку «Send for WhatsApp Approval».

Open

Шаг 6. Дождитесь статуса подтверждения «Approved».

Open

Сопутствующие инструкции

Основные термины