Інтеграція 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 на місяць за рахунок зниження дзвінків.
Схема роботи:
- Компанія відправляє SMS клієнту з Twilio-номера.
- Клієнт відповідає звичайним SMS на цей номер.
- Twilio відправляє POST-запит (webhook) на налаштований URL з текстом відповіді та номером відправника.
- Обробник створює в Бітрікс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).
Налаштування:
- Реєстрація WhatsApp sender у Twilio Console. Проходить модерацію Meta — потрібен верифікований бізнес-акаунт Facebook.
- Шаблони повідомлень. WhatsApp вимагає попередньо схвалених шаблонів для ініціювання розмови. Шаблони створюються в Twilio Console і затверджуються Meta.
-
Відправка з Б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 | Значення | Дія в Б24 |
|---|---|---|
queued |
В черзі | — |
sent |
Відправлено оператору | Статус «Відправлено» |
delivered |
Доставлено | Статус «Доставлено» |
undelivered |
Не доставлено | Статус «Помилка» + запис причини |
failed |
Помилка відправки | Статус «Помилка» + сповіщення менеджеру |
Twilio передає ErrorCode і ErrorMessage для невдалих відправок. Типові проблеми: 21211 — невалідний номер, 21614 — номер не підтримує SMS, 30004 — абонент заблокував відправника. Коди помилок записуємо в користувацьке поле угоди для аналізу.
Типові коди помилок Twilio
| ErrorCode | Опис |
|---|---|
| 21211 | Невалідний номер телефону |
| 21614 | Номер не підтримує SMS |
| 30004 | Абонент заблокував відправника |
| 30006 | Перевищено ліміт відправки на номер |
| 30008 | Недостатньо коштів на акаунті |
Вартість та міжнародна відправка
Twilio тарифікує посегментно за країною призначення. Для компаній з міжнародною базою різниця у вартості по країнах значна. Економія від $2000 на місяць можлива при використанні Messaging Service та коротких шаблонів.
Оптимізація:
- Messaging Service. Twilio дозволяє створити Messaging Service, який автоматично обирає оптимальний номер-відправник за країною отримувача. Один обробник в Б24 — Twilio сам підбирає маршрут.
- Короткі шаблони. Для кирилиці ліміт — 70 символів на сегмент. Для латиниці — 160. Якщо клієнт за кордоном — шаблон англійською вдвічі дешевший.
Додаткові витрати: купівля номерів (від $1 на місяць за місцевий номер) та плата за сегменти повідомлень. Але загальна економія на маршрутизації покриває ці витрати.
Процес оцінки та роботи
Ми не використовуємо фіксованих цін — вартість визначається після аналізу вашого проекту. Етапи:
- Збір даних: обговорюємо обсяги повідомлень, необхідні канали (SMS, WhatsApp, Verify), наявні роботи в CRM.
- Аудит та аналіз: вивчаємо поточну інтеграцію (якщо є), прогалини, сумісність з Twilio.
- Проектування: визначаємо архітектуру — використання messageservice, webhook, відкриті лінії.
- Оцінка: розраховуємо трудомісткість та оптимальний канал (Messaging Service тощо).
- Розробка: налаштовуємо провайдера, обробники, роботи.
- Тестування: перевіряємо відправку, двосторонній зв'язок, статуси.
- Запуск: вводимо в експлуатацію, надаємо документацію.
Орієнтири за термінами
| Масштаб | Що входить | Термін |
|---|---|---|
| Базовий | Підключення Twilio SMS, відправка з картки, один робот | 3–5 днів |
| Стандартний | Роботи за стадіями, двосторонній обмін, callback статусів | 1 тиждень |
| Розширений | WhatsApp Business, Verify API, відкриті лінії, Messaging Service | 1,5–2 тижні |
Що входить в роботу
- Реєстрація 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)







