v1.2 RESTful API

Integre IA en minutos,
no en meses.

Conecte nuestra infraestructura de agentes de voz y flujos de WhatsApp directamente a su base de datos o aplicación personalizada con solo unas pocas líneas de código.

Obtener API Keys Privadas

< 200ms Latencia de Respuesta

99.99% Uptime Garantizado

E2EE Datos Encriptados

Autenticación Segura

La API de Converzia utiliza claves API (API Keys) estandarizadas para autenticar las peticiones. Todas las solicitudes deben realizarse a través de HTTPS.

Deberá incluir su clave en el encabezado (Header) de la petición HTTP bajo el esquema Authorization: Bearer.

// Ejemplo de Encabezado HTTP

Authorization: Bearer cvz_live_8f7d6a...
Content-Type: application/json

Terminal de Desarrollo

# Iniciar una llamada automatizada de IA a un lead
curl -X POST https://api.converzia.ai/v1/voice/call \
  -H "Authorization: Bearer cvz_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "ag_9a8b7c6d",
    "customer": {
      "phone": "+51999888777",
      "name": "Carlos Mendoza"
    },
    "context": {
      "product_interest": "Suscripción Enterprise"
    }
  }'

# Disparar un flujo o plantilla de WhatsApp
curl -X POST https://api.converzia.ai/v1/wa/send \
  -H "Authorization: Bearer cvz_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+51999888777",
    "template_name": "abandoned_cart_v1",
    "variables": ["Carlos", "Laptop Pro M2"]
  }'

const axios = require('axios');

// Iniciar llamada mediante Node.js
axios.post('https://api.converzia.ai/v1/voice/call', {
  agent_id: 'ag_9a8b7c6d',
  customer: {
    phone: '+51999888777',
    name: 'Carlos Mendoza'
  },
  context: {
    product_interest: 'Suscripción Enterprise'
  }
}, {
  headers: { 'Authorization': 'Bearer cvz_live_YOUR_KEY' }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

const axios = require('axios');

// Disparar flujo de WhatsApp en Node.js
axios.post('https://api.converzia.ai/v1/wa/send', {
  phone: '+51999888777',
  template_name: 'abandoned_cart_v1',
  variables: ['Carlos', 'Laptop Pro M2']
}, {
  headers: { 'Authorization': 'Bearer cvz_live_YOUR_KEY' }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

Eventos Asíncronos (Webhooks)

Converzia no lo hace esperar. Configure webhooks en su panel para recibir actualizaciones en tiempo real sobre el estado de las llamadas, transcripciones y acciones de los clientes directamente en su servidor.

call.completed Se dispara cuando la IA termina la llamada. Incluye duración y metadatos.
transcription.ready Se envía con el resumen textual y el análisis de sentimiento del lead.
wa.flow.finished Avisa que el prospecto completó un árbol de decisiones en WhatsApp.

⚡

Push en Tiempo Real

Reciba cargas JSON masivas (Payloads) al instante para actualizar su CRM sin necesidad de consultar (polling) la API repetidamente.

¿Listo para integrar la IA en su código?

Nuestros arquitectos técnicos están disponibles para revisar su diagrama de flujo y proporcionarle credenciales de Sandbox (Pruebas).