Capítulo 82
3 min
Webhooks: avisos a tu sistema
ConfiguraciónIntegraciones y APIAPI y Webhooks
Un webhook es un aviso que Ally360 manda a una dirección de tu sistema cada vez que pasa algo: se pagó una factura, la DIAN la validó, cambiaron las existencias. Así tu sistema se entera al momento, sin tener que preguntar a cada rato. Cada aviso va firmado para que tu sistema compruebe que lo mandó Ally360.
Abre API y Webhooks
Entra a ConfiguraciónIntegraciones y APIAPI y Webhooks. El bloque Webhooks lista los que ya existen. Los que creó una tienda en línea o una automatización llevan la etiqueta Creado por API: no los borres si esa integración sigue en uso.
Crea el webhook
Pulsa Crear webhook y escribe la URL que recibe los eventos. Debe empezar por
https://y ser pública. Agrega una Descripción para reconocerlo y elige los Eventos: Todos los eventos o sólo los que te interesan, por ejemplo «La factura quedó pagada», «La DIAN rechazó la factura», «Cambiaron las existencias», «Un producto quedó en su mínimo» o «El cliente aceptó una cotización».Copia el secreto de la firma
Al crearlo, Ally360 muestra el secreto una sola vez. Cópialo con Copiar secreto y guárdalo en tu sistema: con él se verifica la cabecera
Ally360-Signaturede cada entrega. Si se filtra, usa Cambiar secreto: el anterior deja de valer en ese momento y tienes que poner el nuevo en tu sistema.Prueba la entrega
Probar manda un evento de prueba y te dice si llegó o por qué no. Tu sistema debe responder con un código de éxito (2xx) en menos de 10 segundos; si tarda más, cuenta como fallido.
Revisa las entregas
Entregas abre las últimas entregas del webhook con su estado: Entregado, Reintentando, Fallido o Cancelado, la fecha y cuántos intentos lleva. Una entrega fallida se puede Reenviar.
Entiende los reintentos
Si tu sistema no responde, Ally360 reintenta a los 1 min, 5 min, 30 min, 2 h, 6 h, 12 h y 24 h. Si el webhook lleva tres días fallando sin una sola entrega exitosa, se desactiva y se avisa a los administradores de la empresa. Cuando lo arregles, vuelve a encenderlo con Activar.
Desactiva o borra
Desactivar deja de mandar avisos sin perder la configuración. Borrar lo elimina: Ally360 deja de enviar eventos a esa URL.
Preguntas frecuentes
¿Qué eventos puedo recibir?
De facturas (creada, emitida, pagada, anulada, validada o rechazada por la DIAN), notas crédito, pagos (registrado o anulado), contactos y productos (creado, cambiado, eliminado), cotizaciones (aceptada o convertida en factura), existencias (cambio o producto en su mínimo) y mercancía recibida de una compra.
Un webhook dice que falla desde cierta fecha
Tu sistema no está respondiendo con éxito. Revisa Entregas para ver el motivo, corrígelo y usa Probar. A los tres días sin ninguna entrega exitosa se desactiva solo.
¿Puedo probar sin tocar mis datos reales?
Sí. En la empresa de pruebas los webhooks funcionan igual y nada de lo que hagas llega a la DIAN.
¿Por qué hay webhooks que no creé yo?
Los crean las integraciones: el plugin de WooCommerce, la app de Shopify, Zapier o Make. Llevan la etiqueta Creado por API. Si desconectas esa integración, sus webhooks dejan de hacer falta.
En qué influye
Un webhook sólo avisa: no cambia nada en Ally360. Pero lo que tu sistema haga al recibirlo (despachar un pedido, actualizar el stock de una tienda) depende de que los avisos lleguen, así que revisa las entregas cuando algo no se sincronice.
¿Te resultó útil este artículo?


