Inbound webhooks
Inbound webhooks give external systems a secure URL to push events into Chatevo — trigger assistant workflows, update conversation context, or kick off automations from your backend.
Configure
Section titled “Configure”- Integrations → Webhooks → Inbound → Create.
- Name the endpoint and select target assistant or deployment.
- Copy the token URL — includes a secret path segment.
- Document payload format for your sending system.
Calling the URL
Section titled “Calling the URL”| Requirement | Detail |
|---|---|
| Method | POST (unless documented otherwise) |
| Auth | Secret token in URL path or Authorization header |
| Body | JSON per integration schema |
Treat the URL like a password — rotate if leaked.
Example use cases
Section titled “Example use cases”| Sender | Action |
|---|---|
| Order management system | Notify chat when shipment ships |
| Form builder | Start conversation with lead context |
| Internal admin | Broadcast maintenance notice to active sessions |
Security
Section titled “Security”- Use HTTPS senders only.
- Restrict source IPs on your firewall if possible.
- Do not embed inbound URLs in public client apps.
For events out of Chatevo, use Outbound webhooks with HMAC verification.
Testing
Section titled “Testing”- Send sample POST with curl or Postman.
- Confirm event appears in audit feed or assistant logs.
- Verify assistant behavior in test deployment.