Большинство ботов в Пачке взаимодействуют с внешними сервисами при помощи вебхуков. В этом случае мессенджер сам отправляет данные, например, на ваш сервер.
Однако использование вебхуков не всегда возможно. Например, если ваш сервер не доступен по публичному адресу или на нём установлены ограничения, блокирующие входящие запросы (firewall). В таких случаях альтернативным решением становится использование метода опроса (поллинг). В этой статье расскажем, как настроить поллинг в Пачке.
Поллинг — это метод, при котором ваша система регулярно запрашивает данные через API Пачки, проверяя новые события. Вместо автоматических уведомлений от мессенджера, ваш скрипт спрашивает: «Есть что-то новое с последнего запроса?»
Поллинг удобен, если:
Для работы поллинга нужно:
access_token бота, как для отправки сообщений.Структура событий описана в документации к Исходящим вебхукам.
GET-запрос:
https://api.pachca.com/api/shared/v1/webhooks/events
limit: Количество событий (по умолчанию — 50, максимум — 50).cursor: Для пагинации. Если событий больше, в поле meta.paginate.next_page вернётся значение для следующего запроса.JSON-ответ включает:
id: Уникальный ID события.event_type: Тип события (например, message_new).payload: Данные события (например, текст сообщения).created_at: Время события в формате ISO-8601 (UTC).Поле meta содержит данные для пагинации.