SuperMailbox · guide d’intégration CRM

Connecter SuperMailbox à votre CRM

Chaque utilisateur du CRM dispose d’une connexion sécurisée, autorisée par OAuth, aux boîtes mail de son choix. Le CRM peut retrouver les échanges clients, afficher leur contexte vérifié et préparer ou envoyer des réponses via le serveur MCP de SuperMailbox.

Fonctionnement de la connexion

01

Connecter une boîte mail

L’utilisateur connecte Gmail, Outlook ou une autre boîte compatible à SuperMailbox. La connexion au fournisseur de messagerie est distincte de l’autorisation du CRM.

02

Autoriser le CRM

Le CRM ouvre OAuth SuperMailbox dans le navigateur. L’utilisateur se connecte, vérifie le client et les autorisations demandées, puis approuve la connexion.

03

Utiliser les outils MCP

Le CRM appelle le serveur MCP distant avec le jeton de l’utilisateur. Celui-ci choisit une boîte autorisée et le CRM agit dans les limites de cet accès.

Paramètres de connexion

Utilisez un client ou SDK MCP compatible avec Streamable HTTP distant et la découverte OAuth. Il doit gérer l’autorisation dans le navigateur et transmettre le jeton d’accès avec les requêtes MCP.

URL du serveur MCP
https://api.supermailbox.app/mcp
Autorisation
OAuth 2.0 · Authorization Code · PKCE S256
Autorisations
openid email mail.accounts.read mail.messages.read mail.send

Ne demandez que les accès nécessaires au flux de travail. Un CRM qui lit les échanges clients et envoie des réponses peut demander :

Trouver et vérifier un échange

  • Appelez list_mail_accounts pour permettre à l’utilisateur de choisir une boîte disponible. canSend est une indication ; l’autorisation d’envoi est revérifiée au moment de l’action.
  • Recherchez des résultats avec search_emails ou search_threads_by_recipient. La recherche par destinataire ne renvoie que des métadonnées ; récupérez et vérifiez le fil choisi avant de le lier à une fiche CRM.
  • Les résultats peuvent être limités ou incomplets. Tenez compte des champs coverage et completeness ; un résultat partiel vide ne prouve pas l’absence de message.
  • Les identifiants des boîtes, messages et fils sont opaques et liés à l’autorisation de l’utilisateur courant. Retrouvez-les et vérifiez-les avec cette même connexion.

Préparer et envoyer des réponses en toute sécurité

  • Avant la confirmation, affichez dans le CRM la boîte, le destinataire et le texte de réponse sélectionnés.
  • send_email et reply_to_email renvoient une opération en attente. Interrogez get_mail_action avec le même identifiant d’opération et les autorisations requises jusqu’au statut final.
  • Une confirmation de mise en file ne prouve pas la livraison. En cas d’incertitude, vérifiez cette même opération ; ne la relancez jamais automatiquement avec un nouvel identifiant.

Sécurité et contrôle des accès

  • Utilisez le flux OAuth Authorization Code avec PKCE S256 via la découverte prise en charge par le client MCP. Gardez secrets et jetons côté serveur, hors du code navigateur et des journaux.
  • Créez une connexion distincte pour chaque utilisateur du CRM. Ne partagez pas le jeton ni les identifiants opaques de boîte entre utilisateurs.
  • Demandez mail.send uniquement si le CRM doit envoyer des messages. L’utilisateur peut révoquer la connexion CRM dans les paramètres des applications connectées de SuperMailbox.