Connecter des comptes e-mail
Campbooks se connecte à votre fournisseur e-mail via OAuth — il ne voit jamais votre mot de passe, et le token de rafraîchissement qu'il stocke est chiffré au repos. Il prend en charge Zoho Mail, Google Workspace (Gmail) et Microsoft 365.
Le calendrier suit automatiquement. La connexion d'une boîte aux lettres Google ou Zoho demande les autorisations de calendrier dans la même délégation, de sorte que votre calendrier se synchronise automatiquement — il n'y a pas de flux de connexion de calendrier séparé. Voir Calendrier.
Fournisseurs pris en charge
| Fournisseur | API | Console | URL de rappel mail |
|---|---|---|---|
| Zoho Mail | Zoho Mail REST API | Console API Zoho | /oauth/zoho/callback |
| Google Workspace | Gmail API | Google Cloud Console | /oauth/gmail/callback |
| Microsoft 365 | Microsoft Graph | Centre d'administration Entra | /oauth/microsoft/callback |
Autorisez chaque URL de rappel sous la forme <your-app-url>/oauth/<provider>/callback — p. ex. http://localhost:3000/oauth/gmail/callback en local, ou https://app.example.com/oauth/gmail/callback en production.
Zoho Mail
1. Créer un client API Zoho
- Rendez-vous sur la Console API Zoho.
- Créez une nouvelle Server-based Application.
- Ajoutez l'URI de redirection :
<your-app-url>/oauth/zoho/callback. - Notez votre Client ID et votre Client Secret.
2. Configurer les variables d'environnement
ZOHO_CLIENT_ID=your_client_id
ZOHO_CLIENT_SECRET=your_client_secret
ZOHO_REGION=eu # eu | com | in | au | jp — match your Zoho data center
3. Connecter dans Campbooks
- Allez dans Paramètres → Comptes e-mail et cliquez sur Ajouter un compte e-mail.
- Choisissez Zoho Mail et autorisez la connexion sur Zoho.
- Après autorisation, Campbooks stocke un token de rafraîchissement chiffré et démarre la première analyse.
Google Workspace (Gmail)
1. Créer un projet Google Cloud
- Rendez-vous sur la Google Cloud Console et créez un projet.
- Activez l'API Gmail et l'API Google Calendar.
- Créez des identifiants OAuth 2.0 (type : Web application).
- Ajoutez l'URI de redirection :
<your-app-url>/oauth/gmail/callback.
2. Configurer les variables d'environnement
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
3. Connecter dans Campbooks
- Allez dans Paramètres → Comptes e-mail et cliquez sur Ajouter un compte e-mail.
- Choisissez Google Workspace et autorisez via l'écran de consentement Google.
La connexion Gmail et l'intégration interactive Envoyer vers Drive sont des applications Google distinctes — Drive utilise le scope restreint complet drive de Google et son propre /oauth/google/callback. Voir Google Drive.
Microsoft 365
1. Enregistrer une application Entra
- Rendez-vous sur le Centre d'administration Entra → Inscriptions d'applications → Nouvelle inscription.
- Types de comptes pris en charge : Comptes dans n'importe quel annuaire organisationnel (comptes professionnels/scolaires — l'application utilise le point de terminaison
/organizations/). - Ajoutez un URI de redirection Web :
<your-app-url>/oauth/microsoft/callback. - Créez un secret client.
2. Configurer les variables d'environnement
MICROSOFT_CLIENT_ID=your_client_id
MICROSOFT_CLIENT_SECRET=your_client_secret
ENABLE_MICROSOFT_MAILBOX=1 # reveals the "Connect Microsoft 365" button
3. Connecter dans Campbooks
- Allez dans Paramètres → Comptes e-mail et cliquez sur Ajouter un compte e-mail.
- Choisissez Microsoft 365 et autorisez via l'écran de consentement Microsoft.
Partage de comptes
Une boîte aux lettres connectée peut être partagée avec d'autres personnes de votre espace de travail avec des autorisations lecture ou envoi par utilisateur, de sorte qu'une équipe peut travailler sur une même boîte de réception sans partager un mot de passe. Toutes les surfaces — l'application web, Scout et les flux de travail — appliquent la même règle d'autorisation.
Après la connexion
Une fois un compte connecté, Campbooks le maintient synchronisé automatiquement. Voir Analyse des e-mails pour comprendre le fonctionnement de l'analyse et du traitement.