Integrar una centralita o un asistente de voz
Reconocer a quien llama, darle contexto y dejar la llamada en su ficha.
Una centralita o un asistente de voz usa la API en cuatro momentos: al entrar la llamada, para saber quién es; mientras atiende, para tener su contexto; al colgar, para dejar la llamada en su ficha; y, si queda algo pendiente, para crear una tarea.
1 · Al entrar: busca por el número que llama. Si no hay ficha con ese teléfono, la búsqueda devuelve los contactos de la cuenta cuyo teléfono general es ese número (matchedBy company_phone). Si no hay nadie, puedes dar de alta al contacto (guía de Contactos).
En la URL, el «+» del número se escribe %2B. Sin codificar, llega como un espacio y el número deja de ser E.164.
curl -G https://plataforma.ndx-one.com/api/v1/crm/contacts \ -H "Authorization: Bearer $NDX_LLAVE" \ --data-urlencode "phone=+34600000000"2 · Mientras atiendes: GET /api/v1/crm/contacts/{id}/context trae sus oportunidades abiertas, lo último que se habló y sus tareas pendientes.
CONTACTO="6f1c2d3e-4b5a-4c6d-8e7f-90a1b2c3d4e5" # el id de la fichacurl https://plataforma.ndx-one.com/api/v1/crm/contacts/$CONTACTO/context \ -H "Authorization: Bearer $NDX_LLAVE"3 · Al colgar: deja la llamada con su resumen, la dirección, la duración, la transcripción entera y el id de la llamada en tu sistema, para que un reintento no la duplique.
CONTACTO="6f1c2d3e-4b5a-4c6d-8e7f-90a1b2c3d4e5" # el id de la fichacurl https://plataforma.ndx-one.com/api/v1/crm/contacts/$CONTACTO/calls \ -H "Authorization: Bearer $NDX_LLAVE" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "summary": "Pregunta por el estado de su pedido", "direction": "in", "durationSeconds": 184, "transcript": "— Hola, llamo por mi pedido…", "externalCallId": "llamada-0001", "fromNumber": "+34600000000" }'4 · Si queda algo por hacer: una tarea de seguimiento, que va al responsable del contacto.
CONTACTO="6f1c2d3e-4b5a-4c6d-8e7f-90a1b2c3d4e5" # el id de la fichacurl https://plataforma.ndx-one.com/api/v1/crm/contacts/$CONTACTO/tasks \ -H "Authorization: Bearer $NDX_LLAVE" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "title": "Llamar a Ana con el plazo de entrega", "dueOn": "2026-11-02" }'