> Source: https://clickhouse.github.io/loom/es/reference/operations/webhook/ (Markdown: https://clickhouse.github.io/loom/es/reference/operations/webhook.md)

<!-- i18n: source=docs/reference/operations/webhook.md blob=8fe85868279336302f0f597903d202ca2dcf6179 model=claude-sonnet-5-5 -->
> Esta página es una traducción automática de la [página en inglés](https://clickhouse.github.io/loom/reference/operations/webhook/), que prevalece.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/webhook/), which is authoritative.

<a id="webhook-operations"></a>

# Operaciones de `webhook`

Los campos exactos que recibe y devuelve cada operación `webhook.*`.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

Cada op es `POST /v1/<op>` sobre HTTP y la herramienta MCP `loom_<op>`. Los campos de identidad (`org`, `namespace`, `agent`, `user_id`, `session_id`) se rellenan a partir del token y de la sesión MCP cuando el transporte puede hacerlo; en una llamada HTTP sin token en un servidor de un solo usuario, se usa la org de la instalación en todas las ops salvo `code.*` y `tracker.*` (que conservan la de su plano), y en [algunas ops](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) también su espacio de nombres y su agente; consulta [identidades y espacios de nombres](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md). El [índice de operaciones](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica el rol, el tipo y el listado `all` de MCP. Los campos de entrada desconocidos se atienden y se nombran en `ignored_args`.

<!-- prettier-ignore-start -->

<a id="webhookdeliveries"></a>

## `webhook.deliveries`

Los eventos de webhook del espacio de nombres de los últimos 3 días y su estado de entrega.

`POST /v1/webhook.deliveries` · MCP `loom_webhook_deliveries` · rol `admin` · idempotente · no figura en el listado `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `namespace` | `str` | obligatorio | El espacio de nombres que la op lee o escribe. |
| `webhook_id` | `str` | `''` | Solo los eventos de este webhook; "" = todos los webhooks del espacio de nombres. |
| `status` | `Literal['pending', 'delivered', 'dead'] \| None` | `None` | Solo los eventos en este estado; None = todos los estados. |
| `limit` | `int` | `100` | Como máximo esta cantidad de eventos, los más recientes primero, 1-500. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `deliveries` | `list[WebhookDelivery]` | Eventos, los más recientes primero. |

<a id="webhooklist"></a>

## `webhook.list`

Los webhooks de memoria del espacio de nombres.

`POST /v1/webhook.list` · MCP `loom_webhook_list` · rol `admin` · idempotente · no figura en el listado `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `namespace` | `str` | obligatorio | El espacio de nombres que la op lee o escribe. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `webhooks` | `list[WebhookInfo]` | Los registros activos del espacio de nombres, los más antiguos primero. |

<a id="webhookregister"></a>

## `webhook.register`

Registra una URL a la que se avisa cuando cambia la memoria del espacio de nombres.

`POST /v1/webhook.register` · MCP `loom_webhook_register` · rol `admin` · idempotente · auditada · no figura en el listado `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `namespace` | `str` | obligatorio | El espacio de nombres que la op lee o escribe. |
| `url` | `str` | obligatorio | Dónde se envían los eventos mediante POST: una URL https (http solo donde el despliegue lo permita) cuyo host se resuelva a direcciones públicas. |
| `secret_ref` | `str` | obligatorio | Nombre de la variable de entorno que contiene el secreto de firma (nunca el secreto): `LOOM_WEBHOOK_SECRET_<ORG>__<NAME>`, con ORG el id de la org en mayúsculas y cada byte distinto de a-z y 0-9 como `_` más dos dígitos hexadecimales. |
| `events` | `list[Literal['memory.written', 'memory.revised', 'memory.tombstoned', 'memory.restored', 'memory.redacted', 'memory.erased']]` | *(calculado)* | Los tipos de evento que se envían; por defecto, todos. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `webhook` | `WebhookInfo` | El registro tal como se almacenó. |

<a id="webhookremove"></a>

## `webhook.remove`

Elimina un webhook de memoria; tras la llamada no se envía ninguno de sus eventos, salvo un POST que ya esté en curso.

`POST /v1/webhook.remove` · MCP `loom_webhook_remove` · rol `admin` · idempotente · auditada · no figura en el listado `all` de MCP

| Campo de entrada | Tipo | Valor por defecto | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obligatorio | El tenant (primer elemento de la tupla de identidad). |
| `namespace` | `str` | obligatorio | El espacio de nombres que la op lee o escribe. |
| `webhook_id` | `str` | obligatorio | El webhook_id que devolvió webhook.register o webhook.list. |

| Campo de salida | Tipo | Significado |
| --- | --- | --- |
| `removed` | `bool` | False cuando el espacio de nombres no tiene ningún webhook activo con ese id. |

<!-- prettier-ignore-end -->
