Guías/Webhooks

Primeros Pasos con Webhooks

Configura notificaciones automáticas de facturación en 5 minutos.

Todos los planes•5 minutos de lectura

Antes de empezar

  • • Una cuenta activa en Agenc-ia.digital
  • • Una URL que acepte webhooks (Zapier, Make, n8n, o tu propio servidor)
  • • (Opcional) Un secret de 16+ caracteres para firma HMAC
1

Abre la Configuración de Webhooks

Navega a Configuración → Webhooks desde el menú principal. Verás una pantalla vacía si es tu primera vez.

Ruta:

Configuración → pestaña Webhooks

2

Crea tu Primer Endpoint

Haz clic en "Agregar Endpoint" y completa el formulario:

URL del Webhook

La URL a la que Agenc-ia.digital enviará las notificaciones HTTP POST.

Ejemplos por plataforma:

https://hooks.zapier.com/hooks/catch/123456/abcdef/https://hook.eu1.make.com/abc123xyzhttps://n8n.tudominio.com/webhook/facturacion

Eventos a Suscribir

Selecciona qué eventos quieres recibir. Puedes elegir uno o varios:

invoice.issuedinvoice.paidinvoice.overdueinvoice.cancelledinvoice.draft_createdpayment.receivedcredit_note.issued

Secret (Opcional)

Si quieres verificar que los webhooks vienen de Agenc-ia.digital, ingresa un secret de al menos 16 caracteres. Agenc-ia.digital firmará cada payload con HMAC-SHA256.

3

Envía un Webhook de Prueba

Una vez creado el endpoint, haz clic en el botón de pruebajunto a tu endpoint. Agenc-ia.digital enviará un evento test.webhook con datos de ejemplo.

Si recibes "Test exitoso (HTTP 200)" → todo funciona
Si falla → revisa que la URL sea correcta y accesible

Tip: En Zapier, después de pegar la URL y enviar la prueba desde Agenc-ia.digital, haz clic en "Test trigger" en Zapier para capturar el payload de ejemplo.

4

Verifica los Logs de Entrega

Haz clic en "Ver logs"para ver el historial de entregas. Cada registro muestra:

Estado

Exitoso (verde), Fallido (rojo), o Reintentando (amarillo).

Código HTTP

La respuesta de tu servidor: 200, 404, 500, etc.

Intentos

Cuántos intentos se han hecho (máximo 3 con backoff).

Timestamp

Fecha y hora exacta de cada intento de entrega.

5

Configura tu Automatización

Con el webhook funcionando, configura la acción en tu plataforma de automatización. Algunos ejemplos populares:

invoice.issued→ Enviar PDF de factura al cliente por WhatsApp o email
invoice.overdue→ Crear tarea de seguimiento en tu CRM o enviar recordatorio
payment.received→ Registrar el pago en tu sistema contable (CONTPAQi, Aspel, etc.)
invoice.cancelled→ Notificar a tu contador y actualizar el libro de ventas

Consejos

Un Endpoint por Destino

Si usas Zapier para emails y Make para contabilidad, crea un endpoint para cada uno con los eventos relevantes.

Usa un Secret Siempre

La firma HMAC-SHA256 te protege contra webhooks falsos. Genera un secret largo y aleatorio.

Revisa los Logs Regularmente

Si ves entregas fallidas, verifica que tu URL siga activa y que tu servidor responda rápido (<10 segundos).

¿Qué sigue?

Ya tienes tu webhook configurado. Explora más sobre el sistema:

Guía Completa de WebhooksRevisión de Borradores