Integraciones

Webhooks para Automatizar tu Facturación

Recibe notificaciones HTTP en tiempo real cuando ocurren eventos de facturación. Conecta con Zapier, Make, n8n o tu propio sistema.

¿Por Qué Webhooks para tu Agencia?

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.

Datos del payload

invoice_idclient_idsat_uuidtotalperiod_startperiod_end

Pago Recibido

payment.received

Se dispara cuando se registra un pago manual o se importa desde CSV.

Ejemplo de uso: Actualizar saldos en tu sistema contable o notificar a tu equipo de cobranza.

Datos del payload

payment_idamountpayment_datereferencesource

Factura Pagada

invoice.paid

Se dispara cuando un pago es conciliado exitosamente con una factura.

Ejemplo de uso: Marcar al cliente como al corriente o disparar el siguiente ciclo de facturación.

Datos del payload

invoice_idpayment_idamount_paid

Factura Vencida

invoice.overdue

Se dispara cuando una factura supera su fecha de vencimiento sin pago.

Ejemplo de uso: Enviar recordatorio automático al cliente o escalar a tu equipo de cobranza.

Datos del payload

invoice_idclient_idtotaldue_datedays_overdue

Factura Cancelada

invoice.cancelled

Se dispara cuando una factura CFDI es cancelada ante el SAT.

Ejemplo de uso: Actualizar tu contabilidad, generar nota de crédito, o notificar al cliente.

Datos del payload

invoice_idsat_uuidcancellation_reason_codecancelled_at

Borrador Creado

invoice.draft_created

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:

{
  "id": "d4e5f6a7-b8c9-...",
  "type": "invoice.issued",
  "created": "2026-02-24T15:30:00Z",
  "data": {
    "resource_id": "a1b2c3d4-...",
    "object": {
      "invoice_id": "...",
      "client_id": "...",
      "total": 15000.00,
      "sat_uuid": "ABC123..."
    }
  }
}

Headers incluidos:

Content-Type: application/jsonX-Agenc-ia-Event: invoice.issuedX-Agenc-ia-Delivery-ID: uuidX-Agenc-ia-Signature: sha256=...

Preguntas Frecuentes

¿Qué es un webhook y para qué sirve?

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.

Artículos Relacionados

¿Listo para Automatizar tu Facturación?

Configura webhooks en minutos y conecta Agenc-ia con las herramientas que ya usas. Sin código. Sin integraciones complicadas.