Enviar eventos a su propio sistema con webhooks

Un webhook permite que IDup llame a una dirección web suya en el momento en que algo sucede, por ejemplo, cuando se paga una factura. Cada entrega está firmada y se repite si su sistema no responde.

Añadir un endpoint

1. Abrir el Webhooks pestaña y presione Añadir endpoint.
2. Introduzca un Nombre y el URL. Debe ser públicamente accesible. Las direcciones dentro de una red privada son rechazadas por razones de seguridad.
3. Marque el Eventos usted quiere.
4. Opcional: elija un Clave API. El endpoint entonces recibe solo eventos que esta clave puede leer.
5. Prensa Guardar. IDup muestra Su secreto de firma una vez. Guárdelo de manera segura.

Eventos

• Factura creada, Factura pagada, Pago recibido
• Nuevo cliente, Nuevo contacto, Nuevo lead, Nuevo ticket
• Presupuesto aceptado — un presupuesto que un cliente aceptó

Cada entrega lleva tres encabezados: el nombre del evento, un número de entrega y la firma. Un reintento mantiene el mismo número de entrega, para que su sistema pueda reconocer duplicados.

Verificar la firma

Su sistema debe calcular un HMAC-SHA256 sobre el tiempo y el cuerpo sin procesar con su secreto, compararlo con la firma y rechazar un tiempo mayor a 5 minutos. Presione Verificar firma y ejemplos para código predefinido.

Probar, pausar y renovar

• Enviar prueba envía un evento de prueba y muestra el código HTTP y el tiempo que tomó.
• Pausa detiene las entregas; Activar los inicia de nuevo.
• Secreto de rollo crea un nuevo secreto. El antiguo deja de funcionar de inmediato.
• Eliminar elimina el endpoint. Su registro se mantiene.

Reintentos y el registro

Su dirección debe responder con un código 2xx en 5 segundos. No se siguen redirecciones. Si falla, IDup lo intenta de nuevo después de 1 minuto, 5 minutos, 30 minutos, 2 horas y 12 horas. Después del sexto intento, la entrega se marca Dado por vencido.

El registro muestra cada intento con evento, punto final, intento, código HTTP, duración y el inicio de la respuesta. El estado es Esperando, Entregado, Fallido o Dado por vencido. Use Reenviar para enviar una entrega nuevamente.