API de llamadas telefónicas con IA: haz y contesta llamadas reales con un agente de IA

¿Qué es la API de Wixzel Voice para llamadas telefónicas con IA?

¿Cómo haces una llamada telefónica con IA con Wixzel Voice?

1. 01

   Conecta tu troncal SIP

   El host y las credenciales de tu operador. La contraseña se cifra en reposo y nunca se vuelve a devolver. La respuesta incluye platform_ip (hoy 187.126.120.231), que tu operador debe incluir en su lista de permitidos, y origination_uri (hoy sip:187.126.120.231:5090), adonde tu operador envía las llamadas entrantes.

   cURLCopiar

   curl https://api.voice.wixzel.com/v1/sip-trunks \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "My carrier",
       "host": "sip.carrier.example",
       "username": "acct123",
       "password": "..."
     }'

2. 02

   Registra un número de teléfono en ella

   Un número que ya tienes con ese operador, en formato E.164. Wixzel Voice no vende ni porta números. Si la troncal está conectada a tu cuenta de Twilio, Telnyx, Plivo, Vobiz o Vonage, puedes comprar un número nuevo en esa cuenta con POST /v1/phone-numbers/purchase. Tu operador te lo factura a su precio.

   cURLCopiar

   curl https://api.voice.wixzel.com/v1/phone-numbers \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "phone_number": "+14155550100",
       "sip_trunk_id": "'"$TRUNK_ID"'"
     }'

3. 03

   Crea un agente

   Unas instrucciones breves en estilo hablado, las primeras palabras que dice y una voz: tres modelos, o un modelo en tiempo real. opening_message es obligatorio, porque un agente sin él contesta en silencio. outbound_phone_number_id convierte el número del paso 2 en su identificador de llamada.

   cURLCopiar

   curl https://api.voice.wixzel.com/v1/agents \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Support",
       "system_prompt": "You are a concise support agent.",
       "opening_message": "Hi, how can I help?",
       "voice": {
         "stt": { "model": "deepgram/nova-3" },
         "llm": { "model": "openrouter/gpt-4o-mini" },
         "tts": { "model": "elevenlabs/eleven_flash_v2_5" }
       },
       "outbound_phone_number_id": "'"$NUMBER_ID"'"
     }'

4. 04

   Haz la llamada

   Un destino y un agente. Idempotency-Key es obligatorio, porque un tiempo de espera agotado en la red no dice nada sobre si la llamada se hizo: reintentar con la misma clave devuelve la llamada original en lugar de marcar dos veces. La respuesta es 201 con la llamada, status: "queued".

   cURLCopiar

   curl https://api.voice.wixzel.com/v1/calls \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Idempotency-Key: $(uuidgen)" \
     -H "Content-Type: application/json" \
     -d '{
       "to": "+14155551234",
       "agent_id": "'"$AGENT_ID"'"
     }'

Antes de que se conecte la primera llamada, tu operador tiene que incluir platform_ip en su lista de permitidos. Las guías de operadores muestran dónde está ese ajuste en Twilio, Telnyx, Plivo, Vonage, Bandwidth, Exotel, Vobiz, Mobily.

¿Cómo haces una llamada telefónica con IA desde TypeScript o Dart?

import { WixzelVoice } from 'wixzel-voice';

const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY! });

// 1. Connect your SIP trunk.
const trunk = await client.sipTrunks.create({
  name: 'My carrier',
  host: 'sip.carrier.example',
  username: 'acct123',
  password: process.env.CARRIER_PASSWORD!,
});
console.log('Allowlist', trunk.platform_ip, 'and send inbound calls to', trunk.origination_uri);

// 2. Register a number you own on it.
const number = await client.phoneNumbers.create({
  phone_number: '+14155550100',
  sip_trunk_id: trunk.id,
});

// 3. Create the agent, with that number as its caller ID.
const agent = await client.agents.create({
  name: 'Support',
  system_prompt: 'You are a concise support agent.',
  opening_message: 'Hi, how can I help?',
  voice: {
    stt: { model: 'deepgram/nova-3' },
    llm: { model: 'openrouter/gpt-4o-mini' },
    tts: { model: 'elevenlabs/eleven_flash_v2_5' },
  },
  outbound_phone_number_id: number.id,
});

// 4. Place the call. The SDK sends the Idempotency-Key for you.
const call = await client.calls.create({ to: '+14155551234', agent_id: agent.id });

// Inbound: calls to the number are answered by the same agent.
await client.phoneNumbers.update(number.id, { inbound_agent_id: agent.id });

// Later: what happened, what it cost, what was said.
const detail = await client.calls.retrieve(call.id);
console.log(detail.status, detail.cost_micros, detail.failure_code, detail.failure_reason);
for (const line of detail.transcript) console.log(line.role, line.content);

import 'dart:io';

import 'package:wixzel_voice/wixzel_voice.dart';

Future<void> main() async {
  final client = WixzelVoice(apiKey: Platform.environment['WIXZEL_API_KEY']!);

  // 1. Connect your SIP trunk.
  final trunk = await client.sipTrunks.create(CreateSipTrunk(
    name: 'My carrier',
    host: 'sip.carrier.example',
    username: 'acct123',
    password: Platform.environment['CARRIER_PASSWORD']!,
  ));
  print('Allowlist ${trunk.platformIp}; send inbound calls to ${trunk.originationUri}');

  // 2. Register a number you own on it.
  final number = await client.phoneNumbers.create(CreatePhoneNumber(
    phoneNumber: '+14155550100',
    sipTrunkId: trunk.id,
  ));

  // 3. Create the agent, with that number as its caller ID.
  final agent = await client.agents.create(CreateAgent(
    name: 'Support',
    systemPrompt: 'You are a concise support agent.',
    openingMessage: 'Hi, how can I help?',
    voice: VoiceConfig.composed(
      stt: const SttConfig(model: 'deepgram/nova-3'),
      llm: const LlmConfig(model: 'openrouter/gpt-4o-mini'),
      tts: const TtsConfig(model: 'elevenlabs/eleven_flash_v2_5'),
    ),
    outboundPhoneNumberId: number.id,
  ));

  // 4. Place the call. The SDK sends the Idempotency-Key for you.
  final call = await client.calls.create(CreateCall(
    to: '+14155551234',
    agentId: agent.id,
  ));

  // Inbound: calls to the number are answered by the same agent.
  await client.phoneNumbers.update(
      number.id, UpdatePhoneNumber(inboundAgentId: agent.id));

  // Later: what happened, what it cost, what was said.
  final detail = await client.calls.retrieve(call.id);
  print('${detail.status} ${detail.costMicros} ${detail.failureCode}');
  for (final line in detail.transcript) {
    print('${line.role}: ${line.content}');
  }
  client.close();
}

¿Cómo contesta llamadas entrantes un agente de IA en Wixzel Voice?

curl -X PATCH https://api.voice.wixzel.com/v1/phone-numbers/$NUMBER_ID \
  -H "Authorization: Bearer $WIXZEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "inbound_agent_id": "'"$AGENT_ID"'" }'

¿Qué devuelve un registro de llamada de Wixzel Voice?

¿Qué pasa cuando una llamada telefónica con IA no se conecta?

¿Cuánto cuesta una llamada telefónica con IA en Wixzel Voice?

Prepago: agrega crédito desde $5, sin suscripción ni plan gratuito. El motor más barato hoy es gemini-live, a $0.0491 por minuto. Calcula tu propia combinación.

¿Cuáles son los límites de la API de Wixzel Voice para llamadas telefónicas con IA?

• Wixzel Voice está en producción y atiende llamadas reales. Los cambios de comportamiento se publican detrás de un encabezado Wixzel-Version con fecha, y una clave existente conserva el comportamiento con el que se creó.
• Cinco llamadas simultáneas por cuenta de forma predeterminada, ampliables a petición. Las sesiones web y de app cuentan para el mismo límite.
• La transferencia a una persona solo es ciega: quien llama pasa directamente a un número que indicaste. La transferencia asistida no existe, y la transferencia no está disponible en llamadas de prueba ni en sesiones web o de app.
• Wixzel Voice no vende ni porta números de teléfono, y las llamadas telefónicas necesitan tu propia troncal SIP. Puede comprarte un número en tu propia cuenta de Twilio, Telnyx, Plivo, Vobiz o Vonage, facturado por tu operador.
• Las sesiones web y de app transmiten audio G.711 µ-law a 8 kHz, que es calidad telefónica, no de banda ancha.
• 10 solicitudes a la API por segundo por clave, con ráfagas de 20. Una solicitud limitada por tasa nunca se cobra.
• La API y los datos almacenados están en Bombay, India. Los proveedores de voz y lenguaje en Estados Unidos y la India procesan el audio y el texto mientras dura la llamada; el motor sarvam procesa la voz en la India.
• Sin plan gratuito ni crédito de prueba. La recarga mínima es de $5. El único uso gratuito son 5 minutos por cuenta para hablar con tus agentes desde la consola.

Adónde ir después