CallAlternative
Ir a la guía
← Llamadas con IACallAlternative / Guía para agentes
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 Conecta02 Pregunta03 Recibe la respuesta
Prepárate para la beta. Las conexiones con agentes solo están disponibles donde estén habilitadas. Crear una cuenta, conectar un agente o cambiar a Max no activa las llamadas de la beta.
Empieza por la conexión

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…

  1. Añade la dirección del servidor MCP disponible a tu aplicación de agente compatible.
  2. Elige la opción de conectar o autorizar. Inicia sesión en CallAlternative cuando se te solicite.
  3. 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 agente
Comprueba 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.

Comprueba el acceso a la cuenta
{
  "name": "account_get_status",
  "arguments": {}
}
Comprueba un destino
{
  "name": "calling_preflight",
  "arguments": {
    "to": "+12025550100"
  }
}
Lista las llamadas recientes
{
  "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».
  1. Confirma el destinatario. Tu agente comprueba el número y si tu cuenta puede llamarlo.
  2. Confirma la solicitud. Da permiso a tu agente para realizar esta llamada concreta.
  3. 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.
Invocación de herramienta MCP · hacer una pregunta
{
  "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.

Progreso de la llamadacall_get
Respuesta y resultadocall_get_result

Completada 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
Comprueba el progreso de la llamada
{
  "name": "call_get",
  "arguments": {
    "callId": "<returned-call-id>"
  }
}
Consulta el resultado de la llamada
{
  "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.

Finaliza la llamada confirmada
{
  "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.

Usa el tipo de acción correspondiente y el objetivo exacto en inglés
Tipo de acciónObjetivo (en inglés)
confirm_reservationConfirm the reservation.
reschedule_reservationReschedule the reservation.
cancel_appointmentCancel 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.

Invocación de herramienta MCP · cambiar una reserva
{
  "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.

Referencia de herramientas MCP
HerramientaQué hace
account_get_statusLecturaComprueba tu cuenta, tu plan y si puedes realizar llamadas.
calling_preflightLecturaComprueba un destino antes de llamar. No realiza ninguna llamada.
calls_listLecturaBusca llamadas recientes y sus ID.
call_getLecturaComprueba el progreso de una llamada.
call_get_resultLecturaConsulta las respuestas, transcripciones y resultados de acciones disponibles.
call_create_with_goalRealiza una llamadaRealiza una llamada con una pregunta o una acción admitida cuando las llamadas de la beta estén habilitadas.
call_hangupFinaliza una llamadaFinaliza una llamada que hayas confirmado que debe terminar.
calling_request_country_accessEnvía una solicitudEnví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.

30 segundos de conexión10 minutos de llamada
61 segundos de conexión20 minutos de llamada

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 saldo

Ayuda 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.

Guía para agentes de IA | CallAlternative