Голосовые звонки в мобильном приложении с Twilio SDK

Голосовые звонки с Twilio SDK

Пользователь нажимает кнопку вызова — а звонок не проходит. Или входящий звонок приходит с задержкой в 10 секунд. Чаще всего проблема в неправильной интеграции Twilio Voice: Access Token истёк, PushKit не настроен, CallKit вызван не в том порядке. Разберём, как избежать этих ошибок.

Twilio Programmable Voice SDK — промышленная платформа, избавляющая от возни с TURN-серверами и медиасерверами. Twilio берёт на себя медиатранспорт (Opus/DTLS/SRTP), глобальную маршрутизацию через 90+ data centers. Разработчику остаётся: сигнализация через Twilio, управление аудиосессией на мобильной платформе и интеграция с системными звонковыми интерфейсами (CallKit на iOS, ConnectionService на Android). У нас за плечами 5+ успешных проектов с Twilio Voice, гарантируем стабильную работу в продакшне.

Как настроить серверную часть: Access Token?

Twilio Voice SDK аутентифицируется через краткосрочные Access Token, которые генерирует ваш бэкенд с помощью Twilio Helper Library. Токен содержит VoiceGrant — разрешения на входящие и исходящие звонки. Типичная конфигурация:

from twilio.jwt.access_token import AccessToken from twilio.jwt.access_token.grants import VoiceGrant token = AccessToken( account_sid=ACCOUNT_SID, signing_key_sid=API_KEY_SID, private_key=API_KEY_SECRET, identity=user_id, ttl=3600 ) token.add_grant(VoiceGrant( outgoing_application_sid=TWIML_APP_SID, incoming_allow=True )) return token.to_jwt() 

Мобильный клиент получает токен при запуске и обновляет его до истечения. Twilio SDK уведомляет через делегат accessTokenInvalidOrExpired — в этот момент нужно сделать запрос на новый токен и вызвать updateAccessToken. Рекомендуем TTL 3600 секунд — баланс между безопасностью и частотой обновления. Twilio official documentation подтверждает этот подход.

Шаги для генерации Access Token на сервере:

1. Создать API Key в Twilio Console.
2. Настроить TwiML Application с webhook URL.
3. Написать эндпоинт на Node.js/Python, возвращающий JWT с VoiceGrant.

Почему для входящих звонков на iOS обязателен PushKit?

PushKit — единственный надёжный способ доставки входящего звонка в любом состоянии приложения. APNs VoIP channel гарантирует приоритетную доставку. Без PushKit приложение не получит сигнал в фоне.

func pushRegistry(_ registry: PKPushRegistry, didUpdate credentials: PKPushCredentials, for type: PKPushType) { TwilioVoice.register(accessToken: token, deviceToken: credentials.token) { error in } } func pushRegistry(_ registry: PKPushRegistry, didReceiveIncomingPushWith payload: PKPushPayload, for type: PKPushType, completion: @escaping () -> Void) { TwilioVoice.handleNotification(payload.dictionaryPayload, delegate: self, delegateQueue: nil) // ОБЯЗАТЕЛЬНО вызвать CallKit reportNewIncomingCall до completion } 

Нарушение правила вызова CallKit до completion в PushKit delegate — принудительное завершение приложения iOS. Это не предупреждение, это crash. Интеграция с CallKit через TVODefaultAudioDevice — Twilio предоставляет готовый AVAudioSession менеджер, который правильно взаимодействует с CallKit.

Как подключить ConnectionService на Android?

Зависимость: com.twilio:voice-android:6.x.x. SDK работает поверх WebRTC, но предоставляет высокоуровневый API.

// Инициализация Voice.initialize(context, LogLevel.DEBUG) // Исходящий звонок val connectOptions = ConnectOptions.Builder(accessToken) .params(mapOf("To" to phoneNumber)) .build() val call = Voice.connect(context, connectOptions, object : Call.Listener { override fun onConnected(call: Call) { /* звонок установлен */ } override fun onDisconnected(call: Call, error: CallException?) { /* завершён */ } override fun onConnectFailure(call: Call, error: CallException) { /* ошибка */ } }) 

Входящие звонки приходят через FCM. Twilio SDK обрабатывает FCM payload через Voice.handleMessage():

override fun onMessageReceived(message: RemoteMessage) { if (Voice.handleMessage(context, message.data, object : MessageListener { override fun onCallInvite(callInvite: CallInvite) { // показываем уведомление о входящем звонке showIncomingCallNotification(callInvite) } override fun onCancelledCallInvite(cancelledInvite: CancelledCallInvite, ...) { // звонок отменён до ответа } })) { /* это Twilio push */ } } 

Принятие звонка: callInvite.accept(context, callListener). Для корректной работы с ConnectionService обязательно указывать правильный android:name в манифесте — иначе система не сможет активировать службу.

TwiML и маршрутизация на сервере

Отметим: когда мобильный клиент звонит через Twilio, запрос идёт на ваш TwiML Application webhook. Бэкенд отвечает TwiML — XML-инструкциями для Twilio:

<?xml version="1.0" encoding="UTF-8"?> <Response> <Dial callerId="+1234567890"> <Client>recipient_user_id</Client> </Dial> </Response> 

Для звонков на обычные телефонные номера — <Number> вместо <Client>. Twilio выступает посредником, ваш сервер управляет логикой маршрутизации.

Запись звонков и аналитика

Запись через TwiML <Record> или программно через REST API — доступна без изменений в SDK. Twilio хранит записи на своих серверах, предоставляя URL для скачивания. Аналитика звонков (длительность, качество, статусы) — через Twilio Console или REST API. Мы настраиваем автоматическое уведомление о записи в вашу CRM.

Сравнение Twilio Voice со своим WebRTC

Когда стоит выбрать собственный WebRTC?

Twilio Voice добавляет latency через relay — все медиапотоки идут через дата-центры Twilio, не P2P. Для большинства задач это незаметно (< 50 мс дополнительной задержки при ближайшем PoP), но в регионах без близкого дата-центра Twilio (Центральная Азия, часть Африки) задержка может быть заметной. Стоимость: при больших объёмах (10 000+ минут/день) собственный WebRTC + TURN дешевле, но дороже в разработке и поддержке. Если вам нужна P2P-связь без посредников — пишите, мы поможем выбрать архитектуру.

Процесс интеграции

Срок полной интеграции — 1–3 недели. Экономия на инфраструктуре — до $50 000 за первый год.

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

• Разработка и настройка бэкенда: генерация Access Token, TwiML webhook (Node.js или Python).
• Интеграция Twilio Voice SDK на iOS (Swift, CallKit) и Android (Kotlin, ConnectionService).
• Настройка PushKit (iOS) и FCM (Android) для входящих звонков.
• Тестирование на реальных устройствах, отладка багов.
• Документация по интеграции и инструкция по эксплуатации.
• Обучение вашей команды (до 2 часов онлайн).

Свяжитесь для консультации по архитектуре и стоимости. Закажите интеграцию Twilio Voice у нас — получите стабильные звонки за 2 недели.