Webhooks: que tu sistema se entere al instante de lo que pasa en Daplox

Un webhook es una URL de tu sistema a la que Daplox le avisa cuando pasa algo. En vez de preguntar cada rato "¿hay contactos nuevos?", tu sistema recibe el aviso en cuanto el contacto se crea. Los administra el dueño o un administrador de la cuenta.

Crear un destino

1. 1
   Abre Configuración → API y webhooks → Webhooks y pulsa "Nuevo destino"
2. 2
   Escribe la URL

   Tiene que empezar por https:// y ser una dirección pública de internet.
3. 3
   Elige los eventos

   Marca solo los que tu sistema usa, o "Todos los eventos" para recibir también los que Daplox agregue más adelante.
4. 4
   Guarda el secreto de firma

   Aparece una sola vez, al crear el destino. Con él tu sistema comprueba que el aviso viene de Daplox.
5. 5
   Pulsa "Probar"

   Daplox envía un evento de prueba y te dice qué respondió tu servidor y en cuánto tiempo. Las pruebas salen solo al puerto 443 (https estándar) y hasta 5 por minuto por destino.

Los eventos disponibles

Cada evento trae el objeto completo (por ejemplo, el contacto con sus datos) y, cuando algo cambió, el valor anterior. En Documentación → Eventos disponibles hay un ejemplo de cada uno.

Cuando tu servidor falla

• Tu servidor debe responder con un código 2xx en menos de 10 segundos. Si responde con error (5xx, 408 o 429) o no responde, Daplox reintenta con esperas crecientes durante unas 30 horas.
• Un error 4xx no se reintenta: suele ser un problema de configuración que hay que corregir. Un 410 apaga el destino.
• Tras 5 fallos seguidos el destino hace una pausa corta; tras 15, se apaga y el dueño y los administradores reciben un aviso en la campana, con enlace a esta pantalla.
• Si el dominio de tu servidor no responde (un problema de DNS), Daplox reintenta sin contarlo como un fallo de tu servidor.
• En "Entregas" ves cada envío: estado, intentos, código de respuesta, tiempo y el comienzo de lo que respondió tu servidor. Con "Reintentar" vuelves a enviar una entrega terminada de las últimas 72 horas; con "Activar" reanudas un destino apagado.
• Si se juntan 5.000 entregas en espera para un destino, los eventos nuevos no entran: el destino muestra cuántos quedaron fuera y llega un aviso a la campana.

Lo que se borra no se vuelve a enviar

• Al borrar un contacto, una oportunidad, una venta, una cotización, una factura o un suscriptor, sus eventos se vacían y sus entregas pendientes se descartan. Borrar un contacto alcanza también lo que hablaba de él: sus oportunidades, sus mensajes y sus ventas.
• Un pedido de borrado de datos personales hace lo mismo con todo lo que mencionaba a esa persona, también por su correo.
• Reiniciar la cuenta borra los eventos, las entregas y las respuestas guardadas de la API. Los destinos se conservan.
• Un evento vaciado ya no se puede reenviar, y en el registro solo dice de qué trataba, no lo que contenía.

Seguridad

• Cada aviso lleva la cabecera Daplox-Signature: una firma HMAC-SHA256 del cuerpo con tu secreto. Verifícala antes de confiar en el contenido; la Documentación trae el código listo en curl, JavaScript y Python.
• "Rotar secreto" crea uno nuevo. Durante 24 horas cada aviso llega firmado con los dos, para que actualices tu servidor sin cortes.
• Daplox solo envía a direcciones https públicas y no sigue redirecciones a otro dominio.
• Una integración también puede crear su propio destino con una clave de administración. Ese destino solo recibe los eventos de las áreas que la persona dueña de la clave puede ver, y se apaga solo si la clave deja de valer. Rotar la clave no lo corta: el destino pasa a la clave nueva.
• Un destino creado desde el panel queda a nombre de quien lo creó o lo reactivó. Si esa persona deja de administrar la cuenta, el destino se apaga y llega un aviso; al activarlo, queda a tu nombre.
• "Cerrar todas las sesiones" y restablecer la contraseña apagan los destinos que esa persona creó en las últimas 72 horas, igual que sus claves de API recientes.
• Durante una impersonación de soporte no se crean destinos ni se cambia su URL, sus eventos o su secreto.