Saltar al contenido principal

Llamadas

Iniciar una llamada

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

Autenticación​

AuthorizationBearer

Autentica las solicitudes desde tu servidor con una API Key de Fonema. Créala en la sección de API Keys del Dashboard y envíala en el encabezado Authorization como Bearer <token>. No pongas tus claves en código del navegador ni en repositorios públicos.

Cuerpo​

agentIdstringObligatorio

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"

customerobject

Información del cliente que recibirá la llamada.

customer.phoneNumberstringObligatorio

Número telefónico en formato E.164 (incluyendo código de país)

customer.namestringOpcional

Nombre completo del cliente.

customer.emailstringOpcional

Dirección de correo electrónico del cliente.

delayintegerOpcional

Tiempo de espera en segundos antes de iniciar la llamada.

variableValuesobjectOpcional

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"
}

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