Saltearse al contenido
Nappai Documentation

Transfer Call

Transfer Call es una herramienta para el Voice Agent: pasa la llamada en curso a otro agente de voz de NappAI, a un número de teléfono o a una dirección SIP. Se conecta al conector Tools del Voice Agent, o de un sub-agente, y el agente decide cuándo usarla según tu System Prompt y la descripción del nodo.

El llamante oye primero el anuncio de la transferencia y un tono breve, que puedes quitar. Si la pasas a otro agente, el nuevo agente sigue la misma conversación: sabe lo que se ha hablado y el motivo, así que no vuelve a preguntar lo que ya se dijo. La guía completa, con los trunks que necesitas para transferir a un teléfono, está en Transferencias y colgar.

Cuándo usarlo

  • Montar una centralita: una recepcionista que pasa a finanzas, a soporte o a ventas, cada uno con su propio agente.
  • Pasar a una persona del equipo los casos que el agente no puede resolver.
  • Avisar a un asesor y resumirle el caso antes de pasarle al cliente.
  • Derivar las llamadas a una línea de urgencias por teléfono.

Configuración

En los campos marcados con modo herramienta, el modo herramienta decide quién escribe el valor: activado, lo escribe la IA en cada llamada; desactivado, se usa el texto fijo que pongas aquí. Destination, Announcement To The Caller y Reason admiten modo herramienta.

CampoQué hace
Destination Typephone (por defecto) pasa la llamada a un número o a una dirección SIP. voice_agent la pasa a otro agente de voz de NappAI, en la misma llamada y con la conversación hasta ese momento.
Announcement To The CallerLo que oye el llamante en cuanto empieza la transferencia, palabra por palabra y en el idioma en que habla. Fijo o, en modo herramienta, escrito por el agente en cada llamada.
ReasonPor qué se transfiere la llamada. Lo escribe el agente y lo recibe el destino.
Transfer ToneActivado (por defecto), cuando termina el anuncio suena un tono breve hasta que se pasa la llamada, para que el llamante no espere en silencio; nunca suena encima del anuncio. Con warm, lo oyen también los dos lados al quedar conectados. Desactivado, tras el anuncio hay silencio hasta que se pasa la llamada.

Con Destination Type en voice_agent

CampoQué hace
Voice AgentOtro de tus flujos con un Voice Agent. Pulsa el botón de refrescar para verlos. La llamada pasa a la versión publicada de ese flujo, también cuando pruebas desde el playground, así que publícalo antes.

Con Destination Type en phone

CampoQué hace
DestinationEl número en formato internacional, por ejemplo +34600000000, o una dirección SIP.
Typecold (por defecto) pasa la llamada directamente. warm pone al llamante en espera con música, llama a la persona de destino, le resume el caso y solo los conecta si acepta.
Ring Timeout (Seconds)Solo con warm. Cuánto puede tardar en descolgar la persona de destino. Después, el llamante vuelve con el agente. De 10 a 180; por defecto, 45.
Advisor Reply Timeout (Seconds)Solo con warm. Cuando el agente ya ha hablado con quien contestó, cuánto espera a que responda. Si no dice nada (un buzón de voz, nadie al otro lado), el llamante vuelve con el agente. De 5 a 60; por defecto, 15.
Hold Limit (Seconds)Solo con warm. Lo máximo que espera el llamante en total, contando el tono y el resumen. Después, la transferencia se cancela y el agente sigue con él. De 60 a 600; por defecto, 180.
Advisor LanguageSolo con warm. Idioma en que el agente resume el caso a la persona de destino, por ejemplo Spanish o English. Vacío, el idioma en que habló el llamante.
Advisor Briefing InstructionsSolo con warm. Cómo habla el agente con la persona a la que llama antes de pasarle al llamante. Viene relleno con un texto por defecto que puedes cambiar, por ejemplo para pedir más formalidad. La conversación, el idioma y el motivo se añaden solos.

Resultado

La salida Transfer es la herramienta. Conéctala al conector Tools del Voice Agent o de un sub-agente.

Si el destino no contesta, rechaza la llamada o no está disponible, el agente se lo dice al llamante y la llamada sigue con él.

Ejemplo

Una empresa de suministros quiere que su recepcionista pase las dudas de facturas al agente de finanzas.

  1. Crea y publica el agente de finanzas.
  2. En el agente de recepción, añade un Transfer Call y conéctalo a Tools.
  3. Elige voice_agent en Destination Type y el agente de finanzas en Voice Agent.
  4. Deja Announcement To The Caller en modo herramienta para que el agente diga algo como «Te paso con finanzas, un momento».
  5. En el System Prompt escribe: «Si preguntan por facturas o pagos, transfiere a finanzas».
  6. Prueba en el playground pidiendo hablar de una factura.

Buenas prácticas

  • Añade un Transfer Call por cada destino y describe en cada nodo cuándo usarlo: el agente elige a partir de esa descripción.
  • Deja el anuncio en modo herramienta si quieres que suene natural; fíjalo solo cuando la frase exacta importe.
  • Usa warm cuando quien atiende necesita contexto, y avisa a tu equipo de que el agente les hablará al descolgar.
  • No pidas al agente que incluya datos sensibles en Reason: viaja al destino.

Componentes relacionados