API
ДокументацияAPI и интеграции

Читать журнал и выгружать сообщения

Как получить сообщения по частям, отфильтровать их и посмотреть попытки отправки.

WAIX API · Обновлено 22 сентября 2026

Запрос страницы

http
GET /messages?limit=50&connection_id=YOUR_CONNECTION_UUID&status=delivered

messages:read. limit — от 1 до 100. Необязательные фильтры: connection_id и status. В журнале есть входящие и исходящие записи, различайте direction.

Следующая страница

Ответ содержит next_before и next_before_id. Если курсор есть, передавайте оба значения как before и before_id вместе с прежними фильтрами. Используйте URLSearchParams для кодирования времени. Одной даты недостаточно: несколько сообщений могут иметь одинаковое время.

javascript
const query = new URLSearchParams({
  limit: '50',
  before: page.pagination.next_before,
  before_id: page.pagination.next_before_id
});
// GET /messages? + query.toString()

Детали и хранение

GET /messages/{id} возвращает детали исходящего сообщения и попыток. Для своей отчётности сохраняйте страницы и связывайте UUID WAIX с meta_message_id. Права ключа и организация применяются ко всем запросам; ID чужой компании не позволяет читать её историю.

Остался вопрос по этой инструкции?Написать в поддержку →