Інтеграція SMS-сервісу Twilio з Бітрікс24

Інтеграція сервісу Twilio з Bitrix24

Twilio вибирають, коли потрібні міжнародні SMS, WhatsApp Business API або двосторонній обмін повідомленнями з клієнтами. Російські провайдери домінують на внутрішньому ринку, але для компаній з міжнародними клієнтами — експортерів, SaaS-сервісів, логістичних операторів — Twilio залишається основним інструментом. Інтеграція з Bitrix24 дозволяє відправляти SMS та WhatsApp-повідомлення з CRM, отримувати відповіді клієнтів у хронології угоди та автоматизувати коммунікацію через роботи.

Підключення Twilio через messageservice

Реєстрація провайдера — стандартна для модуля messageservice Bitrix24:

messageservice.sender.add({
  CODE: "twilio_sms",
  TYPE: "SMS",
  HANDLER: "https://your-domain.com/handler/twilio.php"
})

Обробник отримує запит від Bitrix24 та транслює його у Twilio Programmable SMS API:

POST https://api.twilio.com/2010-04-01/Accounts/{AccountSID}/Messages.json

Body:
  To: +NUMBER
  From: +TWILIO_NUMBER
  Body: TEXT
  StatusCallback: https://your-domain.com/handler/twilio-status.php

Аутентифікація — HTTP Basic Auth з AccountSID та AuthToken. Параметр StatusCallback — URL, на який Twilio відправить POST при зміні статусу повідомлення.

Принципова відмінність від російських провайдерів: Twilio вимагає верифіковану номер-відправник (From). Номер купується у консолі Twilio — можна вибрати країну, тип (local, toll-free, mobile) і навіть конкретну комбінацію цифр.

Двосторонній обмін повідомленнями

Більшість російських SMS-провайдерів працюють в одну сторону: компанія відправляє SMS, клієнт не може відповісти. Twilio підтримує повноцінний two-way messaging.

Схема:

1. Компанія відправляє SMS клієнту з Twilio-номера.
2. Клієнт відповідає звичайним SMS на цей номер.
3. Twilio відправляє POST-запит (webhook) на налаштований URL з текстом відповіді та номером відправника.
4. Обробник створює у Bitrix24 активність у хронології через crm.activity.add або вхідне повідомлення у відкритій лінії.

На практиці двосторонній обмін використовується для:

• Підтвердження запису. SMS: «Підтвердіть запис на 15:00, відповідьте ТАК». Клієнт відповідає — робот змінює стадію угоди.
• Швидкого зворотного зв'язку. Після надання послуги: «Оцініть від 1 до 5». Відповідь зберігається у користувальницькому полі контакту.
• Підтримки. Клієнт пише питання в SMS — повідомлення потрапляє у відкриту лінію Bitrix24, менеджер відповідає з CRM.

Для обробки вхідних відповідей у Twilio Console налаштовується webhook на рівні номера: Messaging → Configure → A MESSAGE COMES IN → URL обробника.

WhatsApp Business через Twilio

Twilio — один із офіційних провайдерів WhatsApp Business API. Підключення до Bitrix24 дає менеджерам канал коммунікації з конверсією відкриття 90%+ (проти 20–30% у SMS).

Налаштування:

1. Реєстрація WhatsApp sender у Twilio Console. Проходить модерацію Meta — вимагає верифіковану бізнес-акаунт Facebook.
2. Шаблони повідомлень. WhatsApp вимагає попередньо схвалених шаблонів для ініціювання розмови. Шаблони створюються у Twilio Console та затверджуються Meta.
3. Відправка з Bitrix24. Через окремий обробник або розширення існуючого: якщо номер починається з whatsapp:, запит йде через Twilio WhatsApp API.

У Bitrix24 WhatsApp-повідомлення можна реалізувати двома способами:

• Через messageservice — як SMS-провайдер, але з типом повідомлення WhatsApp. Менеджер вибирає канал при відправці.
• Через відкриті лінії — підключення Twilio WhatsApp як каналу відкритої лінії через REST API (imopenlines.network.join). Повідомлення від клієнтів потрапляють у чат Bitrix24, відповіді йдуть через WhatsApp.

Другий варіант переважніший для підтримки та продажів — менеджер працює у звичному інтерфейсі чатів Bitrix24.

Верифікація номерів та Verify API

Twilio Verify — окремий сервіс для відправки одноразових кодів (OTP). Застосування у контексті Bitrix24:

• Підтвердження номера клієнта при створенні ліда: робот CRM відправляє код через Verify API, клієнт вводить код на сайті, webhook підтверджує номер та оновлює поле UF_CRM_PHONE_VERIFIED.
• Двофакторна авторизація для доступу до особистого кабінету, інтегрованого з Bitrix24.

Verify API тарифікується окремо та дешевше звичайних SMS, оскільки Twilio оптимізує маршрутизацію для OTP.

Статуси доставки

Twilio відправляє callback на StatusCallback URL з кожною зміною статусу:

Twilio передає ErrorCode та ErrorMessage для невдалих відправок. Типові проблеми: 21211 — невалідний номер, 21614 — номер не підтримує SMS, 30004 — абонент заблокував відправника. Коди помилок записуємо у користувальницькому полі угоди для аналізу.

Вартість та міжнародна відправка

Twilio тарифікує посегментно по країні призначення. SMS у Росію — $0.043/сегмент, у США — $0.0079, у Німеччину — $0.065. Для компаній з міжнародною базою різниця у вартості по країнах значна.

Оптимізація:

• Messaging Service. Twilio дозволяє створити Messaging Service, який автоматично вибирає оптимальний номер-відправник по країні одержувача. Один обробник у Bitrix24 — Twilio сам підбирає маршрут.
• Короткі шаблони. Для кирилиці ліміт — 70 символів на сегмент. Для латиниці — 160. Якщо клієнт за кордоном — шаблон англійською вдвічі дешевше.

Терміни впровадження

Що налаштовуємо

• Реєстрація Twilio як SMS-провайдера через messageservice.sender.add
• Обробник Bitrix24 → Twilio Programmable SMS API
• Двосторонній обмін: webhook для вхідних SMS → активність CRM
• WhatsApp Business через Twilio: шаблони, відкриті лінії або messageservice
• Twilio Verify для підтвердження номерів
• Callback-обробник статусів доставки з маппінгом помилок
• Messaging Service для автоматичного вибору маршруту по країні
• Роботи CRM для автоматичних сповіщень
• Тестування: вихідний SMS, вхідна відповідь, WhatsApp-шаблон, Verify OTP, callback статусу