Webhooks

Receive real-time notifications when events happen in your Plugy projects.

Setting Up Webhooks

Go to your project settings in my.plugy.me
Navigate to Settings > Webhooks
Enter your webhook endpoint URL
Select the events you want to receive
Click Save

Available Events

Event	Description
`conversation.created`	A new conversation was started
`conversation.resolved`	A conversation was marked as resolved
`message.received`	A new customer message was received
`message.sent`	A bot response was sent
`escalation.triggered`	A conversation was escalated to a human operator
`onda.iteration.completed`	A self-learning iteration finished

Webhook Payload

All webhook payloads follow this structure:

{
  "event": "message.received",
  "project_id": "my-company",
  "timestamp": "2025-03-20T14:00:00Z",
  "data": {
    // Event-specific data
  }
}

Security

All webhook requests include an HMAC-SHA256 signature in the X-Plugy-Signature header. Verify this signature using your webhook secret to ensure the request came from Plugy.

X-Plugy-Signature: sha256=<hmac-hex-digest>

Retry Policy

If your endpoint returns a non-2xx status code, Plugy retries the webhook up to 3 times with exponential backoff.