Быстрый старт Telnyx SMS

Telnyx - это облачная коммуникационная платформа, которая позволяет отправлять и получать SMS-сообщения через сеть уровня оператора. С respond.io ты можешь управлять как Telnyx SMS, так и Telnyx Calls в одном месте.

Перед началом

Что понадобится:

Активный аккаунт Telnyx
Номер телефона Telnyx с поддержкой SMS

Как настроить Telnyx SMS

Войди в свой аккаунт Telnyx.
Приобрети номер Telnyx или используй существующий, поддерживающий SMS.
1. В портале Telnyx перейди в раздел Real-Time Communications > Numbers > Buy Numbers.
2. Отфильтруй номера с поддержкой SMS.
3. Заверши покупку.

Как подключить Telnyx SMS к respond.io

В respond.io перейди в Настройки проекта > Добавить канал.
Найди канал Telnyx SMS и нажми Подключить.
Выбери номер телефона Telnyx, который хочешь использовать.
Нажми Сохранить изменения для завершения настройки.

После подключения все SMS, отправленные на твой номер Telnyx, будут отображаться в твоём проекте.

Как настроить SMS-канал Telnyx

SMS-канал Telnyx использует название канала для внутреннего использования.

Перейди в Настройки проекта > Каналы.
Найди канал Telnyx SMS> Нажми Управлять > Аккаунт.
Введи название канала.
Сохрани изменения.

Заметки и ограничения

Ограничения по размеру файла: Изображения, аудио и видео до 1 МБ каждый.
Статус сообщения: Поддерживаются статусы Отправлено, Доставлено и Не доставлено; статус Прочитано недоступен.
Маскировка номеров телефонов для Telnyx SMS недоступна.
Лимит символов в сообщении: respond.io определяет кодировку сообщения и применяет реальный лимит символов Telnyx перед отправкой — 1,530 символов для содержимого GSM-7, 670 символов для UTF-16 (например, арабский, эмодзи). Сообщения в пределах лимита отправляются как одно сообщение; сообщения, превышающие лимит, разбиваются на меньшее количество корректно упорядоченных сегментов.

Доступность рассылок

Рассылки Telnyx SMS можно отправлять только контактам, которые ранее отправляли или получали сообщение через канал Telnyx SMS.

Поскольку рассылки ограничены контактами с предыдущим взаимодействием через Telnyx SMS, ты можешь заметить следующее:

Сегменты: В сегментах могут быть контакты, которые никогда не писали тебе через Telnyx SMS, но эти контакты не будут получать рассылки.
Отчеты: Показатели отправки и доставки могут быть ниже общего числа контактов в выбранном сегменте.
Фильтрация контактов: Фильтрация по каналу Telnyx SMS показывает только контакты с историей взаимодействия через Telnyx SMS.

Примечание: Контакты, активированные через звонки Telnyx, могут не попасть в SMS-рассылки, поскольку в рассылках участвуют только контакты с предыдущим обменом сообщениями.

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

Почему моё сообщение разбивается на несколько SMS?

respond.io определяет кодировку твоего сообщения и применяет реальный лимит символов от Telnyx перед отправкой:

GSM-7 (стандартный текст): до 1,530 символов
UTF-16 (например, арабский текст, эмодзи): до 670 символов

Сообщения в пределах лимита отправляются как одно сообщение в правильном порядке.

Сообщения, превышающие лимит, всё ещё разделяются на сегменты. Порядок сегментов не гарантируется оператором, поэтому очень длинные сообщения всё ещё могут приходить не по порядку — но гораздо реже, чем раньше.

Почему сообщения отображаются как «Отправлено», но Контакт их никогда не получает?

Это может произойти, когда для телефонного номера Telnyx не назначен профиль обмена сообщениями.

Номер не настроен для входящих/исходящих SMS, и Telnyx не отправляет Вебхук о неудачной доставке, поэтому respond.io показывает «Отправлено» без дальнейшего обновления статуса.

Что можно сделать

Войди в портал Telnyx и убедись, что для затронутого телефонного номера назначен профиль обмена сообщениями.
Если ты также видишь ошибку «403 - Account inactive», возможно, на твоём счёте недостаточно средств — уточни у службы поддержки Telnyx.

Почему я не могу выбрать свой номер Telnyx во время настройки?

Платформа не поддерживает подключение Hosted SMS-номеров Telnyx. Она обнаруживает только номера, купленные непосредственно через Telnyx, поэтому Hosted SMS-номера — номера, которые сохраняют голосовую связь у первоначального оператора и маршрутизируют только SMS через Telnyx — никогда не появляются в списке выбора номеров, даже если они активны, поддерживают SMS и назначены профилю обмена сообщениями в Telnyx.

Что можно сделать