Мессенджеры и возможности
WhatsApp, Telegram и MAX умеют разное. Операцию, которой у мессенджера нет, API отклоняет сразу — 422 unsupported, до обращения к провайдеру.
Что умеет каждый мессенджер
«Да» — метод есть в официальных библиотеках провайдера. «Не проверено» — метод известен только из косвенных источников: запрос выполняется, но может не сработать. «Нет» — API ответит 422, не обращаясь к провайдеру. Таблица та же, что в поле capabilities номера.
| Возможность | Telegram | MAX | |
|---|---|---|---|
Текст text | да | да | да |
Файл по ссылке file_url | да | да | да |
Загрузка файла file_upload | да | да | да |
Файл через хранилище провайдера upload_cloud | да | да | да |
Опрос poll | да | да | нет |
Геолокация location | да | да | не проверено |
Контакт contact | да | да | не проверено |
Пересылка forward | да | нет | не проверено |
Правка сообщения edit | да | да | не проверено |
Удаление сообщения delete | да | да | не проверено |
Отметка «прочитано» read_chat | да | да | да |
«Печатает…» typing | да | да | нет |
Архив чатов archive | да | да | нет |
Сторис stories | да | нет | нет |
Группы groups | да | да | да |
Догрузка истории history | да | да | да |
Привязка по номеру телефона phone_auth | да | да | да |
Привязка по QR-коду qr_auth | да | да | да |
Проверка номера check_account | да | да | да |
Входящие реакции reactions_inbound | да | не проверено | не проверено |
Адрес чата (chatId)
| Мессенджер | Личный чат | Группа | Можно отправить по to.phone |
|---|---|---|---|
79991234567@c.us | …@g.us | да — номер превращается в <цифры>@c.us | |
| Telegram | числовой id | числовой id | нет — нужен chatId (найти: POST /v1/accounts/{id}/check) |
| MAX | числовой id | числовой id | нет — нужен chatId |
Состояние номера (state)
state | Что значит |
|---|---|
authorized | Номер привязан и работает. |
notAuthorized | Номер не привязан или отвязан с телефона — нужен новый QR или код. |
pendingPassword | Telegram: вход принят, но у аккаунта облачный пароль — отправьте его методом authorization/password. |
starting | Номер запускается у провайдера (обычно до 5 минут). Затянулось — шлюз сам перезапускает номер: через 5 минут, потом каждые 10 минут до 3 раз, дальше раз в час. |
blocked | Мессенджер заблокировал номер. |
yellowCard | WhatsApp: предупреждение за подозрительную активность — снизьте частоту рассылки. |
suspended | Номер остановлен у провайдера. |
unknown | Состояние ещё не получено. |
Отправка возможна только в состоянии authorized; в остальных — 409 account_not_ready. Смена состояния приходит событием account.state.
Оплата номера (billingStatus)
billingStatus | Что значит |
|---|---|
active | Оплачено (paidUntil в будущем). |
grace | Срок истёк, идут дни отсрочки (graceDays) — всё работает. |
suspended | Отсрочка кончилась: отправка отвечает 402, приём продолжается, история сохраняется. |
Группы и каналы
По умолчанию номер не принимает переписки групп и каналов (groupsEnabled: false): личный аккаунт состоит в десятках групп, и всё это шло бы к вам. Сообщения из групп тогда не сохраняются и не порождают событий, а отправка в группу отвечает 409 groups_disabled. Включается для номера: PATCH /v1/accounts/{id} {"groupsEnabled": true}.