Skip to main content

Webhooks

Set up webhooks to receive real-time events from your chatbot.​

FAQ and troubleshooting​

Why am I not receiving webhook deliveries?​

Verify the endpoint URL is public HTTPS, returns 2xx quickly, and that your server allows ChatMaven’s IP ranges or signing secret validation as documented. Check for typos in the URL and that the webhook is enabled in the product.

How do I debug signature or payload issues?​

Log the raw body and headers for a failing request. Compare the signature algorithm and secret to the guide; ensure you hash the raw body, not a re-serialized JSON object.

Can I retry failed events?​

Implement idempotent handlers: use event IDs or message IDs to deduplicate. ChatMaven may retry on transient failures; your endpoint should tolerate duplicate deliveries.