Интеграция SMS-сервиса Twilio с Битрикс24

Интеграция 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 в месяц за местный номер) и плата за сегменты сообщений. Но общая экономия на маршрутизации покрывает эти расходы.

Сроки внедрения

Что входит в работу

• Регистрация 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)