Crear Webhook | Nebrija AI | Documentation v15.0

Registra un nuevo endpoint para recibir eventos. Al crear el webhook se genera automáticamente un secreto de firma HMAC (whsec_...). Los eventos disponibles son: call.started, call.finished, call.failed.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

urlstringRequiredformat: "uri"

URL pública que recibirá los eventos.

eventslist of stringsRequired

Eventos a escuchar. Ejemplo: call.started, call.finished, call.failed

descriptionstringOptional

Response

Webhook creado (incluye el secreto de firma).

idstringformat: "uuid"

urlstring

eventslist of strings

Ejemplo: call.finished, call.started

descriptionstring

secretstring

Secreto de firma HMAC (formato: whsec_…). Solo visible en la creación.

createdAtdatetime

1	import requests
2
3	url = "https://nebrijaai.com/api/v1/webhooks"
4
5	payload = {
6	"url": "https://myapp.com/webhooks/call-events",
7	"events": ["call.started", "call.finished"]
8	}
9	headers = {
10	"Authorization": "Bearer <token>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())

1	{
2	"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3	"url": "https://myapp.com/webhooks/call-events",
4	"events": [
5	"call.started",
6	"call.finished"
7	],
8	"description": "Webhook para eventos de llamadas",
9	"secret": "whsec_9f8b7c6d5e4a3b2c1d0e9f8a7b6c5d4e",
10	"createdAt": "2024-01-15T09:30:00Z"
11	}