Integraciones y conexiones OAuth

Algunos servicios (Google, Microsoft, Slack…) no se acceden con usuario y contraseña, sino con OAuth: tú autorizas a Zoan Automation a actuar en tu nombre desde la propia pantalla de consentimiento del proveedor, y este entrega un token de acceso. Las conexiones OAuth de Zoan Cloud guardan y administran esos tokens por ti.

Conexión vs. credencial

Una credencial guarda secretos estáticos (usuario, contraseña, token). Una conexión OAuth representa una autorización sobre una cuenta de terceros: guarda el token de acceso y su refresh_token, y Zoan Cloud lo renueva automáticamente cuando caduca. En el playbook ambas se referencian igual: credential("nombre").

Integraciones del ambiente

Centro › Recursos › Integraciones reúne todo lo que Zoan Cloud conecta con tus sistemas en ese ambiente, para que robots, flujos y asistentes lo usen por su nombre. Con Añadir integración eliges qué conectar:

Integración	Para qué
Microsoft 365 y Google Workspace	Correo, calendario, archivos y hojas de cálculo con la cuenta de la empresa, autorizada por OAuth (esta página).
Mosend (WhatsApp)	Enviar mensajes y plantillas, y conectar asistentes a WhatsApp. Una cuenta por ambiente, con Iniciar sesión en Mosend o con una API key. Ver Mosend.
Modelos de IA (Anthropic, OpenAI, Azure OpenAI, OpenRouter)	Usar tu propia cuenta de modelo en lugar de la IA incluida en el plan; el gasto va por tu cuenta. Ver Consumo de IA.
API HTTP (JSON)	Llamar cualquier API con su especificación OpenAPI o Swagger desde flujos y asistentes. Ver Acciones de API.
Tienda (WooCommerce)	Consultar productos y pedidos de tu tienda en línea.

Las pestañas Cuentas conectadas, Tiendas, Mensajería, Modelos de IA y API y datos filtran la lista.

Integraciones en carpetas

Las tiendas, los modelos de IA, las API HTTP y las cuentas de Mosend pueden vivir en la carpeta del área que las usa, igual que las credenciales: elige la carpeta en el árbol de la izquierda y pulsa Añadir integración. Cada área conecta sus sistemas y sus robots y asistentes los usan sin configurar nada más.

• En una carpeta ves sus integraciones, las de sus subcarpetas y las vinculadas desde otras carpetas (Vinculada desde …). Para compartir una integración entre áreas, usa Vincular desde otra carpeta en la carpeta que la va a usar.
• Los permisos son los de credenciales (credential:list, read, create, update y delete) y se suman igual: los roles de la organización o la raíz del ambiente más los de la carpeta de la integración.
• Los nombres son únicos en todo el ambiente.
• Quién usa qué: un robot, según la carpeta de su proceso; un asistente (modelo, catálogos, acciones de API y canal de WhatsApp), según la carpeta del asistente; un proyecto de extracción, según la carpeta del proyecto. Cada uno busca en su carpeta, en lo vinculado a ella y en la raíz del ambiente. Ver Qué credencial usa cada robot.
• Los pasos de los flujos usan las integraciones de la raíz del ambiente o las globales; al publicar un flujo se pide una de esas.

Las cuentas conectadas por OAuth (Microsoft 365 y Google Workspace) y los canales de WhatsApp con claves propias de un asistente se administran en la raíz del ambiente y sirven a todas sus carpetas.

Cómo funciona

1. Creas la conexión        →  estado: pendiente
2. Pulsas "Autorizar"       →  se abre el consentimiento del proveedor
3. Apruebas el acceso       →  estado: conectada (token guardado)
4. El bot la usa por nombre →  Zoan Cloud entrega un token válido (lo refresca solo)

El proveedor (Google, Microsoft, etc.) lo prepara una vez el administrador de la plataforma. Tú, en tu tenant, solo creas conexiones sobre los proveedores disponibles.

Crear una conexión

1. Abre Centro › Recursos › Integraciones y pulsa Administrar cuentas OAuth y permisos (al pie de la página).
2. Pulsa Nueva conexión.
3. Elige el proveedor (ej. Google).
4. Define dos nombres:
   • Nombre clave (código): solo minúsculas, números y guiones (ej. google-reportes). Este es el nombre con el que la referencias en el playbook.
   • Nombre legible: para mostrar en el portal (ej. Google Agenda Clínica).
5. Marca los permisos (scopes) que el bot necesita.
6. Pulsa Crear y Autorizar: se abre el proveedor para que apruebes el acceso.

Debe quedar en estado “Conectada”

Una conexión recién creada queda pendiente hasta que completas la autorización. Si un bot la usa estando pendiente, fallará con “no se pudo resolver la credencial”. Asegúrate de que la tarjeta muestre Conectada antes de usarla.

Nombre clave vs. nombre legible

En las actividades siempre referencias por el nombre clave (el de minúsculas-guiones), no por el legible:

Google Sheets — Open   credential = credential("google-reportes")

Usar el nombre legible da el error “la credencial no existe”.

Permisos (scopes)

Cada proveedor ofrece un catálogo de scopes (qué puede hacer el bot: leer Gmail, escribir en Sheets…). Elige solo los que necesites — principio de mínimo privilegio. Si el proveedor no tiene scopes configurados, no podrás crear conexiones con él; pídele al administrador de la plataforma que agregue al menos uno.

Las conexiones viven en un ambiente

Igual que las credenciales, una conexión pertenece a un ambiente (o es global para todos). Así el mismo playbook usa la cuenta de pruebas en Pruebas y la real en Producción, referenciando el mismo nombre clave en ambos. Ver Ambientes.

Estados de una conexión

Estado	Significado
Pendiente	Creada pero sin autorizar. No se puede usar todavía.
Conectada	Autorizada y lista. Zoan Cloud refresca el token automáticamente.
Expirada	El refresh falló (p. ej. acceso revocado en el proveedor). Pulsa Reconectar.
Error	Problema al renovar. Reautoriza con Reconectar.

Reconectar o revocar

• Reconectar: repite el consentimiento para renovar la autorización (tras expirar o para cambiar de cuenta).
• Eliminar: revoca el token en el proveedor (mejor esfuerzo) y borra la conexión.

Siguientes pasos

• App OAuth propia (BYOA) — usar tu propia app de Google/Microsoft en vez de la compartida.
• Credenciales — secretos estáticos (usuario/contraseña/token).