¿Envías eventos de la lista de deseos a tu tienda desde otro sistema? El webhook entrante de SaveTo Wishlist Pro ahora requiere una clave API antes de aceptar nada, por lo que un sitio que no haya generado una rechaza cada solicitud en lugar de aceptarla sin verificar. Esto cubre dónde generar esa clave, cómo tu integración debe enviarla y qué esperar si falta o es incorrecta. Enviar eventos en la otra dirección, desde tu tienda, se cubre en Cómo conectar herramientas externas usando webhooks de listas de deseos.
Antes de empezar
- SaveTo Wishlist Pro está instalado y activo.
- Tienes acceso al sistema externo que enviará los eventos de la lista de deseos, por lo que puedes almacenar la clave que necesita enviar con cada solicitud.
Generar la clave API del webhook
Hasta que exista una clave, el punto de conexión del webhook rechaza cada solicitud, por lo que esto es lo primero que debes hacer.
- Ve a SaveTo Wishlist > Ajustes.
- Haz clic en la pestaña General.
- En la sección API del Webhook, haz clic en Generar clave API y confirma cuando se te solicite.
- Copia el valor que aparece en el campo Clave API del Webhook de la Lista de Deseos.
El campo Clave API del Webhook de la Lista de Deseos también acepta una clave que escribas tú mismo, si tu sistema externo necesita proporcionar su propio valor en lugar de usar uno generado. En cualquier caso, haz clic en Guardar Cambios para almacenarla.
Envía la clave con tus solicitudes
Configura tu sistema externo para que envíe la clave en cada llamada a POST /wp-json/saveto-wishlist-pro/v1/webhook/wishlist-created. Hay dos formas de enviarla:
- Como una cabecera de solicitud x-api-key. Este es el método preferido.
- Como un parámetro de cadena de consulta api_key, si tu sistema no puede establecer cabeceras personalizadas.
Copia la clave exactamente como aparece en el campo Clave API del Webhook de la Lista de Deseos, sin espacios adicionales ni saltos de línea añadidos antes o después. La comparación distingue entre mayúsculas y minúsculas, por lo que una clave que no coincida exactamente se trata igual que una que falta.
Qué sucede cuando la clave falta o es incorrecta
Una solicitud sin una clave válida recibe una respuesta 401 Unauthorized en lugar de ser procesada, ya sea que la clave falte por completo, no coincida con lo almacenado en Ajustes o aún no se haya generado en tu tienda. Esto es cierto incluso para un sitio que nunca ha generado una clave: sin nada almacenado con qué comparar, cada solicitante es rechazado en lugar de ser admitido.
Hacer clic de nuevo en Generar clave API reemplaza la clave almacenada inmediatamente. Cualquier sistema que siga enviando la clave antigua comenzará a ser rechazado de inmediato, así que actualiza tu integración con el nuevo valor tan pronto como lo regeneres.
Solución de problemas
Cada solicitud a la webhook recibe una respuesta 401
Comprueba que se haya generado una clave en SaveTo Wishlist > Settings > General, en Webhook API. Si el campo está vacío, genera una y guarda los cambios. Si ya hay una clave, confirma que tu integración la está enviando como encabezado x-api-key (o como parámetro de consulta api_key) y que se copió sin espacios en blanco alrededor.
La integración funcionaba antes, pero ahora cada solicitud falla
Esto normalmente significa que la clave se regeneró en la pestaña General desde la última vez que se actualizó la integración. Generar una nueva clave reemplaza la anterior inmediatamente, así que actualiza el sistema que llama con el valor actual del campo Wishlist Webhook API Key.
Preguntas frecuentes
¿Qué sucede si nunca genero una clave?
El endpoint de la webhook rechaza cada solicitud. Una clave vacía nunca puede coincidir con nada que envíe el llamador, por lo que esto es lo mismo que si el endpoint estuviera desactivado.
¿Puedo usar la cadena de consulta en lugar de un encabezado?
Sí. Envía api_key=tu-clave como parámetro de consulta si tu sistema no puede establecer el encabezado x-api-key. El encabezado se comprueba primero, por lo que tiene prioridad si ambos están presentes.
¿Regenerar la clave rompe mi integración existente?
Sí, inmediatamente. La clave anterior deja de funcionar tan pronto como vuelves a hacer clic en Generate API Key, así que solo genérala de nuevo cuando estés listo para actualizar el sistema que llama con el nuevo valor al mismo tiempo.
¿Necesitas ayuda?
- Usuarios premium: Abrir un ticket de soporte
- Usuarios gratuitos: Visita nuestro foro comunitario
