Las integraciones en detalle API
Su asistente de voz pregunta: ¿quién llama?
Un asistente de voz descuelga antes que una persona. No sabe quién llama, pero puede preguntar. Esta página muestra cómo enseñarle la pregunta.
No hace falta ningún contrato ni estatus de socio. Usted crea una clave en su portal e introduce cinco datos en su asistente. Si su plataforma permite llamadas propias a una API, habrá terminado en diez minutos.
- Suena el teléfono el asistente descuelga
- El asistente pregunta por el número
- Haus iT Caller ID unifica el formato
- Su CRM o ERP consulta Sus datos de clientes se quedan aquí
- La conversación empieza con el nombre
- Transferencia a Webex el panel muestra a la misma persona
Primero: ¿puede hacerlo su plataforma?
Hacen falta tres cosas. Si falta una, el resto no sirve, y es mejor saberlo ahora que tras el tercer intento:
- Llamar a una interfaz externa durante la conversación. Según el proveedor se llama «function calling», «custom tool», «webhook tool» o «petición API»
- Fijar al hacerlo una cabecera propia. Sin ella la clave no viaja, y sin clave no hay información. Ahí es donde fallan la mayoría
- Usar la respuesta en el diálogo. Un asistente que solo la escribe en un registro nunca dice el nombre
Los cinco datos
Cada plataforma nombra los campos de otro modo, pero siempre son los mismos cinco:
- Dirección: `https://hausit-portal.de/api/anrufer`
- Método: `POST` — un número de teléfono no va en una dirección; acabaría en todos los registros de acceso
- Cabecera: `Authorization: Bearer SU_CLAVE` y `Content-Type: application/json`
- Cuerpo: `{"nummer": "+49…"}` — en la mayoría de las plataformas se genera solo a partir de la descripción de la función
- Descripción de la función: véase abajo
La descripción de la función
Este bloque le dice al asistente cuándo debe preguntar y cómo se llama el parámetro. Puede pegarse sin cambios; en su portal aparece otra vez listo para copiar.
El parámetro se llama `nummer`. Se prefiere el formato internacional (`+49…`), pero también se entienden otras notaciones.
Qué se recibe
- `treffer` — verdadero o falso. Si es falso, quien llama es desconocido; su asistente debería preguntar el nombre con normalidad y no fingir que lo conoce
- `name` y `firma` de su sistema
- `kundennummer`, si su sistema lo lleva
- `quelle` — de qué sistema procede la información
- `mehrdeutig` — verdadero si varios contactos comparten ese número
- `hinweis` — una frase para el asistente sobre cómo tratar el nombre
- `ansprache` — el mismo nombre, pero para decirlo: sin forma jurídica y con «y» en lugar de «&»
Un nombre para mostrar no es un nombre para decir
El panel de Webex muestra el nombre; su asistente lo dice. No es lo mismo: «Mustermann - Beispiel & Partner oHG» se lee en voz alta como «Mustermann guion Beispiel y Partner o-H-G».
Por eso junto a `name` está el campo `ansprache`: el mismo nombre sin forma jurídica, con la «y» escrita y sin guiones entre palabras. `name` no cambia: pertenece a la pantalla y a cualquier registro. Para saludar se usa `ansprache`; para referirse al registro, `name`.
Los dos campos que se pasan por alto
`mehrdeutig` y `hinweis` deben figurar en las instrucciones de su asistente. La razón: un nombre informa sobre la línea, no sobre la persona. Quien llama desde un despacho, una consulta o una centralita a menudo no es quien figura junto a ese número.
El asistente puede usar el nombre para dirigirse a quien llama. No sirve como acreditación: quien pida información sobre un cliente sigue teniendo que identificarse, por teléfono igual que en el mostrador.
Una clave por asistente
Cree para cada asistente una clave propia con su propia designación. El portal muestra entonces cuál pregunta y con qué frecuencia, y una sola clave puede revocarse sin apagar las demás.
La clave vale para un mandante. No es una limitación, sino la protección: un asistente que atiende para otra empresa no puede identificar contactos ajenos.
Si no funciona
En el portal hay una prueba de funcionamiento: introduce un número que conozca y ve exactamente la respuesta que recibiría un asistente. La clave no se comprueba ahí: no está en nuestro poder.
Si la prueba responde con un nombre y su asistente no, la causa está en la clave o en la dirección, no en los datos. Si la prueba tampoco responde, falta la conexión con su CRM: entonces el asistente no es el problema.
Si el sistema remoto no responde, la consulta se interrumpe tras 4,1 segundos como máximo. Su asistente no espera más de lo que una conversación tolera.
Preguntas frecuentes
¿Qué necesito para que mi asistente de voz sepa quién llama?
Una clave del portal de Haus iT y cinco datos en su asistente: dirección, método POST, una cabecera con la clave, el número en el cuerpo y una breve descripción de la función. Nada más.
¿Funciona con mi plataforma?
Si su asistente puede llamar a una interfaz externa durante la conversación y fijar una cabecera propia: sí. Si solo puede enviar un webhook después de la llamada, no basta: la respuesta llegaría tarde.
¿Cuánto cuesta la conexión?
El acceso forma parte del portal. Se factura el panel de Webex por usuario y mes; la interfaz para asistentes no se cobra aparte.
¿Se procesa el contenido de la llamada?
No. Recibimos un número de teléfono y respondemos con un nombre. Lo que se dice en la conversación no llega hasta nosotros.
¿Y si varios contactos comparten el mismo número?
La respuesta lo indica: el campo «mehrdeutig» (ambiguo) es entonces verdadero. En una centralita o una consulta, el nombre no dice nada sobre la persona que está al teléfono, y su asistente no debería tratarlo como acreditación.
¿Puedo conectar varios asistentes?
Sí, y conviene hacerlo: cada uno recibe su propia clave con su propia designación. Así las cifras del portal muestran cuál pregunta, y una sola clave puede revocarse sin apagar las demás.