Справочник API
Сравнение провайдеров

Поддержка единого отправления сообщений

Какие типы полезной нагрузки и провайдер-специфичные расширения принимает POST /v1/messages для каждого провайдера.

Возможность

ВозможностьTelegramWhatsAppTwitter / XLINEZalo
text (текст)Полная поддержкаПолная поддержкаПолная поддержкаПолная поддержкаПолная поддержка
image (изображение)Полная поддержкаПолная поддержкаПолная поддержкаПолная поддержкаПолная поддержка
video (видео)Полная поддержкаПолная поддержкаПолная поддержкаПолная поддержкаПолная поддержка
audio (аудио)Полная поддержкаПолная поддержкаЧастичнаяПолная поддержкаПолная поддержка
document (файл)Полная поддержкаПолная поддержкаНе поддерживаетсяПолная поддержкаПолная поддержка
reply_to.reply_token (цитата)Не поддерживаетсяПолная поддержкаНе поддерживаетсяНе поддерживаетсяНе поддерживается
mentions (упоминания)Не поддерживаетсяПолная поддержкаНе поддерживаетсяНе поддерживаетсяНе поддерживается
provider_data.parse_mode (разметка)Полная поддержкаНе поддерживаетсяНе поддерживаетсяНе поддерживаетсяНе поддерживается

Примечания

  • Аудиосообщения WhatsApp принимают content как JSON-строку {"url":"...","seconds":N,"waveform":"..."} — обязателен только url.
  • parse_mode (Markdown / HTML) сегодня полностью работает только в Telegram. Другие провайдеры игнорируют это поле.
  • Twitter принимает аудио только как часть медиа-вложения, отдельные голосовые сообщения не поддерживаются.
  • Twitter не поддерживает произвольные вложения-документы — конвертируйте в изображение или ссылку перед отправкой.
  • reply_to.reply_token отправляет ответ с цитатой: передайте data.message.reply_token из входящего события без изменений. Пока только WhatsApp — остальные провайдеры возвращают 501 unsupported_by_provider; повреждённый token даёт 400 invalid_reply_token.
  • mentions отмечает участников группы: объявите id в массиве mentions и разместите якоря {{@<id>}} в text / caption. Только WhatsApp; остальные провайдеры игнорируют поле, а плейсхолдеры уходят как обычный текст. provider_data.mentions устарел.