Genuka WA docs

Autenticación

Claves API, alcance y buenas prácticas de rotación.

Cada solicitud se autentica con una clave API en el encabezado Authorization:

Authorization: Bearer pk_live_...

Nunca manejas un token de Meta. Genuka WA guarda las credenciales de la Cloud API y las rota por ti: una sola clave API de Genuka basta, y solo da acceso a tus propios datos.

Dos alcances de clave

AlcanceAccesoCaso de uso
SocioTodos los clientes del socioUna plataforma que gestiona números de varias empresas
ClienteUna sola empresaUna empresa que integra únicamente sus propios números

Una clave de cliente que intenta acceder a otra empresa recibe 403 out_of_scope. Algunos endpoints — facturación, uso del plan — exigen una clave de socio y, de lo contrario, responden 403 partner_key_required.

Crear y revocar una clave

Las claves se gestionan desde el portal, en Desarrolladores. Una clave se muestra una sola vez al crearla: Genuka solo almacena una huella y no puede volver a mostrártela.

Para rotar sin interrupción del servicio: crea la nueva clave, despliégala, confirma el tráfico en los registros y luego revoca la anterior.

Respuestas de error

EstadoCódigoSignificado
401missing_bearer_tokenFalta el encabezado Authorization
401invalid_tokenClave desconocida o revocada
403out_of_scopeLa clave está restringida a otra empresa
403partner_key_requiredEndpoint reservado a las claves de socio

Seguridad

  • Una clave API es un secreto del lado del servidor. Nunca la incluyas en un frontend ni en una aplicación móvil: cualquiera podría enviar mensajes en tu nombre y a tu costa.
  • Usa claves distintas por entorno y por integración: así, revocar una se vuelve una operación quirúrgica en lugar de global.
  • Cada solicitud queda registrada y es visible en el portal.

En esta página