Saltar al contenido principal

​
API Tokens

Los tokens de API te permiten autenticarte con la API de Meetzy para acceso programático a tu cuenta. Usa tokens para integrar Meetzy con tus sistemas, disparar llamadas y recuperar datos.

​
Acceder a API Tokens

Navega a Account → API Tokens para ver y gestionar tus tokens.

​
Vista General de Tokens

Tus tokens de API se listan con:
CampoDescripción
NameIdentificador del token
TokenLa clave secreta (parcialmente oculta)
Expires InCuándo expirará el token

​
Guías de Seguridad

¡Mantén tus tokens de API en secreto!
  • Nunca compartas tokens con otros
  • Nunca expongas tokens en código del lado del cliente
  • Nunca hagas commit de tokens a control de versiones
  • Meetzy puede deshabilitar automáticamente tokens filtrados

​
Usando tu Token

​
Header de Autenticación

Incluye tu token en el header Authorization: 
curl -X POST https://api.meetzy.io/call \
  -H "Authorization: Bearer TU_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+1234567890", "playbook_id": "..."}'

​
Ejemplos en Código

const axios = require('axios');

const response = await axios.post('https://api.meetzy.io/call', {
  phone: '+1234567890',
  playbook_id: 'your-playbook-id'
}, {
  headers: {
    'Authorization': `Bearer ${process.env.MEETZY_API_TOKEN}`,
    'Content-Type': 'application/json'
  }
});

​
Copiando tu Token

  1. Encuentra el token en tu lista
  2. Haz clic en el botón Copy junto al token
  3. El botón cambia a “Copied!” cuando es exitoso
  4. Pega el token en tu aplicación
Solo los primeros 40 caracteres se muestran por seguridad. La función de copiar copia el token completo.

​
Expiración del Token

Los tokens tienen un período de expiración mostrado en la columna “Expires In”:
EstadoSignificado
X díasToken expira en X días
ExpiredToken ya no funciona
NeverToken no expira (no recomendado)

​
Antes de la Expiración

  1. Genera un nuevo token
  2. Actualiza tus aplicaciones
  3. El token antiguo sigue funcionando hasta expirar
  4. Prueba con el nuevo token antes de que expire el antiguo

​
Mejores Prácticas

Variables de Entorno

Almacena tokens en variables de entorno, nunca en código.

Rota Regularmente

Genera nuevos tokens periódicamente por seguridad.

Permisos Mínimos

Usa tokens solo donde sea necesario.

Monitorea Uso

Rastrea llamadas API para detectar acceso no autorizado.

​
Configuración de Variables de Entorno

export MEETZY_API_TOKEN="tu-token-aqui"

​
Permisos del Token

Los tokens de API tienen acceso completo a tu cuenta, incluyendo:
  • ✅ Crear y gestionar llamadas
  • ✅ Acceder al historial y detalles de llamadas
  • ✅ Gestionar agentes (playbooks)
  • ✅ Acceder a datos del CRM
  • ✅ Ver analíticas
El control granular de permisos llegará pronto. Actualmente, todos los tokens tienen acceso completo a la cuenta.

​
Solución de Problemas

ErrorSolución
401 UnauthorizedVerifica que el token sea correcto y no haya expirado
403 ForbiddenEl token puede estar deshabilitado, contacta a soporte
Token not workingAsegúrate de que no haya espacios extra al copiar
Rate limitedDemasiadas peticiones, implementa backoff

​
Si tu Token es Comprometido

  1. Inmediatamente ve a la página de API Tokens
  2. Contacta a soporte para deshabilitar el token
  3. Genera un nuevo token
  4. Actualiza todas las aplicaciones
  5. Revisa la actividad reciente de API para llamadas sospechosas

​
Crear Nuevos Tokens

La creación de tokens actualmente es gestionada por soporte de Meetzy. Contáctanos para solicitar tokens adicionales.
La futura creación self-service de tokens incluirá:
  • Nombres de token personalizados
  • Configuración de expiración
  • Alcances de permisos
  • Límites de uso

​
Siguientes Pasos

API Reference

Aprende sobre los endpoints de API disponibles.

Crear una Llamada

Haz tu primera llamada a la API.