Obtener y proteger tu API Key
Cómo generar tu API Key en el Portal de Cliente y evitar perderla o invalidarla por error.
El API Key se genera y administra en el Portal de Cliente, en la sección API Accesses. En la mayoría de los casos, Getincloud genera esta clave por ti durante el alta del servicio y te la entrega directamente. Si tu empresa tiene acceso propio al Portal de Cliente, estos son los pasos para generarla o consultarla.
La sección API Accesses muestra las columnas ID, Name, API key, Scopes y Webhook.
Pasos
- Haz clic en Create API access.
- Name: un nombre que identifique tu integración, por ejemplo
<SuEmpresa>-produccion. - Webhook: la URL de tu sistema que recibirá los estatus de entrega. Puedes usar un endpoint de pruebas temporal mientras integras.
- Scopes: selecciona
omni-api, el permiso necesario para enviar mensajes por esta API. - Senders: selecciona el o los Sender ID que esta clave podrá usar.
- Haz clic en Create API key para generar la clave.
El formulario de creación del API access contiene los campos Name, Webhook, Scopes y Senders.
Copia la clave de inmediato
La clave solo se muestra completa una vez, en el bloque Data for integration. Cópiala con el botón de copiado y guárdala en un lugar seguro (gestor de secretos, variable de entorno) antes de cerrar la ventana.
Después de guardar el registro, la clave se muestra siempre enmascarada. Solo el ícono de copiado permite reutilizarla; no existe una vista para revelarla de nuevo.
Crítico: Create API key regenera la clave, no la muestra
Si tu clave ya existe y presionas Create API key de nuevo, la clave anterior se reemplaza por una nueva. Toda integración que siguiera usando la clave anterior dejará de autenticarse de inmediato.
Usa este botón únicamente cuando tu intención sea rotar la credencial, y avisa a tu equipo antes de hacerlo para actualizar la integración con la nueva clave.