Tres cosas, en dos pantallas. La tercera es la que todo el mundo se salta, y saltársela produce una línea telefónica que contesta de forma convincente mientras no hace nada de tu trabajo.
Un número
/phone-numbers → Comprar un número. Eliges un país y luego seleccionas entre los Números disponibles. Es el camino rápido y se completa en un minuto aproximadamente.
La alternativa es Traiga su propio número de Twilio, o una conexión de operador completa si ya tienes una. Ese flujo tiene cuatro pasos — Operador, Conexión, Números, Verificación — y pide datos SIP que te da tu operador: Host SIP, Puerto SIP, Transporte, Usuario SIP, Contraseña SIP, ID de llamada, y un Formato de marcación con prefijo y sufijo opcionales.
Dos cosas sobre el camino del operador que conviene saber antes de empezar:
- Necesita un propietario o administrador. “Agregar un operador requiere ser propietario o administrador. No se creó nada.”
- Un fallo no deja desorden. Si la configuración falla a medias, recibes “La configuración no se completó: no quedó nada a medio configurar.” Tus datos siguen rellenos, así que reintentar no supone volver a escribir nada.
El formato de marcación importa más de lo que parece. Algunos operadores quieren formato nacional, y enviar E.164 a uno que espera formato nacional es una configuración que se valida sin problemas y luego falla en el momento de marcar.
Un agente
/agents → crea uno. Como mínimo necesita un nombre y un prompt de sistema — “El nombre del agente y el prompt del sistema son obligatorios.” — y un saludo, Lo primero que dice su agente.
Todo lo demás del agente (voz, pipeline, conocimiento) puede esperar. Lo que no puede esperar es que este agente exista antes de vincular el número, porque la vinculación es el siguiente paso.
La vinculación entre ambos
Este es el paso que se salta.
En /phone-numbers, el número debería decir «… atiende este canal» con el nombre de tu agente. En /agents, la sección Implementación debería mostrar Se implementó en … en lugar de Sin implementar o Sin canal de voz.
Si alguno de los dos dice otra cosa, tienes un número y un agente y ninguna conexión entre ellos.
Por qué un número sin vincular también contesta
Aquí está la trampa. Un número conectado contesta antes de que hayas vinculado nada. Un agente de prueba descuelga, suena plausible y no sabe nada de tu negocio.
Así que «llamé y alguien contestó» no es evidencia de que la configuración funcionó. Es evidencia de que el número está conectado, que era la mitad fácil. La comprobación que significa algo es el saludo: si oyes Lo primero que dice su agente, has entrado. Si oyes cualquier otra cosa, falta la vinculación.
Esto cuesta a la gente más tiempo que todos los demás puntos de esta página juntos, porque el síntoma del fallo es una llamada telefónica que funciona.
Un teléfono para probar
No el navegador. /agents ofrece una Iniciar prueba de micrófono — “Prueba de micrófono con WebRTC. No se necesita teléfono: hable con el agente directamente desde esta página.” — y es genuinamente útil para comprobar qué dice el agente.
No prueba el camino telefónico. La pantalla lo dice ella sola: “WebRTC funciona para pruebas en el navegador. Las rutas telefónicas necesitan un número.” Que la prueba de micrófono pase te dice que el agente funciona; no te dice nada sobre si las llamadas llegan hasta él.
Usa Llame a este número para probar y llámalo desde un teléfono de verdad.
Una zona horaria
Configura la zona horaria del espacio de trabajo antes de que nada empiece a programarse solo. Es el valor por defecto que leerá cada función posterior, y corregirla después no arregla retroactivamente nada que ya se haya ejecutado con la equivocada.