Back to Help Center
🔗
Developer 5 min read

Setting Up Webhooks

Receive real-time event notifications when customers message your bot or a conversation is escalated.

Webhooks

Webhooks let ViViDlyPro send real-time event data to your own systems — CRM, ticketing tools, analytics platforms, or custom apps.

Supported Events

  • message.received — A customer sent a message
  • message.sent — The bot sent a reply
  • conversation.escalated — Bot handed over to a human agent
  • conversation.resolved — Conversation marked as resolved
  • conversation.new — A brand-new customer contacted you
  • payment.completed — A customer accepted a payment request (if using payment links)

Adding a Webhook

  1. Go to Settings → Developer → Webhooks.
  2. Click Add Endpoint.
  3. Enter your server's HTTPS URL (must be HTTPS, not HTTP).
  4. Select which events to subscribe to.
  5. Click Save and Test — ViViDlyPro sends a test ping to verify your URL is reachable.

Webhook Payload Format

Each event sends a JSON POST to your URL:

{
  "event": "message.received",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "conversationId": "abc123",
    "customerId": "91888...",
    "channel": "whatsapp",
    "message": "What are your working hours?"
  }
}

Verifying Webhook Signatures

Every webhook includes an X-VividlyPro-Signature header containing a HMAC-SHA256 signature. Verify this in your server to confirm the payload came from ViViDlyPro.

Retries

If your server returns a non-200 status, ViViDlyPro retries up to 5 times with exponential backoff (5s, 25s, 125s, 625s, 3125s).