Перейти к содержанию

Статус инстанса#

Входящее уведомление данного типа содержит данные о состоянии авторизации инстанса

Настройка инстанса

Чтобы получать входящие уведомления о сообщениях с геолокацией, необходимо включить настройки одним из представленных вариантов:

  1. Через личный кабинет включить настройку Получать уведомления об изменении состояния авторизации аккаунта

  2. Через метод SetSettings включить настройку stateWebhook

Уведомление#

Формат уведомления#

Параметр Тип Описание
typeWebhook string Тип входящего уведомления. Для уведомлений данного типа поле принимает значение stateInstanceChanged
instanceData object Данные об инстансе
timestamp integer Время наступления события в UNIX-формате
stateInstance string Состояние инстанса. Принимает значения:
notAuthorized - Инстанс не авторизован. Для авторизации инстанса обратитесь к разделу Перед началом работы
authorized - Инстанс авторизован
blocked - Инстанс получил блокировку
starting - Инстанс в процессе запуска (сервисный режим). Происходит перезагрузка инстанса, сервера или инстанс в режиме обслуживания. Может потребоваться до 5 минут для перевода состояния инстанса в значение authorized
pendingCode - Для завершения авторизации необходимо отправить код авторизации методом SendAuthorizationCode
pendingPassword - Для завершения авторизации необходимо отправить пароль двухфакторной аутентификации (2fa) методом SendAuthorizationPassword

Поля объекта instanceData

Параметр Тип Описание
idInstance integer Идентификатор инстанса. Значение типа uint64, 10 разрядов
wid string Идентификатор аккаунта
typeInstance string Тип мессенджера для инстанса
- telegram для Telegram
- whatsapp - для WhatsApp
- v3 - для MAX

Пример тела уведомления#

{
  "typeWebhook": "stateInstanceChanged",
  "instanceData": {
    "idInstance": 4100000000,
    "wid": "79876543210@c.us",
    "typeInstance": "telegram"
  },
  "timestamp": 1755589527,
  "stateInstance": "authorized"
}