Introducción

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

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.

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ó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 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'
  }
});

import requests

headers = {
    'Authorization': f'Bearer {API_TOKEN}',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://api.meetzy.io/calls',
    headers=headers
)

¿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.

API Reference

Endpoints

Características Avanzadas

Bienvenido a la API de Meetzy

URL Base

Autenticación

Obtener tu Token de API

Usar tu Token

Formato de Petición

Formato de Respuesta

Respuestas de Error

Códigos de Estado HTTP

Rate Limiting

SDKs y Librerías

¿Necesitas Ayuda?

Crear una Llamada

Crear una Campaña

Obtener Detalles de Llamada

Listar Llamadas

Soporte

​Bienvenido a la API de Meetzy

​URL Base

​Autenticación

​Obtener tu Token de API

​Usar tu Token

​Formato de Petición

​Formato de Respuesta

​Respuestas de Error

​Códigos de Estado HTTP

​Rate Limiting

​SDKs y Librerías

​¿Necesitas Ayuda?

Crear una Llamada

Crear una Campaña

Obtener Detalles de Llamada

Listar Llamadas

Soporte

Bienvenido a la API de Meetzy

URL Base

Autenticación

Obtener tu Token de API

Usar tu Token

Formato de Petición

Formato de Respuesta

Respuestas de Error

Códigos de Estado HTTP

Rate Limiting

SDKs y Librerías

¿Necesitas Ayuda?