Журнал изменений

Здесь появляются все изменения API: новые маршруты, поля, значения и исправления.

#Ошибка 410 у списков

Текст detail у ошибки cursor_expired теперь подходит и спискам, и ленте событий: для списка начните заново без cursor, для ленты выполните восстановление. Код и статус не изменились.

#v1, ранний доступ

Первая версия публичного API. Только чтение по ключу организации.

• Маршруты: GET /v1/me, GET /v1/workspaces, GET /v1/campaigns, GET /v1/campaigns/{id}, GET /v1/leads, GET /v1/leads/{id}, GET /v1/leads/{id}/messages, GET /v1/events.
• Права ключа: campaigns:read, leads:read, messages:read, events:read; отдельная галочка «Текст сообщений».
• Охват ключа по пространствам и кампаниям, срок действия, список разрешенных IP, перевыпуск с перекрытием, отзыв и журнал запросов.
• Лента событий lead.first_message_sent и lead.replied с курсором на 30 суток, параметрами start=now и include_text.
• Ошибки в формате RFC 9457 с заголовком Request-Id, лимиты в весовых единицах с заголовками RateLimit.
• Спецификация OpenAPI 3.1.
• Материалы для ИИ-агентов: llms.txt, llms-full.txt, Markdown каждой страницы, промпт для агента и меню «Копировать страницу».

Известные ограничения раннего доступа:

• delivery_state со значениями waiting_queue и failed и automation_state со значением completed пока не выдаются.
• Полнота архива переписки и ленты событий не гарантируется: смотрите meta.completeness и meta.coverage.
• Записи через API нет. Планы описаны на странице Что дальше.