Webhooks

Receive real-time notifications when events happen in your Cevvo project.

Overview

Webhooks let you subscribe to events in your Cevvo project. When an event occurs, Cevvo sends an HTTP POST request to your configured endpoint with a JSON payload describing the event. This enables you to build integrations like logging conversations to a CRM, triggering alerts for unanswered questions, or syncing analytics to external tools.

Available Events

conversation.created

A new conversation thread was started.

conversation.message

A new message was sent or received in a conversation.

conversation.resolved

A conversation was marked as resolved.

source.synced

A source completed syncing and the knowledge base was updated.

source.error

A source sync failed due to an error.

ingestion.completed

A document ingestion job completed successfully.

ingestion.failed

A document ingestion job failed.

Payload Example

{
  "event": "conversation.message",
  "timestamp": "2026-03-14T10:30:00Z",
  "data": {
    "thread_id": "thr_xyz789",
    "message": {
      "role": "user",
      "content": "How do I reset my password?",
      "created_at": "2026-03-14T10:30:00Z"
    }
  }
}

Security

Each webhook request includes an X-Cevvo-Signature header containing an HMAC-SHA256 signature. Verify this signature using your webhook secret to ensure requests are authentic. Cevvo retries failed deliveries up to 3 times with exponential backoff.