Контакты

Доступ только для чтения к контактам проекта. Контакты — это люди, которые обращались к вам через разные каналы.

Список контактов

Список контактов (курсорная пагинация).

Ответ

200Успех

{
  "results": [
    {
      "id": "7c4e9b02-1a55-4e88-b0d1-2f3a4b5c6d7e",
      "display_name": "Jane Doe",
      "notes": "VIP customer",
      "metadata": { "plan": "gold" },
      "is_blocked": false,
      "created_at": "2026-06-01T09:00:00+00:00",
      "updated_at": "2026-07-01T10:40:00+00:00"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Поддерживает cursor и limit (по умолчанию 50, максимум 100).

Получить контакт

Получить один контакт по id.

Ответы

200Успех

{
  "id": "7c4e9b02-1a55-4e88-b0d1-2f3a4b5c6d7e",
  "display_name": "Jane Doe",
  "notes": "VIP customer",
  "metadata": { "plan": "gold" },
  "is_blocked": false,
  "created_at": "2026-06-01T09:00:00+00:00",
  "updated_at": "2026-07-01T10:40:00+00:00"
}

404Не найдено

{ "detail": "contact_not_found" }

Объект контакта

id, display_name.
notes — произвольные заметки оператора.
metadata — произвольный JSON, привязанный к контакту.
is_blocked — заблокирован ли контакт.
created_at, updated_at — ISO-8601.

Запись контактов (создание / изменение) в v1 не входит — это в планах. Эндпоинты чтения доступны уже сейчас.