Fiche
Chatbot Brevo : Conversations, serveur MCP et assistant IA
Brancher un assistant IA sur Brevo : l'API Conversations, ses webhooks, le serveur MCP et ses modules CRM, vus depuis un projet d'intégration.
Mis à jour le
Brevo propose deux portes pour un assistant IA. Brevo Conversations, son chat, s'ouvre à un bot externe par des webhooks et une API qui permet de répondre au visiteur. Le serveur MCP de Brevo (MCP : Model Context Protocol, le standard qui relie un assistant IA à des outils) donne accès au compte : contacts, campagnes, CRM. Ce sont deux intégrations différentes, avec des droits différents. Documentation lue le 15/11/2026.
Faire répondre un assistant dans le chat Brevo
La documentation de l'API Conversations présente trois briques : une API REST pour envoyer, lire et gérer les messages, une API JavaScript qui contrôle le widget de chat, et des webhooks pour relier Conversations à d'autres systèmes.
Les webhooks documentés sont trois :
| Événement | Quand il part | Usage pour un assistant |
|---|---|---|
conversationStarted |
Quand un visiteur ou un agent ouvre une conversation (pas pour les messages automatiques ou poussés) | Déclencher l'assistant ; le champ isNoAvailableAgent indique qu'aucun agent n'est en ligne |
conversationFragment |
Après les messages qui demandent l'attention d'un agent | Faire suivre la conversation |
conversationTranscript |
À la fin : visiteur hors ligne, ou tous les agents partis | Archiver, ou envoyer un résumé au CRM |
Pour répondre, l'assistant appelle le point d'accès « Send a message as an agent ». Il faut l'identifiant du visiteur (visitorId), le texte, et soit un agentId, soit le trio agentEmail, agentName et receivedFrom. Ce dernier champ marque vos messages : la documentation le recommande pour les filtrer à la réception du webhook, « to avoid infinite loop ». Dans les réponses de l'API, le champ isBot vaut true pour les messages générés par un bot IA.
Le montage, en pratique : webhook reçu, accusé de réception immédiat, appel à l'assistant, réponse par l'API avec receivedFrom. La règle « répondre vite, traiter ensuite » est détaillée sur la page webhook et IA d'integration.cercle-ia.tech.
Donner à un assistant l'accès au compte Brevo : le serveur MCP
Selon Brevo, le serveur MCP « lets you use AI assistants to interact with your Brevo account using natural language ».
- Adresse :
https://mcp.brevo.com/v1/brevo/mcppour le serveur principal ; des serveurs individuels existent par module, par exemplehttps://mcp.brevo.com/v1/brevo_contacts/mcp. - Authentification : un jeton MCP, créé en cochant l'option MCP à la création de la clé, transmis dans l'en-tête
Authorization: Bearer. - Modules : le serveur principal en regroupe 27, dont les contacts, listes et segments, les campagnes e-mail et leurs statistiques, les modèles, le CRM (affaires, entreprises, tâches, pipelines, notes), les SMS et WhatsApp, et l'administration (expéditeurs, domaines, utilisateurs, gestion des webhooks…).
Brevo note que les serveurs individuels offrent un jeu d'outils réduit, ce qui « can improve response quality ». Pour un intégrateur, c'est surtout une question de droits : un assistant qui doit lire des contacts n'a aucune raison d'accéder à la gestion des utilisateurs ou des domaines du compte.
Ce que l'intégrateur décide avec le client
| Question | Pourquoi elle compte |
|---|---|
| Le bot répond-il seul, ou seulement quand aucun agent n'est en ligne ? | Le champ isNoAvailableAgent permet de choisir |
| Que devient la conversation à la fin ? | conversationTranscript peut alimenter le CRM, à condition de savoir ce qu'on y garde |
| Quel serveur MCP, quels modules ? | Un serveur par module limite l'assistant à ce dont il a besoin |
| Où vit le jeton MCP ? | C'est un secret : coffre, rotation, révocation en cas de doute |
| Qui surveille les boucles et les doubles réponses ? | receivedFrom et le filtrage côté webhook |
Pour la conduite générale du branchement à un CRM, voyez Assistant et CRM ; pour le choix des droits, Droits d'accès.
Questions fréquentes
Comment un chatbot externe répond-il dans le chat Brevo ?
En écoutant les webhooks de Brevo Conversations (par exemple conversationStarted), puis en répondant par l'API avec le point d'accès d'envoi de message en tant qu'agent. Le champ receivedFrom permet de reconnaître ses propres messages et d'éviter les boucles.
Le serveur MCP de Brevo donne-t-il accès aux conversations du chat ?
La page de documentation lue le 15/11/2026 liste 27 modules (contacts, campagnes, CRM, SMS, WhatsApp, administration…) mais pas de module de conversations.
Faut-il utiliser le serveur MCP principal de Brevo ?
Il regroupe tous les modules, y compris l'administration du compte. Pour un assistant, un serveur limité au module utile (par exemple les contacts) réduit les droits et, selon Brevo, peut améliorer la qualité des réponses.
Sources
Pages consultées pour écrire cet article :