Custom REST APIs
Build custom integrations with Chatevo’s REST API — manage assistants, send messages via Direct API deployments, sync knowledge, and automate tools without the dashboard UI.
Authentication
Section titled “Authentication”| Method | Use |
|---|---|
| API key | Server-to-server scripts and backends |
| OAuth | Partner apps acting on behalf of users |
See API authentication. Never ship org API keys in browser or mobile clients — proxy through your backend.
Common integration patterns
Section titled “Common integration patterns”| Pattern | APIs |
|---|---|
| Embedded chat backend | Messages, Conversations |
| CMS sync | Knowledge bases, import URLs |
| Tool lifecycle | Tools API — CRUD, test, logs |
| Real-time events | Outbound webhooks |
Direct API vs Management API
Section titled “Direct API vs Management API”| Direct API deployment | Management API |
|---|---|
| End-user chat with one assistant | Org admin: create assistants, KBs, tools |
| Deployment-scoped keys | Organization API keys |
Tools from your integration
Section titled “Tools from your integration”Your app can trigger the same tool execution path as the widget:
- Message arrives via Direct API.
- Assistant selects tool; Chatevo calls your HTTP API with credentials.
- Response returns to your client (text + optional rich content).
SDK resources
Section titled “SDK resources”- OpenAPI spec
- curl examples
- Postman collection
- Embed JavaScript for widget customization
Rate limits
Section titled “Rate limits”Respect deployment and API rate limits — implement backoff on 429.