Запрос

POST max/messageStatus

Отметка МАКС о том, что наши исходящие сообщения доставлены получателю или прочитаны им. Работает только для интеграции MAX direct (общение с личного аккаунта, без бота): официальный Bot API таких уведомлений не присылает.

Лид в запросе не указывается — одна отметка может закрыть сразу несколько сообщений чата. Изменяются только сообщения, чей чат принадлежит владельцу токена.

Тело запроса

{
    "status": "read",
    "max_chat_id": "123456789",
    "mark_time": 1772000000000,
    "message_ids": ["987654321"],
    "sender_phone": "+79001234567",
    "peer_user_id": "1234567890"
}

Описание полей

  • status - delivered (доставлено) или read (прочитано)
  • message_ids - Массив id сообщений на стороне МАКС, к которым относится отметка. Если МАКС прислал отметку не по конкретным сообщениям, а «водяным знаком» по чату — передавайте вместо него пару max_chat_id + mark_time
  • max_chat_id - Идентификатор чата в МАКС
  • mark_time - Время отметки в миллисекундах: помечаются все сообщения чата, отправленные не позже этого момента
  • sender_phone - Телефон аккаунта МАКС, от имени которого шла переписка (для диагностики)
  • peer_user_id - Идентификатор собеседника в МАКС (для диагностики)

Обязателен либо непустой message_ids, либо пара max_chat_id и mark_time.

Пример запроса:

curl -H 'Content-Type: application/json' \
    -H 'token: someToken' \
    -X POST \
    -d '{"status":"read","max_chat_id":"123456789","mark_time":1772000000000}' \
    https://direct.lptracker.ru/max/messageStatus

Пример ответа при успешном выполнении:

{
    "status": "success",
    "result": 1
}