Skip to main content
Los tokens API te permiten acceder programáticamente a la API de Meetzy. Estos tokens funcionan como llaves secretas que autentican tus solicitudes automáticamente.
Los tokens API son credenciales sensibles. Nunca los compartas públicamente ni los expongas en código del lado del cliente. Guárdalos de forma segura como variables de entorno.

​
Gestión de Tokens

​
Acceder al Gestor de Tokens

  1. Navega a tu Panel de Cuenta
  2. Selecciona API Tokens en el menú lateral
  3. Verás una lista de todos tus tokens activos
El gestor de tokens muestra:
  • Nombre del token: Identificador descriptivo
  • Token enmascarado: Primeros caracteres visibles para identificación
  • Fecha de expiración: Cuándo expira el token
  • Estado: Activo o revocado

​
Crear un Nuevo Token

1

Abrir modal de creación

Haz clic en el botón “New Token” en la esquina superior derecha del gestor de tokens.
2

Configurar el token

  • Nombre: Asigna un nombre descriptivo (ej: “API Producción”, “Webhook Desarrollo”)
  • Expiración: Selecciona el período de validez:
    • 30 días
    • 90 días
    • 6 meses
    • 1 año
    • Sin expiración (4 años)
3

Validación del nombre

El nombre del token debe:
  • Tener al menos 2 caracteres
  • Ser único en tu cuenta
  • Ser descriptivo para facilitar la gestión
4

Crear y copiar

  1. Haz clic en “Create Token”
  2. Copia inmediatamente el token completo
  3. Guárdalo en un lugar seguro
El token completo solo se muestra una vez por seguridad. Si no lo copias ahora, tendrás que crear uno nuevo.

​
Estado Después de la Creación

Una vez creado exitosamente, verás:
  • ✅ Icono de éxito y nombre del token
  • ⚠️ Advertencia de seguridad destacada
  • 🔑 Token completo en formato copiable
  • 📋 Botón “Copy” que cambia a “Copied!” tras el clic

​
Información Importante

  • El token se agrega automáticamente a tu lista
  • El modal permanece abierto para que copies el valor
  • Puedes cerrar el modal haciendo clic fuera o en el botón cerrar

​
Revocar Tokens

​
Proceso de Revocación

1

Identificar el token

En la lista de tokens, localiza el que deseas revocar.
2

Iniciar revocación

Haz clic en el icono de papelera (🗑️) que aparece al pasar el cursor sobre el token.
3

Confirmar acción

Se abrirá un modal de confirmación mostrando:
  • Nombre del token a revocar
  • Advertencia sobre la irreversibilidad
  • Botones “Cancel” y “Revoke Token”
4

Completar revocación

Haz clic en “Revoke Token” para confirmar. El token será eliminado inmediatamente.
La revocación de tokens es inmediata e irreversible. Todas las solicitudes API que usen ese token fallarán instantáneamente.

​
Funciones de la Interfaz

​
Copiado Rápido

  • Icono de copia (📋) junto a cada token enmascarado
  • Feedback visual: el botón cambia a “Copied!” con ícono de check
  • Copia automática al portapapeles del sistema

​
Tokens Enmascarados

Los tokens se muestran parcialmente para seguridad:
  • Primeros 24 caracteres visibles para identificación
  • Resto oculto con puntos para protección

​
Estados Visuales

  • Punto verde: Token activo
  • Hover effects: Resaltan las acciones disponibles
  • Contador: “X active token(s)” en el footer

​
Estado Vacío

Cuando no tienes tokens configurados:
  • Ilustración central con ícono de llave
  • Mensaje guía: “No tokens yet”
  • Descripción: Explica el propósito de los tokens
  • CTA prominente: “Create your first token”

​
Conectar por MCP

Además de usarlos directamente contra la API REST, tus tokens API sirven para conectar Meetzy a cualquier cliente compatible con MCP (Model Context Protocol), como Claude, Cursor o ChatGPT. Esto le da al asistente acceso directo a tus llamadas, conversaciones de WhatsApp, evaluaciones y analíticas, todo autenticado con el mismo token que ya generaste arriba.
El servidor MCP de Meetzy usa transporte Streamable HTTP, por lo que no necesitas instalar nada localmente ni ejecutar un proceso intermedio: basta con apuntar tu cliente a la URL del servidor e incluir tu token como cabecera Authorization.

​
URL del servidor MCP

En la sección “Conectar por MCP” del gestor de tokens encontrarás la URL de tu servidor MCP, lista para copiar con el botón dedicado. Junto a ella también verás un botón para copiar un snippet de configuración ya completo con tu token (si acabas de crear uno) o con un marcador YOUR_API_TOKEN para que lo reemplaces manualmente.

​
Configurar tu cliente

1

Abrir la configuración de MCP

En Cursor, ve a Settings → MCP y selecciona “Add new MCP server”.
2

Pegar la configuración

Añade un bloque como el siguiente, reemplazando YOUR_API_TOKEN por el token que copiaste al crearlo:
3

Guardar y verificar conexión

Guarda los cambios. Cursor debería mostrar el servidor meetzy como conectado, y sus herramientas quedarán disponibles en el chat.
Cualquier cliente MCP que conectes con tu token tendrá el mismo nivel de acceso que ese token te otorga a ti. Usa tokens dedicados y con nombres descriptivos (ej: mcp-cursor, mcp-claude) para poder revocarlos individualmente sin afectar otras integraciones.

​
Mejores Prácticas

Gestión Segura de Tokens:
  • Usa nombres descriptivos que indiquen el propósito
  • Establece fechas de expiración apropiadas
  • Revoca tokens no utilizados regularmente
  • Nunca hardcodees tokens en tu código fuente

​
Organización Recomendada

  • Producción: api-prod-2024 - Sin expiración
  • Desarrollo: api-dev-enero - 90 días
  • Testing: api-test-temp - 30 días
  • Webhooks: webhook-payments - 1 año
  • MCP: mcp-cursor, mcp-claude, mcp-chatgpt - según necesidad de cada cliente

​
Rotación de Tokens

  1. Crea un nuevo token antes de que expire el anterior
  2. Actualiza todas las integraciones con el nuevo token
  3. Verifica que funcionen correctamente
  4. Revoca el token anterior
El sistema te notificará cuando los tokens estén próximos a expirar para facilitar la rotación proactiva.