Webhooks
Un webhook envía un mensaje a una dirección web de tu elección en el momento en que algo pasa en tu tienda: se hace un pedido, un pago se completa, se hace una reserva. Es la forma de conectar PersonaCart con Zapier, Make, n8n, tu propio servidor o cualquier herramienta que pueda recibir una solicitud web.
Dónde encontrarlo
Barra lateral → AJUSTES → Herramientas para desarrolladores → Webhooks. La página tiene Endpoints (las direcciones a las que enviamos y cómo le va a cada una) y Seguridad (cómo tu servidor comprueba que una solicitud es auténtica).

Agrega un endpoint
- Pulsa Nuevo endpoint.
- Escribe la URL. Debe empezar con https. No se aceptan direcciones que apunten a localhost o a una red privada.
- Agrega una descripción para recordar para qué sirve.
- Elige los eventos que debe recibir. Debes elegir al menos uno.
- Pulsa Crear endpoint. Aparece un secreto de firma una sola vez. Cópialo y guárdalo en un lugar seguro; no se vuelve a mostrar.
Pulsa Enviar prueba en un endpoint para enviar un evento de ejemplo ahora mismo y ver que tu servidor lo recibe.
Qué eventos puedes enviar
Los eventos se agrupan según lo que pasó. Ejemplos:
| Área | Eventos |
|---|---|
| Pedidos | creado, actualizado, completado, preparado, entregado, cancelado, reembolsado, disputado |
| Pagos | exitoso, fallido, reembolsado |
| Reservas | creada, confirmada, actualizada, reprogramada, cancelada, completada, inasistencia |
| Clientes y prospectos | cliente creado o actualizado, prospecto creado o convertido, formulario de contacto enviado, suscripción al boletín |
| Pago | iniciado, completado, abandonado |
| Suscripciones | creada, renovada, pago fallido, cancelada |
| Productos | creado, actualizado, eliminado, poco inventario, baja de precio |
| Cursos | inscripción creada, lección completada, curso completado, certificado emitido |
| Otros | facturas, reseñas, tickets de soporte, cambios en la lista de deseos, campañas |
El formulario del endpoint muestra la lista exacta para tu tienda. En el plan Starter se envían los eventos de pedidos, pagos, reservas, clientes y prospectos. Los demás eventos se guardan en el endpoint, marcados como Pro, y empiezan a enviarse cuando mejoras el plan, sin tener que configurar de nuevo (consulta Planes, límites y qué incluye cada uno).
Comprueba que una solicitud realmente viene de nosotros
Cualquiera puede enviar una solicitud a tu URL, así que compruébalo antes de actuar. Cada webhook va firmado con el secreto de firma de ese endpoint, usando el método Standard Webhooks:
- Comprueba la firma. Los encabezados
webhook-id,webhook-timestampywebhook-signaturela llevan. Una biblioteca de Standard Webhooks hace la comprobación por ti cuando le das tu secreto. Si la firma no coincide, ignora la solicitud. - Rechaza las solicitudes antiguas. Se rechaza todo lo que tenga más de 5 minutos, para que una solicitud copiada no se pueda repetir después.
- Procesa cada evento una sola vez. Podemos enviar el mismo evento otra vez (un reintento). Guarda cada
webhook-idy omite los que ya viste. - ¿Usas Zapier, Make o n8n? Agrega un encabezado extra (nombre y valor) cuando edites el endpoint. Se envía con cada webhook y el valor se guarda cifrado y nunca se vuelve a mostrar.
No publicamos direcciones IP de envío fijas, así que no confíes en una lista de IP permitidas. Comprueba la firma.
Rota el secreto de firma
Pulsa Rotar secreto para obtener uno nuevo. Tú eliges cuándo deja de funcionar el anterior: en 24 horas, en 1 hora o ahora mismo (úsalo si se filtró). Eso te da tiempo para actualizar tu servidor.
Mira el registro de entregas
Abre Ver entregas en un endpoint para ver cada intento: hora, evento, estado (exitoso, fallido, pendiente, reintentando), respuesta y duración. Filtra por estado, evento o fecha. Reintentar vuelve a enviar una entrega fallida, y Reintentar todos los fallidos pone en cola todos los fallidos. El registro se conserva 3 días en Starter, 7 en Pro y 30 en Scale.
Cada endpoint muestra el número de enviados, entregados y fallidos, una tasa de éxito y una etiqueta de salud.
Pausar, reanudar y endpoints que fallan
- Pausar deja de enviar a un endpoint sin borrarlo. Reanudar vuelve a empezar.
- Si un endpoint sigue fallando, o su servidor responde que la dirección ya no existe (HTTP 410), dejamos de enviar y lo marcamos como Desactivado — con fallos. Arregla la URL o tu servidor y pulsa Reactivar. Los eventos de las últimas 72 horas se vuelven a enviar.
- Si tu plan permite menos endpoints de los que tienes, los más nuevos muestran Pausado por el plan. No se borra nada. Mejora el plan o quita otro endpoint y vuelven a enviar.
Bueno saber
Eliminar un endpoint detiene todas las entregas hacia él y no se puede deshacer. Los webhooks también envían los datos de tu tienda a otro servicio, así que agrega solo direcciones que controles o en las que confíes.
Las herramientas de IA solo pueden configurar un webhook nuevo con tu aprobación. Consulta Conectar IA.
Preguntas
¿Los webhooks necesitan una clave de API?
No. Los enviamos a tu servidor, y cada endpoint tiene su propio secreto de firma. Las claves de API son solo para herramientas de IA y scripts que se conectan a PersonaCart.
¿Cuántos endpoints puedo agregar?
No hay un tope en los planes de pago. Tu plan define qué eventos se envían y cuánto tiempo se conserva el registro de entregas.
Perdí mi secreto de firma.
Se muestra una sola vez. Usa Rotar secreto para obtener uno nuevo.
¿Por qué mi endpoint dice Desactivado?
Siguió fallando, así que dejamos de enviar. Arregla tu servidor o la URL y pulsa Reactivar; los eventos de las últimas 72 horas se vuelven a enviar.