👋 ¿En qué podemos ayudarte?

Todos los consejos prácticos para hacer crecer tu negocio con mensajería.

Todas las coleccionesIntegracionesGestionar claves de API

Gestionar claves de API

Crea, gestiona y revoca claves de API para integraciones externas. Úsalas para autenticarte en la API REST de Bugalou.

Visión general

Las claves de API te permiten integrar Bugalou con sistemas externos y aplicaciones personalizadas. Se usan para autenticar las solicitudes a todas las API REST de Bugalou, ya sea para enviar plantillas de WhatsApp, gestionar pedidos o consultar facturas. Ve a Configuración de la organización → API e integraciones.

Crear una clave de API

  1. Haz clic en "Crear API key" en la esquina superior derecha
  2. Introduce un Nombre para la clave (p. ej. "API de producción", "Entorno de pruebas")
  3. Haz clic en "Crear clave"
  4. La clave completa se muestra una sola vez en una tarjeta verde: ¡cópiala ahora! Haz clic en "Copiar" y después en "He guardado mi clave"

Importante: la clave completa solo se muestra una vez. Después de confirmar, solo es visible el prefijo (bg_live_••••••••).

Gestionar las claves

Cada tarjeta de clave de API muestra:

  • Nombre — el nombre que elegiste para la clave
  • Insignia de estado — "Activa" (verde) o "Desactivada" (gris)
  • Prefijo — clave enmascarada: bg_live_••••••••
  • Creada — fecha de creación
  • Último uso — cuándo se usó la clave por última vez en una llamada a la API

Acciones de las claves

  • Desactivar / Activar — desactiva una clave temporalmente sin eliminarla
  • Revocar — elimina la clave de forma permanente (con cuadro de diálogo de confirmación)

Autenticación

Incluye tu clave de API en cada solicitud con uno de estos dos métodos:

  • X-API-Key: bg_live_your_key_here — encabezado personalizado
  • Authorization: Bearer bg_live_your_key_here — token Bearer

Ambos métodos funcionan en todos los endpoints de la API.

Buenas prácticas de seguridad

  • No compartas nunca tu clave de API en repositorios de código públicos
  • Usa variables de entorno para almacenar las claves en tus aplicaciones
  • Crea claves distintas para los entornos de producción y de pruebas
  • Desactiva o revoca las claves que ya no necesites
  • Rota las claves periódicamente: crea una clave nueva, actualiza tus integraciones y después revoca la antigua

API disponibles

Una vez que tengas una clave de API, puedes usar las siguientes API REST: