> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Suscripciones webhook firmadas

> Registra un receptor HTTPS dedicado a eventos de llamadas, conversaciones y reservas.

Registra un receptor HTTPS dedicado a eventos de llamadas, conversaciones y reservas.

Un propietario o administrador del espacio puede registrar receptores con Settings: Write y el permiso de lectura de cada evento elegido: Calls: Read o Bookings: Read. Se requiere API Access. Los secretos de firma permanecen en el receptor y nunca se devuelven al crear, listar o consultar una suscripción.

## Eventos compatibles

* `call.completed`
* `conversation.ended`
* `booking.created`
* `booking.cancelled`
* `booking.rescheduled`

Utiliza un secreto de firma fuerte de 16–256 caracteres en la aplicación receptora. Famulor firma los bytes JSON exactos con HMAC-SHA256 en X-Famulor-Signature. Verifica la firma antes de procesarlos. Puede haber entregas duplicadas o repetidas; deduplica mediante el evento y el identificador del recurso.

## n8n

Los nuevos nodos Famulor Trigger del paquete 2.3.0 utilizan el registro automático. Añade la clave API del espacio y tu secreto en Famulor Webhook API, selecciona un evento y activa el flujo. Al desactivarlo solo se elimina la suscripción de ese nodo. Los nodos guardados de versión 2/3 siguen siendo manuales hasta elegir Automatic Subscription. Los destinos existentes no cambian.

## API, MCP, CLI y SDK

| REST | MCP | CLI |
| - | - | - |
| `GET /api/v1/webhooks` | `list_webhook_subscriptions` | `famulor list-webhook-subscriptions` |
| `POST /api/v1/webhooks` | `create_webhook_subscription` | `famulor create-webhook-subscription` |
| `GET /api/v1/webhooks/{id}` | `get_webhook_subscription` | `famulor get-webhook-subscription --id <subscription-id>` |
| `DELETE /api/v1/webhooks/{id}` | `delete_webhook_subscription` | `famulor delete-webhook-subscription --id <subscription-id>` |

```bash theme={null}
famulor create-webhook-subscription --url 'https://receiver.example.com/events' --events '["call.completed"]' --secret '<signing-secret-from-your-receiver>'
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

async function subscribe(workspaceApiKey: string, callbackUrl: string, signingSecret: string) {
const client = new Famulor({ apiKey: workspaceApiKey });
const subscription = await client.api.createWebhookSubscription({
  body: { url: callbackUrl, events: ['call.completed'], secret: signingSecret },
});
await client.api.deleteWebhookSubscription({ path: { id: subscription.data.id } });
}
```

Un UUID de suscripción fijo y opcional permite repetir con seguridad un registro cuyo resultado es incierto con los mismos ajustes. Otros ajustes con el mismo identificador devuelven 409. Eliminar una suscripción ya ausente devuelve deleted: false.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.