LINQ

Подключение PRX к обмену сообщениями через iMessage, RCS и SMS с помощью Linq Partner V3 API для мультипротокольной мобильной коммуникации.

Предварительные требования

• Партнёрский аккаунт Linq с доступом к API
• API-токен Linq
• Номер телефона, выделенный через Linq для отправки сообщений

Быстрая настройка

1. Получение учётных данных API

1. Зарегистрируйте партнёрский аккаунт Linq на linqapp.com
2. Получите API-токен из партнёрской панели управления
3. Запишите номер телефона, назначенный вашему аккаунту для отправки

2. Конфигурация

[channels_config.linq]
api_token = "your-linq-api-token"
from_phone = "+15551234567"
allowed_senders = ["+1987654321"]

3. Настройка вебхуков

Настройте Linq для отправки вебхук-событий на эндпоинт шлюза PRX:

POST https://your-prx-domain.com/linq

4. Проверка

prx channel doctor linq

Справочник конфигурации

Поле	Тип	По умолчанию	Описание
api_token	String	обязательный	API-токен партнёра Linq (используется как Bearer-аутентификация)
from_phone	String	обязательный	Номер телефона отправителя (формат E.164, например, "+15551234567")
signing_secret	String	null	Секрет подписи вебхуков для проверки HMAC-подписи
allowed_senders	[String]	[]	Разрешённые номера телефонов отправителей в формате E.164. "*" = разрешить всем

Возможности

• Мультипротокольный обмен сообщениями — отправка и получение через iMessage, RCS и SMS через единую интеграцию
• Доставка через вебхуки — получение сообщений через HTTP-вебхук push от Linq
• Поддержка изображений — обработка входящих вложений изображений и их отображение как маркеров изображений
• Определение исходящих/входящих — автоматическая фильтрация собственных исходящих сообщений
• Проверка подписи — опциональная HMAC-верификация подписи вебхуков с signing_secret
• Фильтрация по номерам E.164 — ограничение доступа конкретными номерами отправителей

Ограничения

• Требуется публично доступный HTTPS-эндпоинт для доставки вебхуков
• Доступ к Linq Partner API требует партнёрского аккаунта (не потребительского)
• Доставка сообщений зависит от протокола обмена сообщениями получателя (iMessage, RCS или резервный SMS)
• Обрабатываются только MIME-типы изображений для встроенных вложений; остальные типы медиа пропускаются
• Лимиты частоты API зависят от вашего уровня партнёрства Linq

Устранение неполадок

Вебхук-события не получаются

• Проверьте, что URL вебхука публично доступен и указывает на https://your-domain/linq
• Проверьте партнёрскую панель управления Linq на наличие логов и ошибок доставки вебхуков
• Убедитесь, что шлюз PRX запущен и слушает на корректном порту

Сообщения отправляются, но ответы не проходят

• Проверьте, что api_token действителен и не истёк
• Убедитесь, что from_phone — действительный выделенный номер телефона на вашем аккаунте Linq
• Проверьте ответ API Linq на наличие деталей ошибки

Бот отвечает на собственные сообщения

• Этого не должно происходить; PRX автоматически фильтрует исходящие сообщения по полям is_from_me и direction
• Если это происходит, проверьте, что формат данных вебхука соответствует ожидаемой структуре Linq V3