API Keys

Volver a Docs

Las API Keys te permiten conectar Wazimodo con tus sistemas (CRM, bots, automatizaciones) de forma segura.

¿Qué es una API Key?

Es una clave privada que autoriza a tu aplicación a usar la API de Wazimodo. Funciona como una contraseña para tus integraciones.

Crear una API Key

1. Inicia sesión en Wazimodo.
2. Ve a Perfil (menú superior o /perfil).
3. En API Keys, haz clic en Nueva API Key.
4. Asigna un nombre descriptivo (ej. “CRM Ventas” o “Bot Soporte”).
5. Copia la clave y guárdala en un lugar seguro.

Importante: por seguridad, la clave completa solo se muestra una vez.

Formato de la clave

Las claves tienen este formato:

wz_[35 caracteres aleatorios]

Ejemplo:

wz_A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6Q7r8S9t0

Usar tu API Key

Incluye la clave en el header X-API-Key en cada petición a la API:

POST /api/v1/instancia-123/message/text
Host: wazimodo.tu-dominio.com
X-API-Key: wz_tu_clave_secreta_aqui
Content-Type: application/json

Revocar o rotar una clave

Si una clave se filtra o ya no la necesitas:

1. Ve a Perfil → API Keys.
2. Localiza la clave por su nombre o prefijo.
3. Haz clic en Revocar.

La clave dejará de funcionar de inmediato. Si necesitas reemplazarla, crea una nueva.

Buenas prácticas de seguridad

• No compartas tus claves.
• No las incluyas en código de frontend (navegador o apps públicas).
• Usa una clave por integración para revocar solo lo necesario.
• Guarda las claves en variables de entorno o gestores de secretos.