POST autenticada y el lead queda registrado en la cuenta. Esta es la dirección entrante, lo contrario de Webhooks y Zapier, que envía eventos desde DeltaLead hacia un endpoint externo.
Cómo funciona
Hay una sola ruta y hace una sola cosa:live o sandbox. No hay ID de cuenta, ID de organización ni ID de endpoint en ninguna parte de la URL: la URL es la misma para todos los clientes.
Crear una clave
1
Abrir la configuración del Webhook personalizado
En el panel de DeltaLead, ir a Configuración → Integraciones → Custom Webhook.
2
Elegir live o sandbox
El modo se define al crear la clave y queda fijo durante toda su vida; para cambiarlo hay que crear una segunda clave. La mayoría de las integraciones mantienen una de cada tipo.
3
Agregar una etiqueta y un vencimiento opcionales
La etiqueta ayuda a distinguir las claves más adelante, por ejemplo
web-form-prod. El vencimiento es opcional y puede fijarse entre 1 y 365 días; sin él, la clave no vence por sí sola.4
Copiar la clave
La clave completa se muestra una sola vez, al crearla. Debe guardarse en el gestor de secretos de la aplicación antes de cerrar el diálogo.
Gestión de claves
La lista de claves muestra todas las claves de la cuenta:
Sobre una clave existente hay dos acciones disponibles:
- Rotar — emite un secreto nuevo y conserva el modo y la etiqueta de la clave. Sirve cuando una clave pudo haberse filtrado o cuando la rotación de secretos es periódica. El secreto anterior deja de funcionar de inmediato, así que primero conviene desplegar el nuevo.
- Revocar — deshabilita la clave de forma permanente. No se puede deshacer: una clave revocada nunca se reactiva.
Claves live y sandbox
live y sandbox son modos de clave, no sistemas separados. Ambos se sirven desde el mismo host y la misma ruta indicada arriba. Probar con una clave sandbox implica llamar a producción: es intencional, y significa que la integración verificada es exactamente la misma que después se pone en marcha.
Lo que cambia es qué pasa con el lead una vez que llega:
Lo recomendable es construir y verificar la integración con una clave sandbox y después cambiarla por una live. Nada más de la solicitud cambia: misma URL, mismos headers, mismo body. Las entregas de sandbox nunca llegan al equipo comercial y se limpian solas.
Enviar el primer lead
1
Crear una clave sandbox
Seguir los pasos anteriores y copiar la clave en texto plano.
2
Enviar el body mínimo válido
Un lead necesita un nombre y, además, al menos un email o un teléfono.
cURL
3
Leer la respuesta
Una entrega aceptada por DeltaLead devuelve:Cualquier otro estado significa que la entrega no fue aceptada; ver la referencia completa de respuestas.
200 OK
4
Esperar unos segundos
La respuesta es sincrónica, pero confirma la aceptación, no la creación. DeltaLead encola la entrega y crea el lead unos segundos después. Por eso un
200 no significa que el lead ya exista: significa que va a existir.5
Repetir con una clave live
Enviar la misma solicitud con una clave live y abrir el Inbox unificado. El lead aparece ahí, recibe un score y dispara las automatizaciones configuradas. El lead de sandbox no está en el Inbox, y nunca va a estarlo.
Próximos pasos
Referencia del endpoint
El contrato completo del lead, la idempotencia, los límites de tasa y todos los códigos de respuesta.
Webhooks salientes
La otra dirección: recibir eventos de leads enviados desde DeltaLead a un endpoint externo.