API: Chatva API
Getting started
Reference
Chatva API
Updated September 7, 2026
The API exposes everything needed to integrate with your own systems: conversations, messages, contacts and webhook events. Format is JSON over HTTPS with key-based authorization.
What you can build
| Scenario | Methods |
|---|---|
| CRM sync (amoCRM, Bitrix24, 1C) | GET /conversations, POST /webhooks |
| Automated client messages from your logic | POST /messages |
| Contact base export to mailing or BI | GET /contacts |
| Notifications to Slack, Telegram or a tracker | POST /webhooks: message:new and conversation:* events |
| Scheduled conversation backups | GET /conversations + GET /conversations/{id} |
Base URL and format
Base URL
https://api.chatva.app/v1- All requests and responses are JSON in UTF-8.
- Time is ISO 8601 in UTC: 2026-09-07T12:00:00Z.
- IDs are prefixed strings: cv_ (conversation), m_ (message), ct_ (contact), wh_ (webhook).
- Cursor pagination: limit and cursor parameters, nextCursor in the response.
Quick example
curl
curl https://api.chatva.app/v1/conversations?status=new \
-H "Authorization: Bearer ch_live_9f3ka2"