Skip to main content

Llamadas

Todas las solicitudes a la API de Fonema deben realizarse al endpoint base: https://api.fonema.ai/

Iniciar una llamada​

Endpoint​

POST /v2/initiate-call

Inicia una llamada telefónica automatizada utilizando uno de tus agentes.

Request Body​

{
    "agentId": "Ales-VLP5QKP1",
    "customer": {
        "name": "Juan Pérez",
        "phoneNumber": "+525581354511",
        "email": "juan.perez@ejemplo.com"
    },
    "delay": 30,
    "variableValues": {
        "montoDeuda": "30000",
        "numeroReferencia": "REF-12345"
    }
}

Parámetros​

agentId (string, required)​

  • Descripción: Identificador único del agente que realizará la llamada
  • Cómo obtenerlo: Encuentra este valor en tu dashboard de Fonema, debajo del nombre de cada agente
  • Ejemplo: "Ales-VLP5QKP1"

Ubicación del Agent ID

customer (object)​

Información del cliente que recibirá la llamada:

  • phoneNumber (string, required): Número telefónico en formato E.164 (incluyendo código de país)
  • name (string, optional): Nombre completo del cliente.
  • email (string, optional): Dirección de correo electrónico del cliente.

delay (integer, optional)​

  • Descripción: Tiempo de espera en segundos antes de iniciar la llamada.

variableValues (object, optional)​

  • Descripción: Variables personalizadas que serán utilizadas durante la llamada.
  • Formato: Pares clave-valor donde la clave corresponde al nombre de la variable definida en tu agente.
  • Ejemplo:
{
    "montoDeuda": "30000",
    "fechaVencimiento": "2023-12-31",
    "numeroCliente": "CLT-78901"
}

Ejemplo de Solicitud​

curl -X POST "https://api.fonema.ai/v2/initiate-call" \
  -H "Authorization: Bearer TU_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "Ales-VLP5QKP1",
    "customer": {
        "name": "María García",
        "phoneNumber": "+525599999999",
        "email": "maria.garcia@ejemplo.com"
    },
    "delay": 45,
    "variableValues": {
        "montoDeuda": "15000",
        "producto": "Tarjeta de Crédito Gold"
    }
}'

📋 Consideraciones Importantes​

  • Formato de teléfono: Siempre incluye el código de país (ej: +52 para México)
  • Variables requeridas: Asegúrate de incluir todas las variables que tu agente espera recibir