Usando webhooks

¿Qué son los webhooks?

↑ Back to top
Un webhook es una notificación de evento enviada a una URL de tu elección. Los usuarios pueden configurarlos para activar eventos en un sitio y así invocar un comportamiento en otro sitio. Los webhooks son útiles para integrarse con servicios de terceros y otras API externas que los admiten.

Webhooks en WooCommerce

↑ Back to top
Los webhooks se introdujeron en WooCommerce 2.2 y pueden activar eventos cada vez que añades, editas o eliminas pedidos, productos, cupones o clientes. También es posible usar webhooks con acciones de WooCommerce, por ejemplo, crear un webhook para usarlo cada vez que se añade un producto al carrito de compras, usando la acción woocommerce_add_to_cart. Los webhooks también facilitan la integración de aplicaciones de terceros con WooCommerce.

Crear webhooks

↑ Back to top
Para crear un nuevo webhook: 1/ Ve a: WooCommerce> Ajustes> Avanzado> Webhooks. Nota: Los webhooks se encontraban anteriormente en WooCommerce> Ajustes> API antes de WooCommerce 3.4. 2/ Selecciona Crea un nuevo webhook (primer incidente) o Añadir webhook. Aparecerá el cuadro de datos del webhook. 3/ Ingresa
  • Nombre: el nombre se genera automáticamente como «Webhook creado el [fecha y hora de creación]» como estándar para facilitar la creación. Cambia el nombre por otro.
  • Estado: elige entre En Activo (entregar la carga), En pausa (no entregar) o Desactivado (no entregar debido a errores en la entrega).
  • Tema: indica cuándo se debe activar el webhook: pedido creado, producto eliminado o cliente actualizado. También hay opciones de Acción y Personalizadas.
    • Evento de acción: esta opción está disponible cuando el tema es una acción de WooCommerce, como woocommerce_add_to_cart cuando los clientes añaden productos al carrito de compras.
    • Tema personalizado: esta opción es solo para usuarios avanzados. Es posible introducir temas nuevos y personalizados con la ayuda del filtro woocommerce_webhook_topic_hooks.
  • URL de entrega: URL donde se entrega la carga del webhook.
  • Secreto: la clave secreta genera un hash del webhook entregado y se proporciona en los encabezados de la solicitud. Este valor es por defecto el secreto del consumidor del usuario de la API actual, si no se ingresa nada.
4/ Guardar Webhook.
Nota: la primera vez que tu webhook se guarda con el estado Activo, éste envía un ping a la URL de entrega.

Editar y eliminar webhooks

↑ Back to top
Los webhooks se enumeran de la misma forma que las entradas o los productos.
  1. Busca el webhook que deseas modificar.
  2. Pasa el cursor sobre el nombre y aparecerán las opciones Editar y Borrar permanentemente.
  3. Borrar o realizar ediciones y guardar cambios. La eliminación masiva también es posible con el menú desplegable.

Registros de webhook

↑ Back to top
WooCommerce guarda registros de todos los eventos que activan un webhook. Los registros de webhook se encuentran en: WooCommerce> Estado> Registros. Los registros se pueden revisar para ver la entrega y la respuesta del servidor, lo que facilita la integración y la depuración.