Webhooks
Webhooks let you receive real-time notifications when events happen in your Platica account. Configure your own endpoint to receive events for conversations, messages, customers, and dynamic WhatsApp Flows.
Getting started
- Create a webhook with
POST /v1/webhooks. - Pick events from the list at
GET /v1/webhooks/events. - Validate the signature with the
secretconfigured on your webhook. - Process the
payloadbased on the event type received.
Consejo
Most events only notify that something happened. WhatsApp Flows events are special because your endpoint must respond with a JSON payload to keep the flow going. That difference is explained in WhatsApp Flows .
Available endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/webhooks | List every webhook |
GET | /v1/webhooks/{id} | Get a specific webhook |
POST | /v1/webhooks | Create a new webhook |
PATCH | /v1/webhooks/{id} | Update a webhook |
DELETE | /v1/webhooks/{id} | Delete a webhook |
GET | /v1/webhooks/events | List available events |
Further reading
| Page | When to use it |
|---|---|
| List events | See the 18 available events and their categories |
| Delivery and signatures | Validate authenticity and understand the headers / envelope of a regular webhook |
| Payloads | Review the structure of conversation.*, message.*, and client.* |
| WhatsApp Flows | Implement dynamic flows that require a response |