Introducción
La API y los webhooks conectan OrquestAI con tu stack (CRM, BI, marketing). Esto evita trabajo manual y errores.
API de Leads
- Endpoint: POST https://api.orquest-ai.com/api/integration/leads
- Auth: x-api-key
- Soporta: individual, lote, auto_call.
Idempotencia: incluye un external_id para evitar duplicados.
{
"external_id": "fb-ads-784512",
"name": "Ana Torres",
"phone": "+13475550123",
"email": "ana@ejemplo.com",
"source": "Facebook",
"auto_call": true,
"meta": { "campaign": "Promo Q3" }
}
Webhooks (ejemplo de payload)
{
"event": "call.completed",
"lead_id": "L-12345",
"outcome": "interested",
"duration_sec": 164,
"scheduled_meeting": "2025-08-15T14:00:00-04:00",
"transcript_url": "https://..."
}
- Implementa reintentos y responde 2xx para confirmar recepción.
- Firma de seguridad (si está activada).
Integración con Meta (Facebook/Instagram)
- Recibe leads de Ads en tiempo real.
- Sincroniza con Pixel/Conversions API para cierre del loop.
Buenas prácticas
- HTTPS en webhooks, valida firma.
- Registro de errores y reintentos exponenciales.
- Rotación de API Keys, principio de mínimo privilegio.
Conclusión
Una integración sólida aclara el embudo y da velocidad a tus equipos.