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

Ми — команда з понад 10-річним досвідом в інтеграціях Бітрікс24 та 50+ успішних проектів. Часто налаштовуємо Twilio для компаній, яким потрібні міжнародні SMS, WhatsApp Business API або двосторонній обмін повідомленнями з клієнтами. Російські провайдери закривають внутрішній ринок, але для експортерів, SaaS-сервісів та логістичних операторів Twilio залишається основним інструментом. Наш досвід показує, що інтеграція з Бітрікс24 дозволяє відправляти SMS та WhatsApp-повідомлення з CRM, отримувати відповіді клієнтів у таймлайні угоди та автоматизувати комунікацію через роботів — з гарантією доставки та повним контролем статусів.

Основна причина підключення Twilio — міжнародне охоплення: підтримується відправка у 180+ країн, верифіковані номери-відправники та єдиний API для SMS, WhatsApp і Verify, що спрощує архітектуру.

Чому Twilio краще за російських провайдерів для міжнародної SMS-розсилки?

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

• Глобальну маршрутизацію через власні контракти з Tier-1 операторами.
• Messaging Service — автоматичний вибір номера-відправника за країною отримувача.
• Verify API — окрему систему для OTP з оптимізованою вартістю.

Вартість повідомлень варіюється: наприклад, SMS в Росію — $0,043/сегмент, у США — $0,0079, до Німеччини — $0,065. При великих обсягах економія може досягати $3000 на місяць за рахунок правильної маршрутизації.

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

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

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

Обробник приймає запит від Б24 і транслює його в 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. На практиці це вирішує конкретні бізнес-задачі:

Кейс: Логістична компанія відправляла сповіщення про статус вантажу закордонним клієнтам через російського провайдера. Клієнти не могли відповісти — доводилося телефонувати, що збільшувало навантаження на кол-центр. Після інтеграції Twilio з Бітрікс24 налаштували двосторонній обмін: клієнт відповідає «ТАК» на SMS з підтвердженням доставки — робот CRM переводить угоду на стадію «Доставлено». Економія від $2000 на місяць за рахунок зниження дзвінків.

Схема роботи:

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

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

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

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

Як налаштувати WhatsApp Business через Twilio в Бітрікс24?

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

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

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

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

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

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

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

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

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

Verify API тарифікується окремо і дешевший за звичайні SMS, оскільки Twilio оптимізує маршрутизацію для OTP. Середня вартість одного OTP-повідомлення — близько $0,05.

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

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

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

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

Twilio тарифікує посегментно за країною призначення. Для компаній з міжнародною базою різниця у вартості по країнах значна. Економія від $2000 на місяць можлива при використанні Messaging Service та коротких шаблонів.

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

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

Додаткові витрати: купівля номерів (від $1 на місяць за місцевий номер) та плата за сегменти повідомлень. Але загальна економія на маршрутизації покриває ці витрати.

Процес оцінки та роботи

Ми не використовуємо фіксованих цін — вартість визначається після аналізу вашого проекту. Етапи:

1. Збір даних: обговорюємо обсяги повідомлень, необхідні канали (SMS, WhatsApp, Verify), наявні роботи в CRM.
2. Аудит та аналіз: вивчаємо поточну інтеграцію (якщо є), прогалини, сумісність з Twilio.
3. Проектування: визначаємо архітектуру — використання messageservice, webhook, відкриті лінії.
4. Оцінка: розраховуємо трудомісткість та оптимальний канал (Messaging Service тощо).
5. Розробка: налаштовуємо провайдера, обробники, роботи.
6. Тестування: перевіряємо відправку, двосторонній зв'язок, статуси.
7. Запуск: вводимо в експлуатацію, надаємо документацію.

Орієнтири за термінами

Що входить в роботу

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

Цікавить інтеграція? Зв'яжіться з нами — розрахуємо оптимальний канал та вартість повідомлень для вашого проекту. Замовте налаштування — ми гарантуємо стабільну роботу всіх каналів у зв'язці з Бітрікс24.

Джерело: офіційна документація Twilio Programmable SMS API (https://www.twilio.com/docs/sms)