Crear un Webhook
Crea un nuevo webhook para recibir notificaciones de eventos en tiempo real.
POST https://api.platica.mx/v1/webhooksCuerpo de la solicitud
{
"name": "Webhook de Notificaciones",
"url": "https://mi-app.com/webhook",
"events": [
"conversation.created",
"conversation.status.updated",
"message.created",
"client.created",
"client.customFields.updated"
],
"active": true,
"secret": "mi_secreto_seguro",
"headers": {
"Authorization": "Bearer token123",
"Custom-Header": "valor personalizado"
}
}Parámetros del cuerpo
| Parámetro | Tipo | Descripción | Requerido |
|---|---|---|---|
name | string | Nombre descriptivo del webhook (máx. 100 caracteres) | ✓ |
url | string | URL donde se enviarán las notificaciones (máx. 500 caracteres) | ✓ |
events | array | Lista de eventos a los que suscribirse — ver eventos disponibles | ✓ |
active | boolean | Estado del webhook | — |
secret | string | Secreto para validar la autenticidad (máx. 255 caracteres) | — |
headers | object | Headers personalizados para incluir en las peticiones (máx. 10) | — |
Consejo
Puedes mezclar eventos de conversaciones, mensajes, clientes y WhatsApp Flows en el mismo webhook. Si usas whatsapp.flows.*, tu endpoint debe responder con un JSON en menos de 700 ms — ver WhatsApp Flows .
Respuesta
{
"status": "success",
"message": "Webhook creado exitosamente",
"data": {
"id": "webhook_abc123",
"workspaceId": "ws_456"
}
}