Las agencias de marketing digital manejan docenas de facturas, pagos y notas de crédito cada mes. Sin automatización, el equipo pierde horas en tareas repetitivas:
Copiar datos de facturas manualmente a tu sistema contable
Enviar recordatorios de pago uno por uno a clientes morosos
Revisar diariamente si hay facturas vencidas sin cobrar
Notificar a contabilidad cuando se emite o cancela un CFDI
La solución: Los webhooks de Agenc-ia notifican automáticamente a tus herramientas cuando ocurre cualquier evento de facturación. Tu equipo deja de ser el mensajero y se enfoca en lo que importa.
7
Eventos
3
Reintentos Auto
SHA256
Firma HMAC
∞
Endpoints
Los 7 Eventos de Facturación
Factura Emitida
invoice.issued
Se dispara cuando una factura CFDI es timbrada exitosamente ante el SAT.
Ejemplo de uso: Enviar la factura por WhatsApp al cliente, actualizar tu ERP, o registrar en contabilidad.
Se dispara cuando se genera un nuevo borrador de factura listo para revisión.
Ejemplo de uso: Notificar a tu equipo fiscal para que revise el borrador antes de timbrar.
Datos del payload
invoice_idclient_idtotalperiod_startperiod_end
Nota de Crédito Emitida
credit_note.issued
Se dispara cuando se emite una nota de crédito CFDI.
Ejemplo de uso: Ajustar saldos en tu ERP o notificar al departamento de contabilidad.
Datos del payload
credit_note_idoriginal_invoice_idssat_uuidtotal
Conecta con tus Herramientas Favoritas
Los webhooks de Agenc-ia funcionan con cualquier plataforma que acepte notificaciones HTTP POST. Estos son los escenarios más comunes:
Zapier
Usa el trigger "Webhooks by Zapier → Catch Hook". Copia la URL y pégala en Agenc-ia. Conecta con Gmail, Slack, Google Sheets, o cualquiera de las 6,000+ apps de Zapier.
Make (Integromat)
Crea un escenario con el módulo "Custom Webhook". Make te genera una URL única. Úsala en Agenc-ia para recibir eventos y procesarlos con flujos visuales.
n8n / Scripts
Usa el nodo "Webhook" en n8n, o recibe el POST en tu propio servidor. El payload JSON incluye toda la información del evento para procesarlo como necesites.
Seguridad y Confiabilidad
Firma HMAC-SHA256
Cada webhook se firma con tu secret usando HMAC-SHA256. Verifica el headerX-Agenc-ia-Signaturepara confirmar que el mensaje viene de Agenc-ia.
Reintentos Automáticos
Si tu servidor no responde con 2xx, Agenc-ia reintenta 3 veces con backoff exponencial: 5 min, 30 min y 2 horas. Nunca pierdes un evento.
Logs de Entrega
Cada entrega queda registrada con estado, código HTTP, intentos y timestamp. Consulta el historial completo desde la interfaz de configuración.
Secret Encriptado
Tu secret de firma se almacena encriptado con Fernet. Ni siquiera los administradores pueden verlo en texto plano.
Formato del Payload
Todos los webhooks envían un JSON con esta estructura estándar:
Un webhook es una notificación HTTP que Agenc-ia envía automáticamente a una URL que tú configuras cuando ocurre un evento (como la emisión de una factura). Esto permite conectar Agenc-ia con herramientas como Zapier, Make, n8n, o tu propio sistema sin necesidad de consultar la API manualmente.
¿Qué eventos de facturación puedo recibir por webhook?
Agenc-ia soporta 7 eventos: factura emitida (invoice.issued), pago recibido (payment.received), factura pagada (invoice.paid), factura vencida (invoice.overdue), factura cancelada (invoice.cancelled), borrador creado (invoice.draft_created) y nota de crédito emitida (credit_note.issued).
¿Los webhooks son seguros?
Sí. Cada webhook puede firmarse con HMAC-SHA256 usando un secret que solo tú conoces. El payload se firma y se envía en el header X-Agenc-ia-Signature. Tu sistema puede verificar la firma para confirmar que el webhook realmente viene de Agenc-ia.
¿Qué pasa si mi servidor no está disponible?
Agenc-ia reintenta automáticamente hasta 3 veces con backoff exponencial: primer reintento a los 5 minutos, segundo a los 30 minutos, tercero a las 2 horas. Si después de 3 intentos falla, el webhook se marca como fallido y puedes ver el detalle en los logs de entrega.
¿Puedo conectar Agenc-ia con Zapier?
Sí. Crea un Zap con trigger "Webhooks by Zapier" → "Catch Hook", copia la URL que te da Zapier, y pégala en la configuración de webhooks de Agenc-ia. Selecciona los eventos que quieres recibir y listo — cada vez que ocurra ese evento, tu Zap se ejecutará automáticamente.
¿Puedo usar webhooks con Make (Integromat) o n8n?
Sí, funciona con cualquier plataforma que acepte webhooks HTTP. En Make, usa el módulo "Custom Webhook". En n8n, usa el nodo "Webhook". Ambos te darán una URL que puedes configurar en Agenc-ia.
¿Cuántos endpoints puedo configurar?
Puedes configurar múltiples endpoints, cada uno con diferentes eventos suscritos. Por ejemplo, un endpoint para tu ERP que reciba solo pagos, y otro para Zapier que reciba facturas emitidas.
¿Cómo veo si mis webhooks están funcionando?
En Configuración → Webhooks puedes ver el historial de entregas de cada endpoint: estado (exitoso, fallido, reintentando), código de respuesta HTTP, número de intentos y fecha. También puedes enviar un webhook de prueba desde la interfaz.