Saltar al contenido principal

​
Bienvenido a la API de Meetzy

La API de Meetzy te permite iniciar llamadas programáticamente, recuperar datos de llamadas e integrar agentes de voz con IA en tus sistemas existentes.

​
URL Base

Todas las peticiones de API se hacen a: 
https://api.meetzy.io

​
Autenticación

Todas las peticiones de API requieren autenticación usando un token Bearer.

​
Obtener tu Token de API

  1. Inicia sesión en tu Dashboard de Meetzy
  2. Navega a Account → API Tokens
  3. Copia tu token de API

​
Usar tu Token

Incluye el token en el header Authorization: 
curl -X GET https://api.meetzy.io/calls \
  -H "Authorization: Bearer TU_API_TOKEN" \
  -H "Content-Type: application/json"
Mantén tu token de API en secreto. Nunca lo expongas en código del lado del cliente o repositorios públicos.

​
Formato de Petición

Todas las peticiones deben incluir el header Content-Type: application/json al enviar datos. 
{
  "phone": "+1234567890",
  "playbook_id": "pb_abc123",
  "params": {
    "customer_name": "Juan García"
  }
}

​
Formato de Respuesta

Todas las respuestas se devuelven en formato JSON: 
{
  "success": true,
  "data": {
    "call_id": "call_xyz789",
    "status": "initiated"
  }
}

​
Respuestas de Error

Los errores incluyen un código de error y mensaje: 
{
  "success": false,
  "error": {
    "code": "invalid_phone",
    "message": "El número de teléfono proporcionado es inválido"
  }
}

​
Códigos de Estado HTTP

CódigoDescripción
200Éxito
201Creado
400Bad Request - Parámetros inválidos
401Unauthorized - Token inválido o faltante
403Forbidden - Permisos insuficientes
404Not Found - El recurso no existe
429Too Many Requests - Rate limited
500Internal Server Error

​
Rate Limiting

Las peticiones de API tienen límite de tasa para asegurar uso justo:
  • Estándar: 100 peticiones por minuto
  • Ráfaga: 10 peticiones por segundo
Cuando excedas el límite, recibirás una respuesta 429 con información de reintento.

​
SDKs y Librerías

SDKs oficiales próximamente. Mientras tanto, usa cualquier cliente HTTP: 
const axios = require('axios');

const client = axios.create({
  baseURL: 'https://api.meetzy.io',
  headers: {
    'Authorization': `Bearer ${process.env.MEETZY_API_TOKEN}`,
    'Content-Type': 'application/json'
  }
});

​
¿Necesitas Ayuda?

Crear una Llamada

Aprende cómo iniciar llamadas via API.

Crear una Campaña

Lanza campañas de llamadas salientes desde una lista de contactos.

Obtener Detalles de Llamada

Recupera información detallada de llamadas.

Listar Llamadas

Recupera tu historial de llamadas.

Soporte

Contacta a nuestro equipo de soporte.