En esta página
GUÍA PARA AGENTES DE IA Próxima beta abierta
Conecta tu
agente de IA.
Tú preguntas. Tu agente prepara la solicitud. CallAlternative hace la llamada y te devuelve la respuesta.
01 / CONFIGURA
Conecta tu agente
CallAlternative usa MCP: un método común para que una aplicación de IA descubra herramientas y les solicite una tarea. Tu aplicación debe admitir MCP mediante Streamable HTTP con autorización OAuth.
GPT, Claude y Gemini ilustran flujos de trabajo con agentes compatibles. La configuración depende de tu aplicación; esta versión no incluye conectores nativos para aplicaciones de chat.
Antes de empezar
- Una suscripción Max activa y una cuenta con el correo verificado.
- Saldo de llamadas y un destino al que tu cuenta pueda llamar.
- Una aplicación de agente compatible con la conexión configurada.
Basic y Basic Plus no incluyen acceso a agentes de IA ni a MCP.
Comprobando la disponibilidad de la conexión…
- Añade la dirección del servidor MCP disponible a tu aplicación de agente compatible.
- Elige la opción de conectar o autorizar. Inicia sesión en CallAlternative cuando se te solicite.
- Revisa la aplicación, la dirección de retorno y los permisos. Selecciona Conectar para volver a tu agente automáticamente.
Nunca necesitas copiar tokens de acceso. Tu agente gestiona sus propias credenciales de conexión después de tu aprobación. Gestiona o desconecta aplicaciones en Agentes conectados.
Nunca pegues credenciales en instrucciones o URL, ni extraigas tokens de tu navegador. Aprueba solo aplicaciones y direcciones de retorno que reconozcas.
Elegir y cambiar permisos
Las conexiones son de solo lectura por defecto. Si tu agente solicita acceso a llamadas, puedes seleccionar Permitir llamadas antes de conectar. En Agentes conectados, puedes desactivar las llamadas inmediatamente y mantener el acceso de lectura. Para volver a permitirlas, conecta de nuevo desde tu agente, solicita calls:write y apruébalo. Las llamadas en curso continúan al quitar este permiso.
Gestionar permisos del agenteComprueba la conexión sin hacer una llamada
Primero, pide a tu aplicación que descubra las herramientas disponibles en el servidor (tools/list en MCP). Después, comprueba tu cuenta y el destino. Estos ejemplos son invocaciones de herramientas MCP, no ajustes de conexión.
{
"name": "account_get_status",
"arguments": {}
}{
"name": "calling_preflight",
"arguments": {
"to": "+12025550100"
}
}{
"name": "calls_list",
"arguments": {
"limit": 10
}
}El número del ejemplo es ficticio. Sustitúyelo por el destinatario previsto y autorizado. Una comprobación de conexión correcta no habilita las llamadas de la beta.
02 / PREGUNTA
Empieza con una pregunta
Haz que tu primera solicitud sea sencilla. Por ejemplo:
«Llama al restaurante y pregunta si abre hoy».
- Confirma el destinatario. Tu agente comprueba el número y si tu cuenta puede llamarlo.
- Confirma la solicitud. Da permiso a tu agente para realizar esta llamada concreta.
- Conserva el ID de la llamada. Cuando las llamadas estén habilitadas, tu agente envía la solicitud y usa el ID recibido para seguirla.
{
"name": "call_create_with_goal",
"arguments": {
"destination": "+12025550100",
"goal": "Are you open today?",
"maxDurationSeconds": 30,
"idempotencyKey": "<unique-operation-UUID>"
}
}Es solo un ejemplo; esta página no ejecuta nada. Sustituye el número ficticio y la clave de ejemplo antes de usarlo en tu agente configurado.
Límites de las preguntas y reintentos seguros
Usa una sola pregunta en inglés, de hasta 220 caracteres ASCII. El agente de llamadas actual habla inglés (en-US). La duración es un límite solicitado, no una parada exacta garantizada; tu saldo o elegibilidad pueden reducirla.
Genera un UUID único para cada operación nueva. Si una solicitud agota el tiempo de espera y se desconoce el resultado, reinténtala con la misma clave de idempotencia y argumentos idénticos. No crees una clave nueva ni vuelvas a llamar automáticamente.
Una respuesta en cola no demuestra que el teléfono haya sonado. Consulta el ID recibido para ver el progreso y los resultados.
03 / RECIBE LA RESPUESTA
Averigua qué ocurrió
Abre Llamadas para ver las respuestas capturadas y las transcripciones disponibles. Tu agente puede obtenerlas mediante MCP usando el mismo ID de llamada.
call_getcall_get_resultCompletada significa que la llamada terminó. Consulta la respuesta capturada y el resultado de la acción para saber si alguien respondió y se cumplió tu solicitud.
Consulta los resultados en tu agente
{
"name": "call_get",
"arguments": {
"callId": "<returned-call-id>"
}
}{
"name": "call_get_result",
"arguments": {
"callId": "<returned-call-id>"
}
}answerCapture.status puede ser pending, captured, no_answer o unavailable. Si está pendiente, vuelve a consultar el mismo ID más tarde o recarga Llamadas.
Para las acciones, consulta result.outcome.status: confirmed, not_completed, needs_user_input o unknown. Los resultados comunicados por el proveedor usan source: provider_report y independentlyVerified: false. Puede haber una cita textual capturada aunque el resultado sea desconocido.
Si el resultado no está claro, pregunta al usuario qué hacer a continuación. No vuelvas a llamar automáticamente.
Finaliza una llamada cuando lo pida el usuario
Confirma qué llamada debe terminar y usa su ID y una clave de operación independiente.
{
"name": "call_hangup",
"arguments": {
"callId": "<returned-call-id>",
"idempotencyKey": "<separate-operation-UUID>"
}
}También una acción sencilla
Pide a tu agente que confirme o cambie una reserva, o que cancele una cita. Debe recopilar los datos que falten y obtener tu aprobación antes de llamar.
«Llama al salón y cancela la cita de Alex Rivera».
Acciones admitidas y datos necesarios
Las solicitudes en lenguaje natural pueden ser breves. La acción enviada exige actualmente tanto la referencia como el nombre del cliente. Tu agente debe pedirlos si faltan; un nombre por sí solo no basta para la acción estructurada.
| Tipo de acción | Objetivo (en inglés) |
|---|---|
confirm_reservation | Confirm the reservation. |
reschedule_reservation | Reschedule the reservation. |
cancel_appointment | Cancel the appointment. |
Solo se admiten solicitudes sin cargos y dentro de los detalles aprobados. No autorices cargos, pagos, alternativas no aprobadas ni condiciones adicionales. Para cambiar una reserva se necesita una fecha futura, una hora y una zona horaria inequívocas.
{
"name": "call_create_with_goal",
"arguments": {
"destination": "+12025550100",
"goal": "Reschedule the reservation.",
"maxDurationSeconds": 120,
"idempotencyKey": "<unique-operation-UUID>",
"action": {
"type": "reschedule_reservation",
"userAuthorized": true,
"target": {
"reference": "<reservation-reference>",
"customerName": "Alex Rivera"
},
"requestedSlot": {
"localDate": "2027-04-20",
"localTime": "19:00",
"timeZone": "America/New_York"
}
}
}
}Sustituye los datos de ejemplo y comprueba que la fecha del ejemplo siga siendo futura. Establece userAuthorized solo después de que el usuario apruebe esta acción concreta. Un callerName opcional cambia la presentación hablada (por defecto se usa el nombre de pila de la cuenta); no sustituye el nombre del cliente de la acción.
Las herramientas de tu agente
Descubre las herramientas disponibles en tu conexión antes de usarlas. Su disponibilidad depende de tu cuenta y de las funciones de la beta habilitadas.
| Herramienta | Qué hace |
|---|---|
account_get_statusLectura | Comprueba tu cuenta, tu plan y si puedes realizar llamadas. |
calling_preflightLectura | Comprueba un destino antes de llamar. No realiza ninguna llamada. |
calls_listLectura | Busca llamadas recientes y sus ID. |
call_getLectura | Comprueba el progreso de una llamada. |
call_get_resultLectura | Consulta las respuestas, transcripciones y resultados de acciones disponibles. |
call_create_with_goalRealiza una llamada | Realiza una llamada con una pregunta o una acción admitida cuando las llamadas de la beta estén habilitadas. |
call_hangupFinaliza una llamada | Finaliza una llamada que hayas confirmado que debe terminar. |
calling_request_country_accessEnvía una solicitud | Envía una solicitud de acceso a un país. No concede acceso ni realiza una llamada. |
Un mismo saldo. Una tarifa diferente.
Las llamadas con IA usan tu saldo compartido de minutos. Redondeamos el tiempo conectado al siguiente minuto completo y después descontamos 10 minutos de llamada por minuto. Las llamadas desde el navegador mantienen su tarifa habitual.
Una llamada no contestada y sin conexión consume cero minutos. Una conexión al buzón de voz cuenta como tiempo conectado. El acceso a agentes de IA requiere Max.
Revisa tu plan y saldoAyuda si algo no funciona
Mi plan no es válido o no tengo saldo
El acceso a agentes de IA requiere Max, un correo verificado y saldo de llamadas. Revisa tu cuenta en Facturación. Cambiar de plan no activa la próxima beta.
La conexión indica que no está autorizada o que ha caducado
Inicia de nuevo la conexión desde tu aplicación de agente e inicia sesión para aprobar el acceso. Puedes desconectar aplicaciones antiguas en Agentes conectados. Nunca compartas credenciales en el chat.
No encuentro una herramienta
Actualiza el descubrimiento de herramientas en tu aplicación configurada. Comprueba que admita MCP mediante Streamable HTTP con autorización OAuth. La herramienta puede no estar habilitada para tu cuenta o la beta actual.
Hay otra llamada activa o una solicitud agotó el tiempo de espera
Consulta la llamada existente y espera a que termine. Reintenta una operación incierta solo con su clave original y argumentos idénticos. Una clave nueva puede crear otra llamada.
La llamada terminó, pero la respuesta sigue pendiente
Consulta el mismo ID de llamada con call_get_result, o recarga Llamadas. Algunas respuestas o transcripciones pueden no estar disponibles. No realices otra llamada automáticamente.