Qué hacen los webhooks
Un webhook es una suscripción a un evento específico de la tienda. Cuando ese evento ocurre, Storeep envía inmediatamente los datos del evento a una URL que especificas (tipo API) o a una dirección de correo electrónico que especificas (tipo E-mail). Los webhooks se usan comúnmente para integraciones de seguimiento de pedidos, sincronizaciones con CRM, conversiones de plataformas publicitarias y notificaciones automatizadas.
Para gestionar los webhooks, ve a Configuración → Webhooks.
Límites de webhooks
- Máximo de 20 webhooks por tienda. Intentar añadir el número 21 devuelve un error.
- Los webhooks se listan de más reciente a más antiguo, paginados a 40 por página.
Crear un webhook
Haz clic en Añadir nuevo webhook.
Interruptor de activación
Cuando está marcado (el valor predeterminado), el webhook está activo desde el momento en que se guarda. Los eventos se envían de inmediato. Desmárcalo para guardar el webhook en un estado deshabilitado sin recibir eventos. Puedes habilitar o deshabilitar un webhook en cualquier momento editándolo.
Nombre
- Obligatorio.
- Máximo 50 caracteres.
- Una etiqueta descriptiva que se muestra en la lista de webhooks. Ejemplo: Facebook CAPI, pedido creado.
Tipo
Controla cómo se entrega la carga útil del evento. Dos opciones:
- API: Storeep envía una solicitud HTTP POST que contiene los datos del evento a la URL que especifiques.
- E-mail: Storeep envía un correo electrónico con los datos del evento a la dirección que especifiques.
Evento
El evento de la tienda que activa este webhook. Hay tres eventos disponibles:
- Sesión creada: se activa cuando se crea una nueva sesión de visitante en tu tienda.
- Pedido creado: se activa cuando se realiza un nuevo pedido.
- Pedido actualizado: se activa cuando el estado o los datos de un pedido existente cambian.
Formato
El formato de datos de la carga útil del evento. Actualmente una opción:
- Json: la carga útil se envía como un documento JSON.
URL (solo tipo API)
- Obligatorio cuando el tipo es API.
- Máximo 500 caracteres. El límite más alto acomoda URLs que incluyen múltiples segmentos de marcador de posición.
- Ingresa la URL del endpoint sin el prefijo
https://. Se añade automáticamente. Ejemplo:api.example.com/events/order. - Marcadores de posición dinámicos en URL: cualquier campo de la carga útil del evento puede inyectarse en la URL usando la sintaxis de dobles llaves:
{{field_name}}. Por ejemplo:https://example.com/postback?cid={{fbclid}}&payout={{order_total}}
Esto te permite enviar datos de conversión a plataformas publicitarias directamente desde la URL del webhook sin un servidor proxy separado. - Si la estructura de la URL no es válida después de resolver los marcadores de posición, recibirás un error de validación.
Dirección de correo electrónico (solo tipo e-mail)
- Obligatorio cuando el tipo es E-mail.
- Debe ser una dirección de correo electrónico válida, máximo 127 caracteres.
Editar un webhook
Haz clic en cualquier fila de webhook para abrir el editor. Todos los campos son editables. El campo URL solo se pre-rellena si el tipo actual es API; el campo de correo electrónico solo se pre-rellena si el tipo actual es E-mail. Cambiar el tipo limpia el otro campo.
Habilitar y deshabilitar webhooks
La casilla de verificación Activar en la parte superior del editor controla si el webhook se activa. El estado en la lista muestra Activado o Desactivado. Un webhook deshabilitado no registra ninguna entrega pero no se elimina, por lo que puedes volver a habilitarlo más tarde sin reconfigurarlo.
Columnas de la lista de webhooks
- Nombre: etiqueta del webhook con fecha de creación.
- URL / E-mail: la dirección de destino.
- Tipo: API o E-mail.
- Evento: el nombre del evento (Sesión creada, Pedido creado o Pedido actualizado).
- Formato: Json.
- Estado: Activado o Desactivado.
Eliminar un webhook
Selecciona uno o más webhooks y haz clic en Eliminar webhooks. Esta acción es permanente y detiene todas las entregas futuras para esa suscripción.
Consejos y posibles problemas
- Puedes crear varios webhooks para el mismo evento, por ejemplo, enviar Pedido creado tanto a un CRM como a una plataforma publicitaria, cada uno como una entrada de webhook separada.
- Si tu endpoint requiere autenticación, añade las credenciales a la cadena de consulta de la URL usando un
{{marcador_de_posición}}obtenido de los datos del evento, o configura un servidor proxy que maneje la autenticación antes de reenviar al endpoint real. - El evento Sesión creada se activa para cada sesión de visitante única, lo que puede ser de alto volumen en tiendas populares. Solo suscríbete a él si tu endpoint puede manejar el rendimiento.