Основы API
Методы API

История событий

GET/webhooks/events
webhooks:events:read

Метод для получения истории последних событий бота. Данный метод будет полезен, если вы не можете получать события в реальном времени на ваш URL, но вам требуется обрабатывать все события, на которые вы подписались.

История событий сохраняется только при активном пункте «Сохранять историю событий» во вкладке «Исходящий webhook» настроек бота. При этом указывать «Webhook URL» не требуется.

Для получения истории событий конкретного бота вам необходимо знать его access_token и использовать его при запросе. Каждое событие представляет JSON объект вебхука.

Параметры строки запроса

limit
integer, (int32)
Количество возвращаемых сущностей за один запрос
Пример:1
По умолчанию:
50
Диапазон:
1 — 50
cursor
string
Курсор для пагинации (из meta.paginate.next_page)
Пример:eyJpZCI6MTAsImRpciI6ImFzYyJ9

Ответ

200OK
The request has succeeded.
data[]
array of objects
*
id
string
*
Идентификатор события
Пример:01KAJZ2XDSS2S3DSW9EXJZ0TBV
event_type
string
*
Тип события
Пример:message_new
payload
anyOf
*
Объект вебхука
MessageWebhookPayloadobject
ReactionWebhookPayloadobject
ButtonWebhookPayloadobject
ChatMemberWebhookPayloadobject
CompanyMemberWebhookPayloadobject
LinkSharedWebhookPayloadobject
created_at
string, (date-time)
*
Дата и время создания события (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
Пример:2025-05-15T14:30:00.000Z
meta
object
Метаданные пагинации
paginate
object
Вспомогательная информация
next_page
string
Курсор пагинации следующей страницы
Пример:eyJxZCO2MiwiZGlyIjomSNYjIn3
История событий
# Для получения следующей страницы используйте cursor из meta.paginate.next_pagecurl "https://api.pachca.com/api/shared/v1/webhooks/events?limit=1" \  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Ответ 200
{  "data": [    {      "id": "01KAJZ2XDSS2S3DSW9EXJZ0TBV",      "event_type": "message_new",      "payload": {        "type": "message",        "id": 1245817,        "event": "new",        "entity_type": "discussion",        "entity_id": 5678,        "content": "Текст сообщения",        "user_id": 2345,        "created_at": "2025-05-15T14:30:00.000Z",        "url": "https://pachca.com/chats/1245817/messages/5678",        "chat_id": 9012,        "parent_message_id": 3456,        "thread": {          "message_id": 12345,          "message_chat_id": 67890        },        "webhook_timestamp": 1747574400      },      "created_at": "2025-05-15T14:30:00.000Z"    }  ],  "meta": {    "paginate": {      "next_page": "eyJxZCO2MiwiZGlyIjomSNYjIn3"    }  }}