Configurar Tools en Zyntia

Esta guia explica como activar tools en tu bot.

1. Diferencia clave: Login vs Tools

1. Login con Google:
   • Sirve para entrar a Zyntia.
   • No conecta automaticamente Calendar, Drive, Sheets, Docs o Gmail.
2. Connect Google for <Tool>:
   • Sirve para autorizar una tool especifica.
   • Cada tool se conecta por separado.

2. Opciones de OAuth para Google Tools

Opcion A: OAuth de plataforma (Managed)

1. No tienes que crear app de Google Cloud.
2. Solo haces click en Connect Google for Calendar (o la tool que quieras).
3. Aceptas permisos.

Opcion B: Tu propia app OAuth (BYO)

1. En la seccion de la tool, pega:
   • Client ID
   • Client Secret
2. Guarda credenciales.
3. Luego haces click en Connect Google for <Tool>.

Recomendado si quieres control total de tu proyecto Google y sus politicas.

3. Flujo recomendado por tool

Repite este flujo para cada categoria:

1. Calendar
2. Drive
3. Docs
4. Sheets
5. Gmail

Pasos:

1. Abre Dashboard > Bot > Tools.
2. Entra a la categoria (ejemplo: Calendar).
3. Si usaras BYO OAuth:
   • Pega Client ID y Client Secret.
   • Click Save OAuth Client.
4. Click Connect Google for <Tool>.
5. Acepta permisos en Google.
6. Click Refresh Tools o Instalar/actualizar tools.
7. Verifica que aparezcan las tools instaladas en la lista.

4. Scopes por tool

Cada tool pide solo lo necesario:

1. Calendar: calendar.events
2. Drive: drive.file
3. Sheets: spreadsheets
4. Docs: documents
5. Gmail: gmail.send

5. Google Drive: carpeta por defecto

Si usas Drive, puedes definir Default Folder ID:

1. Pega el ID de carpeta.
2. Click Set Folder.

Esto permite que la tool escriba/lista en la carpeta correcta por defecto.

6. Verificacion rapida

1. Calendar:
   • Lista eventos.
   • Crea un evento.
2. Drive:
   • Lista archivos.
   • Lee/escribe archivo de prueba.
3. Sheets:
   • Lee rango.
   • Agrega filas.
4. Docs:
   • Lee documento.
   • Crea documento.
5. Gmail:
   • Envia correo de prueba.

7. Problemas comunes

1. Error al conectar:
   • Revisa Redirect URI en Google Cloud.
   • Revisa Client ID/Secret pegados.
2. Error de permisos (403):
   • Falta scope para esa tool.
   • Reconecta la tool y acepta permisos.
3. Tool no aparece:
   • Ejecuta Refresh Tools.
4. Cambio de cuenta Google:
   • Desconecta/reconecta la tool.

8. Seguridad

1. Tus credenciales OAuth se guardan cifradas.
2. Client Secret no se muestra en claro despues de guardado.
3. Puedes eliminar BYO por tool cuando quieras con Remove BYO Client.