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:
Autenticación Todas las peticiones de API requieren autenticación usando un token Bearer.
Obtener tu Token de API
Inicia sesión en tu Dashboard de Meetzy
Navega a Account → API Tokens
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.
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" } }
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ódigo Descripción 200 Éxito 201 Creado 400 Bad Request - Parámetros inválidos 401 Unauthorized - Token inválido o faltante 403 Forbidden - Permisos insuficientes 404 Not Found - El recurso no existe 429 Too Many Requests - Rate limited 500 Internal Server Error
Rate Limiting Las peticiones de API tienen límite de tasa para asegurar uso justo:
Estándar : 100 peticiones por minutoRá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:
Node.js (axios)
Python (requests)
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? 
