Google — Gmail, Calendar, Drive
BiVelio s’integra amb els serveis principals de Google Workspace per sincronitzar emails, calendari i documents amb el teu workspace.
Gmail
Funcionalitats
- Recepció d’emails — els emails entrants apareixen a ChannelHub com un canal més
- Enviament d’emails — respon als clients directament des de BiVelio
- Classificació automàtica — agents IA classifiquen emails per prioritat i tema
- Fils de conversa — els emails s’agrupen per fil, mantenint el context
- Adjunts — els documents adjunts s’emmagatzemen automàticament al mòdul de Documents
Configuració
Accedeix a Integraciones
Navega a Ajustes > Integraciones > MCP Marketplace > Gmail.
Connecta el teu compte
Fes clic a Connectar i inicia sessió amb el teu compte de Google. BiVelio sol·licitarà permisos de lectura i enviament d’emails.
Configura els filtres
Defineix quins emails s’han de sincronitzar amb BiVelio:
- Totes les bústies o només determinades etiquetes
- Filtres per remitent, assumpte o domini
- Exclusió d’emails interns (opcional)
Verifica la connexió
El validador MCP comprovarà que la connexió funciona correctament i que els permisos són suficients.
BiVelio analitza automàticament el nom del remitent des del format estàndard d’email (“Nom <email@domini.com>”) per mostrar noms nets a la interfície de ChannelHub.
Google Calendar
Funcionalitats
- Sincronització multi-compte — connecta diversos comptes de Google amb calendaris independents
- Sync incremental — només es transfereixen els canvis, optimitzant el consum d’API
- Cron automàtic — sincronització periòdica configurable (cada 5, 15 o 30 minuts)
- Accés per a agents IA — els agents poden consultar l’agenda per prendre decisions
Arquitectura de sincronització
BiVelio utilitza dues Edge Functions coordinades:
- calendar-sync — executa la sincronització incremental sota demanda
- calendar-cron — programa execucions periòdiques de calendar-sync
La sincronització utilitza tokens incrementals de l’API de Google Calendar: en cada execució només es descarreguen els esdeveniments modificats des de l’última sincronització, minimitzant el consum de quota.
Ús per part dels agents IA
L’agent Fernando pot consultar l’agenda agregada mitjançant la funció get_calendar_aggregate,
la qual cosa li permet:
- Informar sobre disponibilitat abans de programar reunions
- Detectar conflictes d’agenda
- Proposar franges horàries òptimes
Google Drive
Funcionalitats
- Sincronització d’arxius — accedeix a documents de Drive des de BiVelio
- Vinculació a expedients — associa arxius de Drive a casos actius
- Cerca unificada — cerca en documents de Drive des de la barra de cerca de BiVelio
Configuració
La integració amb Google Drive segueix el mateix procés de connexió OAuth que Gmail i Calendar. Selecciona les carpetes que vols sincronitzar i defineix els permisos d’accés per equip.
Seguretat
- Autenticació OAuth 2.0 amb tokens renovables
- Permisos mínims necessaris (només els scopes requerits)
- Tokens emmagatzemats encriptats (AES-256-GCM)
- Revocació d’accés des de Google o des de BiVelio en qualsevol moment