Administrar webhooks desde el panel
La sección Webhooks (/webhooks) te deja dar de alta suscripciones, revisarlas y consultar el historial de entregas de eventos hacia tus sistemas externos.
Si tu equipo de desarrollo necesita el catálogo completo de eventos, la forma exacta del payload y cómo verificar la firma de cada entrega, consulta Integrar webhooks, dentro de la sección Documentación técnica — esta guía es sobre el panel, no sobre el contrato técnico.
Paso 1: entra a Webhooks
En el menú lateral, dentro del grupo Integraciones, entra a Webhooks.
Paso 2: revisa el panel general
Arriba de la pantalla vas a ver cuatro indicadores (KPIs):
- Suscripciones — el total de suscripciones registradas.
- Activas — cuántas de esas suscripciones están activas.
- Entregas — el total de entregas de eventos registradas.
- Entregas fallidas — cuántas de esas entregas fallaron (y siguen reintentándose automáticamente, ver más abajo).
Paso 3: crea una suscripción
En Nueva suscripción, indica:
- Comercio — a qué comercio pertenece esta suscripción (solo recibirá eventos de ese comercio).
- URL del endpoint — a dónde se envía cada evento (debe ser
https://en producción). - Secreto — una cadena que solo tú y la plataforma conocen, usada para firmar cada entrega. Guárdalo en un lugar seguro: no se puede volver a consultar después de crear la suscripción.
- Eventos — qué tipos de evento quieres recibir. Si no marcas ninguno, recibes todos los eventos disponibles (ver el catálogo completo en Integrar webhooks).
Paso 4: consulta y administra las suscripciones
La tabla de Suscripciones lista cada webhook configurado, con:
| Columna | Qué es |
|---|---|
| Subscription ID | El identificador único de la suscripción. |
| Comercio | El comercio al que está asociada. |
| Endpoint | La URL a la que se envían los eventos. |
| Eventos | Los tipos de evento suscritos, o "Todos". |
| Estado | Activa o Inactiva. |
| Creada | La fecha en que se dio de alta. |
| Acciones | Botones para activar/desactivar o eliminar. |
Puedes filtrar esta tabla por comercio. Desactivar una suscripción detiene las entregas nuevas sin perder el historial; eliminarla es permanente.
Paso 5: consulta las entregas
La tabla de Entregas lista cada intento de envío de un evento, con:
| Columna | Qué es |
|---|---|
| Delivery ID | El identificador único de la entrega. |
| Subscription | La suscripción a la que pertenece. |
| Evento | El tipo de evento que se envió. |
| Estado | Pendiente, en despacho, entregado, o fallido (con el motivo del último error, si falló). |
Puedes filtrar esta tabla por ID de suscripción y por estado.
Una entrega fallida (por ejemplo, tu endpoint no respondió o devolvió un error) se reintenta automáticamente con espera creciente (1, 2, 4... minutos, hasta un máximo de 2 horas entre intentos) durante varias horas antes de darse por vencida. No necesitas reintentarla manualmente.
Qué sigue
- Integrar webhooks — catálogo de eventos, forma del payload, y cómo verificar la firma (sección Documentación técnica).
- Notificaciones por correo
- Consultar exportaciones