Messenger API
Всё, что панель умеет с подключённым аккаунтом Instagram, WhatsApp или Telegram, — через REST: один ключ, один формат ответа, по разделам.
Ошибки и лимиты
Формат ошибки, каждый код ошибки с HTTP-статусом и как работают лимиты.
Формат ошибки
Ошибки всегда в этом формате. Ветвитесь по code, а не по тексту. details (необязательно) содержит ошибки валидации по полям.
{
"success": false,
"error": { "code": "DEVICE_OFFLINE", "message": "No available device is currently online.", "details": {} }
}
Коды ошибок
401
INVALID_API_KEYAPI-ключ не указан или неверен.401
API_KEY_EXPIREDСрок действия этого API-ключа истёк.401
API_KEY_REVOKEDЭтот API-ключ отозван.403
INSUFFICIENT_SCOPEУ этого API-ключа нет нужного разрешения.403
ORGANIZATION_SUSPENDEDЭтот аккаунт приостановлен.401
INVALID_CREDENTIALSНеверный email или пароль.403
ACCOUNT_SUSPENDEDЭтот аккаунт приостановлен. Напишите в поддержку.422
TWO_FACTOR_CODE_INVALIDНеверный код.422
CHALLENGE_EXPIREDВремя этой попытки входа истекло. Начните заново.422
APPLE_NOT_LINKEDЭтот Apple ID ещё не привязан к аккаунту ChatVendor. Войдите один раз по e-mail, затем привяжите Apple ID в разделе «Безопасность».401
UNAUTHENTICATEDСессия не найдена или истекла. Войдите снова.403
FORBIDDENУ вас нет доступа к этому.404
NOT_FOUNDЗапрошенный объект не найден.400
REQUEST_FAILEDНе удалось выполнить запрос.422
VALIDATION_FAILEDВ запросе есть неверные параметры.422
INVALID_PHONE_NUMBERНе удалось распознать номер телефона получателя.422
MESSAGE_TOO_LONGТекст сообщения длиннее допустимого.404
MESSAGE_NOT_FOUNDСообщение не найдено.404
BATCH_NOT_FOUNDПакет не найден.404
DEVICE_NOT_FOUNDУстройство не найдено.404
WEBHOOK_NOT_FOUNDВебхук не найден.409
DEVICE_OFFLINEСейчас нет ни одного устройства в сети.409
DEVICE_DISABLEDВыбранное устройство отключено.409
SIM_UNAVAILABLEВыбранная SIM-карта недоступна.409
SMS_PERMISSION_MISSINGУстройство не дало разрешения на SMS.422
MESSAGE_NOT_CANCELLABLEЭто сообщение уже нельзя отменить.429
RATE_LIMIT_EXCEEDEDСлишком много запросов. Повторите после указанной паузы.402
ENTITLEMENT_EXCEEDEDЭто действие превышает лимиты вашего тарифа.422
IDEMPOTENCY_KEY_REUSEDЭтот ключ идемпотентности уже использован с другим запросом.409
IDEMPOTENT_REQUEST_IN_PROGRESSЗапрос с этим ключом идемпотентности ещё выполняется.422
INVALID_PAIRING_CODEНеверный код привязки.422
PAIRING_CODE_EXPIREDСрок действия кода привязки истёк.500
INTERNAL_ERRORПроизошла непредвиденная ошибка.402
PLAN_REQUIREDТекущий тариф не включает API мессенджеров.404
CHANNEL_NOT_FOUNDКанал не найден.409
CHANNEL_NOT_CONNECTEDКанал не подключён.502
CONNECTOR_ERRORКоннектор канала не ответил.429
FLOOD_WAITМессенджер попросил отправлять реже. Повторите после указанной паузы.422
CHANNEL_REQUEST_FAILEDМессенджер отклонил запрос.403
CHECKOUT_UNAVAILABLEВ этом приложении тариф сменить нельзя.403
BILLING_OWNER_ONLYСменить тариф может только владелец рабочего пространства.422
BILLING_COUNTRY_REQUIREDСначала выберите страну оплаты.409
BILLING_COUNTRY_LOCKEDСтрану оплаты может изменить только поддержка.422
PLAN_NOT_PURCHASABLEЭтот тариф сейчас нельзя купить.422
PAYMENT_PROVIDER_UNAVAILABLEЭтот способ оплаты сейчас недоступен.409
PRICE_CHANGEDЦена изменилась. Проверьте новую сумму.409
CHECKOUT_IN_PROGRESSПлатёж уже создаётся. Повторите через минуту.502
PAYMENT_PROVIDER_ERRORПлатёжный сервис не ответил. Попробуйте ещё раз.404
PAYMENT_NOT_FOUNDПлатёж не найден.Лимиты
Лимиты многоуровневые: на API-ключ, workspace, устройство и SIM (лимит на SIM защищает карту от бесконечного цикла). Telegram добавляет свои flood-лимиты: 429 FLOOD_WAIT сообщает, сколько секунд ждать. Каждый 429 несёт заголовки Retry-After и X-RateLimit-*.