Webhooks

Webhooks

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

Setting Up Webhooks

1. Go to your project settings in my.plugy.me
2. Navigate to Settings > Webhooks
3. Enter your webhook endpoint URL
4. Select the events you want to receive
5. 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.