API: API Чатвы
Справочник
API Чатвы
Обновлено 7 сентября 2026 г.
API отдаёт всё, что нужно для интеграций со своими системами: диалоги, сообщения, контакты и события вебхуков. Формат — JSON поверх HTTPS, авторизация по ключу в заголовке.
Что можно сделать с API
| Сценарий | Какие методы |
|---|---|
| Синхронизация с CRM (amoCRM, Битрикс24, 1С) | GET /conversations, POST /webhooks |
| Автосообщения клиентам из своей логики | POST /messages |
| Выгрузка базы контактов в рассылку или BI | GET /contacts |
| Уведомления в Slack, Telegram или трекер задач | POST /webhooks: события message:new и conversation:* |
| Резервные копии переписки по расписанию | GET /conversations + GET /conversations/{id} |
Базовый URL и формат
Базовый URL
https://api.chatva.app/v1- Все запросы и ответы — JSON в UTF-8.
- Время — ISO 8601 в UTC: 2026-09-07T12:00:00Z.
- Идентификаторы — строки с префиксами: cv_ (диалог), m_ (сообщение), ct_ (контакт), wh_ (вебхук).
- Пагинация курсорная: параметры limit и cursor, в ответе — nextCursor.
Быстрый пример
curl
curl https://api.chatva.app/v1/conversations?status=new \
-H "Authorization: Bearer ch_live_9f3ka2"