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",
"message.created",
"client.created"
],
"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 | ✓ |
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) | — |
Respuesta
{
"status": "success",
"message": "Webhook creado exitosamente",
"data": {
"id": "webhook_abc123",
"workspaceId": "ws_456"
}
}