ArgorantDocs

Connecter un Google Workspace

Une seule autorisation de l'admin du Workspace liste chaque boîte mail et chaque alias. Choisissez celles qui doivent envoyer. Pas de mot de passe ni de connexion par boîte mail.

Demander les valeurs de délégation

Shell
curl -X POST "https://app.argorant.com/api/v1/inboxes/google-workspace" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"admin_email":"admin@yourdomain.com"}'

Tant que l'admin n'a pas donné son accord, la réponse contient ok: false, mailboxes: null et un bloc setup avec client_id, scopes_csv et delegation_url, les valeurs dont l'admin a besoin.

Autoriser dans Google Admin

Dans Google Admin, ouvrez Sécurité, puis Accès et contrôle des données, Commandes des API, Délégation au niveau du domaine et Ajouter. Collez l'id client et les scopes exactement tels qu'ils ont été renvoyés. Un admin le fait une seule fois par Workspace.

Lister et connecter

Appelez à nouveau le même endpoint. Il renvoie maintenant chaque boîte mail et chaque alias. Envoyez ensuite les adresses à connecter, ou une liste vide pour toutes les connecter :

Shell
curl -X POST "https://app.argorant.com/api/v1/inboxes/google-workspace" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"admin_email":"admin@yourdomain.com","emails":["elena@yourdomain.com","marina@yourdomain.com"]}'
# {"connected": [{"email": "elena@yourdomain.com", "health": "healthy"}]}

Les boîtes mail connectées apparaissent dans GET /api/v1/inboxes avec leur état de santé, leur limite quotidienne et les envois du jour, et peuvent envoyer pour n'importe quelle campagne. Dans le terminal, la même chose s'écrit npx argorant inboxes connect-google --admin admin@yourdomain.com --all.

Sur cette page