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

# Enviar eventos del espacio de trabajo con webhooks

> Envía una solicitud firmada a tus propios sistemas cuando ocurre algo en tu espacio de trabajo. Crea, activa, pausa y gestiona webhooks salientes en la configuración del espacio de trabajo.

Los webhooks salientes avisan a tus propios sistemas cuando algo cambia en tu espacio de trabajo. Cuando ocurre algo, como la publicación de una app o que el chat de IA termine una respuesta, Base44 envía una solicitud firmada a la URL que elijas. Así tus sistemas se mantienen actualizados sin tener que buscar cambios.

> [!WARNING]
>
> Necesitas un plan Enterprise (Business o Enterprise) para usar webhooks salientes, y solo los propietarios y administradores del espacio de trabajo pueden gestionarlos. Tus desarrolladores necesitan primero un receptor en la URL. Para aprender a crear uno, consulta la [descripción general de los webhooks salientes](https://docs.base44.com/developers/references/outbound-webhooks/get-started/overview.md).

![La pestaña Outgoing con 4 webhooks: 2 activos, 1 en pausa y 1 pendiente](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhooks-list.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=9db3c1b0c640a60be866ef912e96fca4)

Webhooks salientes en la página Webhooks

***

## Crear un webhook

Crea un webhook para cada URL que deba recibir eventos. Puedes crear hasta 10 por espacio de trabajo. Un webhook nuevo queda en **Pending** y no recibe nada hasta que lo activas. Después de crearlo, Base44 muestra la clave pública de firma de tu espacio de trabajo. Tu receptor la usa para confirmar que cada solicitud viene de Base44. Puedes compartir la clave con tus desarrolladores sin riesgo.

**Para crear un webhook:**

1. Haz clic en el nombre de tu espacio de trabajo en la parte inferior izquierda y haz clic en **Settings**.
2. Haz clic en **Webhooks** en la barra lateral y luego en la pestaña **Outgoing**.
3. Haz clic en **Create webhook**.
4. Introduce la **Endpoint URL**. Debe empezar por `https://`.
5. En **Events to send**, selecciona los eventos que debe recibir esta URL. Hay 2 tipos:
   * **Eventos de app:** Se crea, publica, desconecta, mueve a la papelera o restaura de la papelera una app de tu espacio de trabajo.
   * **Eventos del chat de IA:** El chat de IA del editor de apps empieza a trabajar en un mensaje (**Chat turn started**) o lo termina (**Chat turn ended**).
6. (Opcional) Introduce una **Description** para que tu equipo sepa para qué sirve el webhook.
7. Haz clic en **Create webhook**.

![El formulario Create webhook con una URL de endpoint, 3 eventos seleccionados y una descripción](https://mintcdn.com/base44/Cv0IQGEx6eX2LIU1/images/create-outgoing-webhook.png?fit=max\&auto=format\&n=Cv0IQGEx6eX2LIU1\&q=85\&s=d67e53d0c07a4791f5aab4869bbad414)

Crear un webhook

***

## Activar un webhook

Al activarlo, se envía un evento de prueba a tu URL. El webhook pasa a **Active** cuando tu receptor responde y devuelve el código del evento de prueba. Si la activación no se completa, Base44 te dice por qué. Por ejemplo, que tu endpoint no respondió a tiempo o no devolvió el código. Corrige el receptor y vuelve a activarlo.

**Para activar un webhook:**

1. Haz clic en el nombre de tu espacio de trabajo en la parte inferior izquierda y haz clic en **Settings**.
2. Haz clic en **Webhooks** en la barra lateral y luego en la pestaña **Outgoing**.
3. Haz clic en el icono **More actions**  junto al webhook y selecciona **Activate**.

![Un webhook saliente pendiente con su menú More actions abierto y Activate resaltado](https://mintcdn.com/base44/61xNA58oJUO_TLT3/images/outgoing-webhook-activate-menu.png?fit=max\&auto=format\&n=61xNA58oJUO_TLT3\&q=85\&s=bd0fe1030aa91e8178100c9dc8474dc7)

Activar un webhook pendiente

***

## Gestionar webhooks

Pausa un webhook mientras actualizas tu receptor, cambia lo que recibe o elimínalo. Si un webhook falla varios días seguidos, Base44 lo marca como **Auto-paused**. Cuando tu receptor vuelva a funcionar, reanúdalo. Base44 repite la prueba de activación antes de empezar a enviar.

**Para gestionar un webhook:**

1. Haz clic en el nombre de tu espacio de trabajo en la parte inferior izquierda y haz clic en **Settings**.
2. Haz clic en **Webhooks** en la barra lateral y luego en la pestaña **Outgoing**.
3. Haz clic en el icono **More actions**  junto al webhook y selecciona una opción:
   * **Send test event:** Envía un evento de prueba para comprobar tu receptor.
   * **Edit endpoint:** Cambia la URL, los eventos o la descripción. Si cambias la URL, los envíos se detienen hasta que actives la nueva URL.
   * **Pause deliveries** o **Resume deliveries:** Detiene o reanuda los envíos. Los eventos que ocurren mientras un webhook está en pausa no se envían más tarde.
   * **Delete endpoint:** Deja de enviar a la URL de inmediato.

> [!NOTE]
>
> Las suscripciones a los antiguos eventos `builder.turn_started.v1` y `builder.turn_ended.v1` ya no reciben eventos. Selecciona **Chat turn started** y **Chat turn ended** en su lugar.

![El menú More actions abierto en un webhook activo, con Send test event, Edit endpoint, Pause deliveries y Delete endpoint](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhook-actions-menu.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=93c4093385d7bf5870fa2618d5ea03fe)

Gestionar un webhook

***

## Gestionar la clave de firma

Cada solicitud se firma con la clave de tu espacio de trabajo. Al rotarla, se reemplaza por una nueva. Base44 firma con la clave antigua y la nueva durante 24 horas, así tu receptor sigue funcionando mientras tus desarrolladores añaden la nueva clave. Cuando terminen, haz clic en **Finish rotation** para dejar de usar la clave antigua antes.

> [!WARNING]
>
> **Revoke** hace que Base44 deje de firmar con una clave de inmediato. Los receptores que solo tienen esa clave rechazan todos los envíos hasta que reciban la nueva. Para un cambio rutinario, rota la clave en su lugar.

**Para rotar la clave de firma:**

1. Haz clic en el nombre de tu espacio de trabajo en la parte inferior izquierda y haz clic en **Settings**.
2. Haz clic en **Webhooks** en la barra lateral y luego en la pestaña **Outgoing**.
3. Haz clic en **See public keys**.
4. Haz clic en **Rotate key** y luego en **Rotate key** para confirmar.

![El cuadro Public signing keys durante una rotación, con la clave actual, la fecha de fin de la clave antigua y Finish rotation](https://mintcdn.com/base44/UhEyXj-zHgrdWw5u/images/outgoing-webhook-signing-keys.png?fit=max\&auto=format\&n=UhEyXj-zHgrdWw5u\&q=85\&s=8ede530dbaeb433e3fc2c19c1707030e)

Las claves de firma durante una rotación

***

## Preguntas frecuentes

Haz clic en una pregunta para obtener más información sobre los webhooks salientes.

> **¿Un webhook puede enviar eventos de una sola app?**
>
> No. Un webhook recibe los eventos que eliges para todas las apps de tu espacio de trabajo. Cada evento incluye la app a la que se refiere, así tu receptor puede ignorar las apps que no necesita.

> **¿Qué pasa si mi servidor no funciona?**
>
> Base44 sigue reintentando cada evento durante aproximadamente un día, y espera más tiempo entre cada intento. Si tu webhook sigue fallando durante varios días, Base44 lo pausa automáticamente. Cuando tu servidor vuelva a funcionar, reanuda el webhook desde su menú **More actions**.

> **¿Los webhooks usan créditos?**
>
> No. Enviar eventos a tus webhooks no usa créditos.

> **¿Cómo crean un receptor mis desarrolladores?**
>
> Comparte con ellos la [guía para desarrolladores de webhooks salientes](https://docs.base44.com/developers/references/outbound-webhooks/get-started/overview.md). Cubre los [tipos de eventos](https://docs.base44.com/developers/references/outbound-webhooks/get-started/event-types.md), la [verificación de solicitudes](https://docs.base44.com/developers/references/outbound-webhooks/get-started/verifying-requests.md) y la [entrega y los reintentos](https://docs.base44.com/developers/references/outbound-webhooks/get-started/delivery-and-retries.md).

> [!NOTE]
>
> Esta página fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](https://docs.base44.com/index.md).


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