Transferencias y colgar

El agente de voz puede usar cualquier herramienta de NappAI. Además, tres herramientas de la familia Voice Agent controlan la llamada en sí. Se conectan a Tools del componente Voice Agent, o de un sub-agente, y el agente decide cuándo usarlas según tu system prompt.

Herramienta	Qué hace
Transfer Call	Pasa la llamada a un teléfono o a otro agente de voz.
Hang Up Call	Se despide y cuelga.
Say to Caller	Lee un texto palabra por palabra: un aviso legal, un horario, un número.

En cada una, el modo herramienta de cada campo decide si el texto lo escribe la IA en cada llamada o es un texto fijo tuyo.

Transferir a otro agente de voz

Es la forma de montar una centralita: una recepcionista que pasa a finanzas, a soporte o a ventas, cada uno con su propio prompt, herramientas, voz y avatar.

1. Crea y publica cada agente de destino. El que recibe la llamada es siempre su versión publicada.
2. En el agente que transfiere, añade un Transfer Call y conéctalo a Tools.
3. En Destination type elige voice_agent y, en Voice Agent, el agente de destino.
4. En la descripción de la herramienta, y en el prompt, explica cuándo transferir: “Si preguntan por facturas o pagos, transfiere a finanzas”.

Qué oye el llamante:

1. El Announcement to the caller, por ejemplo “Te paso con finanzas, un momento”.
2. Un tono breve de transferencia, cuando termina el anuncio y hasta que contesta el nuevo agente, si Transfer tone está activado (lo está por defecto).
3. El nuevo agente, que sigue la misma conversación: sabe lo que se ha hablado y el Reason de la transferencia, así que no vuelve a preguntar lo que ya se dijo.

En el widget web cambian también la cara y el nombre al del agente que recibe.

Para varios destinos, añade un Transfer Call por cada uno, con una descripción clara de cuándo usar cada cual.

Transferir a un teléfono

1. Crea un trunk de salida con tu operador. Consulta Llamadas salientes.
2. Al publicar el agente, elige ese trunk en Trunk de salida para transferencias, dentro de Configurar consumo con Teléfono (SIP) marcado. Automático usa el trunk de llamadas salientes del agente o el único que tengas.
3. En el Transfer Call, deja Destination type en phone y pon el número en formato internacional en Destination, por ejemplo +34910000000.
4. Type: cold pasa la llamada directamente. warm pone al llamante en espera, llama a la persona de destino, le resume el caso y solo los conecta si acepta. Se ajusta con Ring timeout (seconds), Hold limit (seconds), Advisor language y Advisor briefing instructions; consulta Transfer Call.

Si el destino rechaza la llamada, no contesta, cuelga o salta un buzón, el agente se lo dice al llamante y la llamada sigue con él. El trunk de salida es el mismo que para llamar; consulta qué trunk necesitas para cada cosa.

Cómo termina una llamada

Una llamada termina por uno de estos motivos. El motivo queda en el historial:

Motivo	Cuándo
El agente cuelga	El agente usa Hang Up Call, normalmente cuando el llamante se despide. El historial guarda el Reason que escribió.
El llamante cuelga	El llamante cuelga el teléfono o cierra el widget.
Inactividad	Nadie habla durante Inactivity Before Hanging Up (45 segundos por defecto). Con Ask Before Hanging Up activado, antes pregunta si sigue ahí. No cuenta mientras el agente habla o una herramienta trabaja.
Duración máxima	Se alcanza Maximum Call Duration (600 segundos, diez minutos, por defecto). El agente se despide.
Transferencia	La llamada pasa a un teléfono. En el historial queda como Transferida.
Fallo	Un componente falla en plena llamada, por ejemplo un proveedor sin saldo. La llamada se corta y queda como Fallida con el motivo.

Sin Hang Up Call, el agente no puede colgar por su cuenta: la llamada acaba cuando cuelga el llamante, por inactividad o por la duración máxima.