Версии и совместимость
REST API v1 задаётся в пути. Версия OpenAPI — формат документа, api_version в webhook — версия payload, а .v1 в type — версия события: это разные вещи.
API находится в private preview. Совместимость best_effort_additive проверяется по generated OpenAPI. Публичные SLA, сроки deprecation и OAuth ещё не установлены. Обрабатывайте неизвестные additive поля без отказа; breaking changes требуют отдельно спроектированной версии и migration guidance.
Changelog
- 2026-10-13 · changed
messaging.read is the single read grant for a project's correspondence: sources, conversations and the full message history. One Webhook module delivers message, task and deal events; the offered events follow the enabled project modules.
Grant messaging.read to integrations that list conversations or read messages; keys that held messaging.conversations.read are converted automatically. Select the wanted events in the webhook settings.
- 2026-10-13 · added
Conversation and message history reads, and the messaging.message.received.v1 webhook event with message and conversation identifiers.
- 2026-10-13 · changed
An active key without the operation grant receives 403 insufficient_scope with requiredScope instead of 401; GET /v1/developer/credential returns the key's project and scopes.
Treat 401 as a missing, rotated or revoked key only. On 403 with reason insufficient_scope, add requiredScope to the key in Project API settings; the key value does not change.
- 2026-10-13 · added
401 problems for an active key without the operation grant carry reason insufficient_scope and requiredScope.
- 2026-10-13 · added
Conversation source catalogs and exact idempotent text messages for ERP integration.
- 2026-08-14 · added
Quote-fenced Integration catalog, installation and lifecycle automation.
- 2026-08-12 · added
Integration discovery, operations, preparation and outbound-webhook workflows.