---
title: "Envía datos a tus sistemas con webhooks"
description: "Recibe una solicitud en tu propia URL cuando alguien se registra, participa o gana, con un payload firmado, autenticación básica, un payload personalizado y un registro de cada entrega."
url: https://scratcher.io/es-419/help/developers/webhooks
language: es-419
---

1. [Centro de ayuda](https://scratcher.io/es-419/help)
2. [API, webhooks y MCP](https://scratcher.io/es-419/help/developers)
3. Envía datos a tus sistemas con webhooks

# Envía datos a tus sistemas con webhooks

Recibe una solicitud en tu propia URL cuando alguien se registra, participa o gana, con un payload firmado, autenticación básica, un payload personalizado y un registro de cada entrega.

Un webhook envía datos a la URL que elijas en el momento en que ocurre algo, por ejemplo, cuando alguien participa en una campaña o gana un premio. Tu desarrollador configura el sistema que los recibe.

Los webhooks forman parte de los planes que incluyen **Webhooks & API** (Basic y superiores).

## ¿Webhooks de campaña o webhooks de cuenta?

- Los **webhooks de campaña** se configuran en el editor de campañas y se activan solo para esa campaña. Tienen los eventos "Every time a lead participates in a campaign" y "When a lead wins a prize", y ofrecen la mayor cantidad de opciones.
- Los **webhooks de cuenta** se configuran en **Settings** > **Webhooks**. Tienen el evento "When a new lead is created": se activa una vez por persona, la primera vez que se agrega a tus leads, sin importar de qué campaña provenga.

## Agregar un webhook a una campaña

1. Abre la campaña en el editor y ve a **Connect** > **Webhooks**.
2. Haz clic en **Add webhook**.
3. Ingresa la **Payload URL**. Debe comenzar con https: "We only support webhooks over HTTPS to ensure that the data sent remains secure."
4. Elige el **Content type**: **application/json** o **application/x-www-form-urlencoded**.
5. Elige el **Method**. El formulario comienza en **GET**, que envía los datos en la URL. Elige **POST** para enviarlos en el cuerpo, que es lo que espera la mayoría de los sistemas.
6. En **Authentication** (solo para POST), elige **Basic Auth** si tu URL requiere usuario y contraseña, y completa **Username** y **Password**. De lo contrario, deja **None**.
7. Ingresa un **Secret** para firmar las solicitudes (recomendado). Consulta "Verificar la firma" más abajo.
8. Activa **Log response body** si quieres ver lo que responde tu sistema. "Enable to store the response body for debugging."
9. Mantén **Active** activado. "We will only deliver events if the webhook is active."
10. Elige el evento: "Every time a lead participates in a campaign" o "When a lead wins a prize".
11. Activa **Custom payload** si quieres definir los campos tú mismo (consulta más abajo).
12. Haz clic en **Add webhook**. Verás "Webhook added".

El panel **Webhooks** muestra los webhooks de la campaña con el estado **Active** o **Inactive**, y **Last delivery failed** si la última solicitud falló. Usa **Actions** para **Edit**, **See deliveries** o **Delete** un webhook. Al editar un webhook, deja **Secret** en blanco para conservar el que ya tienes.

## Agregar un webhook de cuenta

1. Ve a **Settings** > **Webhooks** (en **Developers**). Tus webhooks aparecen en **My webhooks** (o bajo el nombre de cada lista de leads, si tienes varias).
2. Haz clic en la tarjeta con el signo más para agregar un webhook. El cuadro de diálogo **Add webhook** dice "Send a request to an external URL whenever selected events happen."
3. Completa **Payload URL**, **Content type** ("Select content type of the webhook"), **Method** y **Secret** como se indicó arriba.
4. En **Which events should trigger the webhook?**, elige "When a new lead is created".
5. Marca "Yes, allow me to specify a customized payload (Advanced users only)" si quieres usar tus propios campos.
6. Marca **Log response body** ("This webhook will log the response body") si lo necesitas, y mantén **Active** marcado ("We will deliver event details when this hook is triggered").
7. Haz clic en **Add webhook**.

Haz clic en un webhook para modificarlo (**Save changes**), definir un **New secret**, abrir **Show deliveries** o usar **Delete webhook** ("This action cannot be reverted!").

## Qué se envía

De forma predeterminada, el cuerpo incluye un `event` (el nombre del evento: `lead_created_on_campaign`, `new_campaign_winner` o `lead_created`) y un objeto `data`:

- `campaign`: el `id` y el `name` de la campaña (webhooks de campaña)
- `lead`: los campos del formulario del lead según su clave de campo (por ejemplo, `first_name`), además de `id`, `phone_number` y `created_at`
- `lead.permissions`: para cada casilla de consentimiento, si fue aceptada, el texto, la fecha y la dirección IP (webhooks de campaña)
- `participant`: el `channel` del que provino la persona y cuándo participó (webhooks de campaña)
- `quiz`: las respuestas a las preguntas del quiz con nombre, también con nombres legibles que empiezan con "Simple"
- `prize`: el `id`, `name`, `value`, `coupon_code` del premio y cuándo se ganó (webhooks de ganadores)

Los valores vacíos se omiten, al igual que los consentimientos no aceptados. Con el método GET, los mismos datos se envían como parámetros de consulta en la URL.

## Payload personalizado

Con **Custom payload** activado, solo se envían los campos que elijas y no hay envoltorio `event`.

1. En **Data mapping**, haz clic en **Add mapping**.
2. Escribe el **Field name** que espera tu sistema. Usa letras, números, guiones y guiones bajos.
3. Elige el campo de Scratcher que quieres enviar ("Group → Field"), o **Custom value** y escribe un **Value** fijo.
4. Repite para cada campo. Elimina uno con el ícono de papelera (**Remove** o **Remove data mapping**).

## Verificar la firma

Si defines un secreto, cada solicitud incluye un encabezado `X-Hub-Signature`: `sha1=` seguido de un hash HMAC-SHA1 del payload codificado en JSON (el cuerpo descrito arriba), usando tu secreto como clave. Calcula lo mismo de tu lado y compáralo para asegurarte de que la solicitud provino de Scratcher.

## Entregas y reintentos

- Si tu URL no responde o devuelve un error (estado 400 o superior), Scratcher lo vuelve a intentar dos veces: a los 5 segundos y al minuto.
- Las redirecciones no se siguen, así que usa la URL final.
- Abre las entregas (**See deliveries** en la campaña, **Show deliveries** en los webhooks de cuenta) para ver cada solicitud y respuesta. Cada entrega muestra su **ID**, la **Request** y la **Response** con su código de estado (y el **Response body** si lo registras). Usa **copy** para copiar un payload.
- Activa **Show only failed deliveries** para ver solo los problemas. En la parte superior se muestra "Failed deliveries in the last 60 days".
- Haz clic en **Retry** para volver a enviar una entrega: "The webhook is being resent."
- "Webhook delivery logs are retained for 60 days."

## Solución de problemas

- "The ... field must use HTTPS.": la **Payload URL** comienza con http. Usa https.
- Todas las entregas fallan sin respuesta: la URL no es accesible desde internet, por ejemplo, una dirección local o interna. Usa una URL pública.
- Tu sistema no recibe datos: el método es **GET**, así que los datos están en la URL. Cambia a **POST**.
- Falta un campo que tu sistema espera: estaba vacío o el consentimiento no fue aceptado. Configura tu sistema para que trate los campos faltantes como vacíos.

API, webhooks y MCP

- [Primeros pasos con la API REST](https://scratcher.io/es-419/help/developers/rest-api)
- [Envía datos a tus sistemas con webhooks](https://scratcher.io/es-419/help/developers/webhooks)
- [Scratcher MCP para tus propias herramientas de IA](https://scratcher.io/es-419/help/developers/mcp)

Sigue aprendiendo

## Artículos relacionados

- [Primeros pasos con la API REST](https://scratcher.io/es-419/help/developers/rest-api): Crea un token de acceso personal con los permisos adecuados o registra una app OAuth, y consulta campañas, leads y listas desde tus propios sistemas.
- [Revisa el estado de envío y reenvía leads](https://scratcher.io/es-419/help/integrations/delivery-status): Consulta qué leads se enviaron a tus herramientas, entiende los mensajes de error, soluciona el problema y vuelve a enviarlos.
- [Conecta más de 8.000 apps con Zapier](https://scratcher.io/es-419/help/integrations/zapier): Envía los nuevos registros de Scratcher a Google Sheets, Slack, tu CRM o miles de otras apps con Zapier.

¿Necesitas ayuda?

## ¿Sigues necesitando ayuda?

Hay personas reales para ayudarte. Si ya usas Scratcher, lo más rápido es el chat dentro de la plataforma.

- **[Chatea con nosotros](https://platform.scratcher.io/es-419/login)**

    Inicia sesión y haz clic en el botón del chat, abajo a la derecha. Rex responde al instante y nuestro equipo está a un clic.
- **[Agenda una reunión](https://scratcher.io/es-419/book-a-meeting)**

    Una videollamada gratuita de 30 minutos con nuestro equipo: una demostración, ideas para campañas o ayuda con tu configuración.
- **[Escríbenos](mailto:contact@scratcher.io)**

    Escribe a contact@scratcher.io y te responderemos.
