NuevoAlly IA ya responde con las cifras de tu negocioPruébala →
Integraciones

Capítulo 82

3 min

Webhooks: avisos a tu sistema

ConfiguraciónIntegraciones y APIAPI y Webhooks
Pantalla API y Webhooks con los botones Documentación API y Tokens de acceso, el recuadro Cómo se usa, el bloque Empresa de pruebas y el bloque Webhooks con Crear webhook y dos webhooks Activos y Creados por API: uno de WooCommerce que escucha Cambiaron las existencias y otro, Avisos a mi sistema, con seis eventos; cada uno con Probar, Entregas, Cambiar secreto, Desactivar y Borrar
Cada webhook muestra su URL, sus eventos y las acciones para probarlo y revisarlo.

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.

  1. 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.

  2. 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».

  3. 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-Signature de 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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?

Sigue leyendo

¿No encontraste lo que buscabas?

Escríbenos y te ayudamos a resolverlo. Respondemos en horario hábil colombiano.

¿Tienes dudas?