Для разработчиков

История обращений

Удобный эндпоинт для получения всех тикетов одного контакта — например, чтобы показать клиенту его историю обращений в личном кабинете или подсказать оператору предыдущие запросы. Ответ всегда обогащён полями last_message_previewи message_count, что позволяет рендерить список «как в почте» без дополнительных запросов за каждым тикетом.

GET/api/v1/contacts/{contact_id}/tickets

История тикетов контакта

Query параметры:

status — open, pending, resolved, closed
page (default 1), page_size (default 20, max 100)

curl

curl "https://api.support.forestsnet.com/api/v1/contacts/44e1.../tickets?status=closed&page=1" \
  -H "Authorization: Bearer sk_xxx"

200 OK

{
  "items": [
    {
      "id": "8a3f...",
      "subject": "Не работает оплата",
      "status": "closed",
      "priority": "high",
      "rating": 5,
      "last_message_preview": "Спасибо, всё заработало!",
      "message_count": 7,
      "created_at": "2026-03-20T10:00:00",
      "closed_at": "2026-03-20T12:30:00"
    }
  ],
  "total": 12,
  "page": 1,
  "page_size": 20
}

Python SDK

# Получить закрытые обращения контакта
tickets = client.tickets.history("contact-uuid", status="closed")
for t in tickets.items:
    print(t.subject, t.last_message_preview, t.message_count, t.rating)

Была ли страница полезной?