API para desarrolladores

La pestaña Desarrolladores es donde emite claves de API para acceso programático a Entergram. Disponible en el plan Pro (y asientos Pro de workspace). Solo propietarios y admins.

Crear una clave

1. “Crear clave de API”
2. Póngale un nombre (algo que reconocerá más tarde en una lista de revocación)
3. Elija scopes — permisos de grano fino como:
   • workspace.read
   • members.read
   • accounts.read
   • contacts.read
   • chats.read / chats.write
   • custom_fields.read / custom_fields.write
4. El TTL por defecto es de 90 días; puede elegir una duración menor
5. Opcional: restringir a una lista de rangos CIDR de IP
6. Haga clic en Crear — la clave completa se muestra una sola vez. Cópiela inmediatamente; Entergram nunca la mostrará de nuevo.

Por debajo

• Las claves se almacenan como hashes unidireccionales — la clave en bruto nunca vive en disco
• Cada solicitud registra prefijo, IP y user agent para auditoría
• La revocación es inmediata
• Las claves expiradas devuelven 403 automáticamente
• Cada llamada a la API está limitada al workspace — una clave solo puede operar en el workspace que la emitió

Gestionar claves

Desde la pestaña Desarrolladores:

• Ver el prefijo, fecha de creación, scopes, TTL e información de último uso de cada clave
• Copiar el prefijo (no el secreto)
• Revocar o rotar una clave
• Rotar = crear una nueva clave con los mismos scopes y luego revocar la antigua una vez que su integración haya sido migrada

Ejemplo: rotar una clave filtrada

1. Se da cuenta de que un ingeniero pegó una clave en un sistema público de seguimiento de incidencias
2. Pestaña Desarrolladores → encontrar la clave → Revocar (efecto inmediato)
3. Crear una nueva clave con los mismos scopes y lista blanca de IP
4. Desplegar la nueva clave en su integración
5. Comprobar la información de último uso de la clave antigua para confirmar que no hay más tráfico

Ejemplo: emitir una clave para un trabajo de CI

1. Pestaña Desarrolladores → Crear clave de API
2. Nombrarla ci-deploy-bot
3. Scopes: solo workspace.read y chats.read (mínimo privilegio)
4. TTL: 30 días
5. Lista blanca de IP: las IP de salida del proveedor de CI
6. Copiar la clave y configurarla como secreto en CI
7. Rotarla antes de que el TTL caduque

Integración con Make.com

Los planes Pro incluyen una integración con Make.com para que pueda conectar Entergram a automatizaciones low-code sin escribir código de API usted mismo. Disponible desde el área de integraciones del workspace.

Respuestas de la API

Errores HTTP comunes que verá:

• 401 — la clave está expirada, revocada o es incorrecta para el workspace
• 403 — la clave carece del scope necesario, o la solicitud proviene de una IP fuera de la lista blanca
• 429 — ha alcanzado un límite de tasa; espere y reintente