Qué hace un webhook
Un webhook envía los detalles de un evento de tu tienda a otro lugar en el momento en que ocurre. Tú eliges el evento y adónde va:
- API: Storeep envía los datos del evento a una dirección web (URL) de tu servidor, tu CRM, un escenario de Zapier o Make, o una herramienta de seguimiento de anuncios.
- Correo electrónico: Storeep envía los datos del evento a una dirección de correo, por ejemplo para recibir un correo por cada nuevo pedido.
Abre Ajustes > Webhooks. Necesitas el permiso de Ajustes.
Muchas herramientas ya tienen una aplicación lista para usar, lo que es más fácil: Google Sheets, redes de mensajería y píxeles de anuncios. Consulta primero la tienda de aplicaciones.
Crear un webhook
Haz clic en Añadir nuevo webhook, rellena el formulario y haz clic en Añadir.
- Activar: marcado por defecto. Cuando está marcado, los eventos se envían al instante. Desmárcalo para conservar el webhook pero pausarlo.
- Nombre: una etiqueta para tu lista, por ejemplo "Nuevos pedidos al CRM".
- Tipo: API o Correo electrónico.
- Evento:
- Pedido creado: un cliente hace un nuevo pedido.
- Pedido actualizado: cambian el estado o los detalles de un pedido.
- Sesión creada: un nuevo visitante llega a tu tienda. Solo para el tipo API.
- Formato: Json.
- URL (tipo API): la dirección a la que enviar. La parte
https://se añade por ti, así que escribe el resto, comoapi.example.com/orders. - Dirección de correo electrónico (tipo Correo electrónico): adónde va el correo.
Un webhook de tipo Correo electrónico solo envía eventos de pedidos. Si eliges Correo electrónico con Sesión creada, no se envía nada.
Poner datos del pedido en la URL
Puedes colocar cualquier campo de los datos del evento dentro de la URL con dobles llaves, {{field_name}}. Por ejemplo:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Así se envían el ID de clic de Facebook y el total del pedido a una plataforma de seguimiento de anuncios o de afiliación, sin ningún servidor extra. Un campo que no existe queda vacío. Para ver los nombres de los campos, crea un webhook de tipo Correo electrónico para el mismo evento y mira los datos que recibes.
La lista de webhooks
Cada fila muestra el Nombre, URL / Correo electrónico, Tipo, Evento, Formato y Estado (Activado o Desactivado). Haz clic en una fila para editarla. Marca filas y elige Eliminar webhooks para borrarlas definitivamente. Hay un número máximo de webhooks por tienda, y verás un mensaje cuando lo alcances.
Puedes crear varios webhooks para el mismo evento, por ejemplo uno hacia tu CRM y otro hacia tu herramienta de seguimiento de anuncios.
Cuando falla una entrega
- Tu servidor debe responder rápido con un código de éxito (2xx). Una respuesta lenta cuenta como fallo.
- Si tu servidor está caído u ocupado (una respuesta 5xx o 429, o ninguna respuesta), Storeep lo vuelve a intentar varias veces durante los minutos siguientes. Solo se reintentan los webhooks que fallaron, así que los demás no reciben duplicados.
- Si tu servidor rechaza la petición (una respuesta 4xx como 404 o 403), Storeep no lo reintenta, porque la dirección o su seguridad son incorrectas.
- Cuando un webhook falla varias veces seguidas, el propietario de la tienda recibe un único correo: "Action needed: your Storeep webhook is failing", con el nombre del webhook, la dirección, el evento y el último código de error. Cuando el webhook vuelve a funcionar, un problema futuro puede enviar un nuevo aviso. Puedes desactivar este correo en Notificaciones.
- Los webhooks de tipo Correo electrónico se envían una sola vez, sin reintentos.
Webhooks en pausa por un saldo sin pagar
Si tu tienda tiene un importe debido sin pagar y tu monedero no puede cubrirlo, los webhooks esperan. Se envían después de que añadas fondos y se salde el importe. Consulta Monedero y facturación.
Consejos
- Si tu servidor necesita una contraseña o una clave, ponla en la consulta de la URL, por ejemplo
?key=yoursecret. - Sesión creada se activa con cada visitante, lo que puede ser mucho en una tienda con tráfico. Úsalo solo si tu servidor puede soportarlo.
- Para que una herramienta lea tus pedidos y productos cuando quiera, usa en su lugar un token de acceso.