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

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

Twilio выбирают, когда нужны международные SMS, WhatsApp Business API или двусторонний обмен сообщениями с клиентами. Российские провайдеры закрывают внутренний рынок, но для компаний с зарубежными клиентами — экспортёров, SaaS-сервисов, логистических операторов — Twilio остаётся основным инструментом. Интеграция с Битрикс24 позволяет отправлять SMS и WhatsApp-сообщения из CRM, получать ответы клиентов в таймлайне сделки и автоматизировать коммуникацию через роботов.

Подключение 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.

Схема:

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

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.

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

Twilio отправляет callback на StatusCallback URL с каждым изменением статуса:

Twilio передаёт ErrorCode и ErrorMessage для неудачных отправок. Типовые проблемы: 21211 — невалидный номер, 21614 — номер не поддерживает SMS, 30004 — абонент заблокировал отправителя. Коды ошибок записываем в пользовательское поле сделки для анализа.

Стоимость и международная отправка

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

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

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

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

Что настраиваем

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