Bots

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

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

Журнал ведётся, только когда в настройках бота включён пункт «Сохранять историю событий» во вкладке «Исходящий webhook». Адрес вебхука при этом можно не указывать вовсе, а если он указан, событие и уедет на него, и ляжет в журнал.

Метод работает только с токеном бота: у личного токена своего журнала нет. События отдаются от новых к старым, идентификатор события — строка, а не число.

Сам журнал не очищается: прочитанные события удаляйте методом [Удаление события](DELETE /webhooks/events/{id}), иначе они придут снова при повторном запросе.

get/webhooks/events

Request

  • Base URL: https://api.pachca.com/api/shared/v1
  • URL: https://api.pachca.com/api/shared/v1/webhooks/events
  • Auth: HTTP bearer

Query parameters

limitinteger
Example:1

Количество возвращаемых сущностей за один запрос

cursorstring
Example:eyJpZCI6MTAsImRpciI6ImFzYyJ9

Курсор для пагинации (из meta.paginate.next_page или meta.paginate.prev_page)

Response

The request has succeeded.

Example response

{
  "data": [
    {
      "id": "01KAJZ2XDSS2S3DSW9EXJZ0TBV",
      "event_type": "message_new",
      "payload": {
        "type": "message",
        "id": 1245817,
        "entity_id": 5678,
        "content": "Текст сообщения",
        "user_id": 2345,
        "created_at": "2025-05-15T14:30:00.000Z",
        "changed_at": "2025-05-15T14:35: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",
      "prev_page": "eyJxZCO2MiwiZGlyIjoiYXNjIn0",
      "has_next": true
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.