Connectez Gmail à votre agent IA

Méthodes d’authentification

• OAuth 2.0

Ouvrez la console locale, sélectionnez un fournisseur et configurez ses identifiants. Les fournisseurs OAuth nécessitent une application OAuth que vous enregistrez auprès du service.

Points à vérifier pour ce connecteur

Cet exemple get_profile lit l’identité et les compteurs de la boîte mail, pas le corps des messages. Vérifiez emailAddress ; messagesTotal et threadsTotal sont des compteurs, historyId est un curseur. Confirmez le scope de lecture Gmail requis avant l’exécution.

Vérifier l’Action avant de l’appeler

Objectif de l’exemple

Lire le profil et les compteurs de la boîte Gmail connectée.

Autorisations requises par l’Action

• https://www.googleapis.com/auth/gmail.readonly

Lisez le schéma de votre instance en cours d’exécution. Vérifiez les paramètres requis, les autorisations et le compte connecté avant l’appel.

curl -s http://localhost:3000/v1/actions/gmail.get_profile

Une fois le compte connecté, adaptez les paramètres à vos ressources. Ajoutez un Bearer Token du runtime si son authentification est activée.

curl -s -X POST \
  http://localhost:3000/v1/actions/gmail.get_profile \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

Lire le résultat

Les réponses HTTP du runtime contiennent success, message, data et meta. Vérifiez success et le schéma de sortie de l’Action, pas seulement le statut HTTP. Si les métadonnées contiennent executionId, utilisez-le pour retrouver le journal expurgé correspondant. L’exemple ci-dessous illustre le format ; ce n’est pas un résultat d’appel réel.

{
  "success": true,
  "message": "OK",
  "data": {
    "emailAddress": "reader@example.com",
    "messagesTotal": 12,
    "threadsTotal": 8,
    "historyId": "12345"
  },
  "meta": {}
}

En cas d’échec

• Pour une erreur d’authentification, vérifiez l’endpoint et le type d’identifiant : l’accès administrateur protège /api, le jeton Bearer runtime autorise /v1 et /mcp. Une clé API fournisseur ne remplace pas le jeton runtime.
• Pour un refus d’accès, vérifiez les scopes requis, les règles d’Actions et les autorisations de connexion. Un jeton valide peut ne pas être autorisé à utiliser le compte choisi.
• Si le résultat est vide ou incomplet, vérifiez le compte connecté et ses droits sur la ressource. Une autorisation réussie ne donne pas accès à tous les espaces, canaux ou documents.
• Consultez l’erreur et le journal avant de réessayer. Si l’Action modifie les données du fournisseur, vérifiez d’abord si elle a déjà abouti ; ne répétez pas la requête aveuglément.

Étapes suivantes

Pour les fournisseurs compatibles, OOMOL gère la configuration des applications OAuth et l’hébergement. Vous choisissez toujours le compte et approuvez ses autorisations.