Acciones

Conocer a quien llama antes de que empiece la llamada

Busca a quien llama en tu propio sistema antes de que el agente salude.

Un Pre fetch consulta a tu sistema sobre quien llama mientras se establece la llamada y da la respuesta al agente antes de su primera palabra, para que pueda saludar por su nombre a un cliente que repite, ver un pedido abierto o conocer el nivel de quien llama.

Configurarlo

1. Añade un Pre fetch

   Abre el agente → Acciones → Añadir herramienta y elige Pre fetch en la parte superior del menú.

2. Apúntalo a tu endpoint

   Campo	Qué introducir
   Nombre	Un nombre corto, p. ej., crm_lookup. También es el nombre del bloque que lee el agente
   API URL	Tu endpoint, p. ej., https://crm.example.com/lookup?phone={phone}
   Método HTTP	GET es lo más adecuado; también funcionan POST, PUT, PATCH y DELETE
   Encabezados	Opcionales, p. ej., tu clave API
   Parámetros de consulta	Opcionales; un pre fetch nuevo empieza con phone={phone}

3. Usa los marcadores

   Se rellenan en cada llamada, en la URL, los encabezados y los parámetros:

   Marcador	Valor
   {phone}	El número de quien llama; en una llamada saliente, el número marcado
   {direction}	inbound u outbound
   {agent_id}	El ID del agente
   {user_id}	El ID del propietario de la cuenta
   {call_id}	El ID de la llamada: crúzalo con los datos que recibes después de la llamada

Qué recibe el agente

Tu respuesta se añade a las instrucciones del agente como un bloque con nombre. Si tu endpoint devuelve { "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }, el agente lo lee antes del saludo. En el prompt puedes indicar qué hacer con ello, p. ej., si el contexto de la llamada incluye el nombre del cliente, salúdalo por su nombre.

Límites

• Solo llamadas telefónicas: una llamada web no tiene número que buscar.
• Cada petición dispone de 1,5 segundos, y todas juntas de 2 segundos. Un endpoint lento o con errores nunca retrasa el saludo: el agente empieza sin ese bloque.
• Las respuestas de más de 8 KB se recortan. Devuelve unos pocos campos, no la ficha completa del cliente.
• Un pre fetch se ejecuta siempre; no tiene condición.

Casos de uso

• Saludar por su nombre a los clientes que repiten.
• Conocer el pedido abierto antes de que quien llama lo explique.
• Tratar de otra forma los números VIP desde la primera frase.

Relacionado

• Obtener datos en tiempo real durante la llamada — cuando el agente debe decidir durante la llamada si busca algo
• Enviar los datos de la llamada a tu sistema — después de la llamada