# VaEmail vs Brevo

Brevo est une plateforme marketing complète : email, SMS, WhatsApp, CRM, automation, avec
une API `/v3` très répandue. VaEmail expose cette même API `/v3` pour qu'une intégration
Brevo bascule sans réécrire le code, et ajoute une API `/api/v1` conçue pour un programme
qui tient la clé seul. Sources officielles lues le 06/09/2026, citées en bas de page.

| Critère | VaEmail | Brevo |
| --- | --- | --- |
| Positionnement | Infrastructure email pour applications et agents IA | Plateforme email, SMS, CRM et automation |
| API | `/api/v1` + `/v3` compatible Brevo, en-tête `api-key` | `https://api.brevo.com/v3`, en-tête `api-key` |
| SDK | Aucun propre ; les 7 SDK Brevo fonctionnent sur `/v3` en changeant l'URL | Node, PHP, Python, Java, C#, Go, Ruby |
| CLI | `npx vaemail` : init, doctor, send, status, domains, usage | `@getbrevo/cli` : gestion d'apps OAuth, d'interfaces CRM et de « Functions », pas d'envoi |
| MCP | Local (stdio), 13 outils, zéro dépendance | Distant `mcp.brevo.com`, 27 modules (aussi un serveur par module), jeton MCP dédié ; plus un MCP « docs » sans clé |
| OpenAPI | 3.1, `https://app.vaemail.fr/openapi.json` | 3.0.1, `https://api.brevo.com/v3/swagger_definition_v3.yml` (la page de doc annonce « OpenAPI v2 ») |
| llms.txt | `vaemail.fr/llms.txt` | `developers.brevo.com/llms.txt` (406 lignes) ; rien sur brevo.com |
| Skill d'agent | Oui | Non trouvé |
| Email entrant | Réponses aux séquences de prospection via boîte IMAP déclarée | « Inbound parsing » : sous-domaine dédié avec MX vers Brevo, webhook `inboundEmailProcessed`, pièces jointes par jeton de téléchargement |
| Boîte à la volée | Non | Non : un sous-domaine configuré une fois, pas d'adresse créée par appel |
| Idempotence | En-tête `Idempotency-Key`, 24 h, 409 si le contenu change | Champ `headers.idempotencyKey` (UUID) dans le corps JSON, 30 minutes, erreur `duplicate_parameter` au rejeu |
| Essai à blanc | `POST /api/v1/messages/validate` : dit ce qui bloquerait (domaine, suppression, quota, plafond de clé) | `X-Sib-Sandbox: drop` : valide le format de la requête, rend un `messageId` fictif, ne teste pas la délivrabilité |
| Portées de clé | 8 portées | Aucune sur les clés API (accès complet, seule restriction : liste d'IP) ; des portées existent pour les apps OAuth |
| Plafonds par clé | Jour, destinataires, domaines expéditeurs | Non documenté ; limites par compte et par offre |
| Journal d'audit | `GET /api/v1/audit-logs`, une ligne par appel | `GET /v3/organization/activities`, Enterprise seulement, 1 mois par requête |
| Statut par message | `GET /api/v1/messages/{id}` | `GET /v3/smtp/emails` et rapports d'événements |
| Webhooks | sent, delivered, bounce, complaint, opened, clicked | 15 événements email (dont deferred, blocked, invalid, proxy open) et 10 SMS |
| Diagnostic de délivrabilité | `GET /api/v1/deliverability/diagnose` | Statistiques a posteriori et vérification SPF/DKIM du domaine ; pas de diagnostic dédié trouvé |
| Erreurs | Bloc `error` avec `code`, `retryable`, `resolution` | Codes d'erreur documentés |
| Région | Serveurs en Allemagne, envoi SES Europe | « Our servers are located in the EU » |
| Débit | 60 requêtes/minute sur l'envoi transactionnel | Jusqu'à 1 000 requêtes/seconde sur `POST /v3/smtp/email` (offre générale) |
| Lot, différé | Campagnes programmables | `messageVersions` jusqu'à 1 000 versions par appel, `scheduledAt` jusqu'à 72 h |
| Tarifs | Au volume, sur devis ; pas de grille publique | Gratuit : 300 emails/jour ; Business marketing dès 99 €/mois ; grille transactionnelle non lisible sans navigateur |

## Ce que Brevo fait mieux

- Le périmètre : SMS, WhatsApp, CRM, automation, formulaires. VaEmail fait de l'email.
- Le débit et le lot : mille requêtes par seconde, mille versions par appel, envoi différé.
- Les webhooks : quinze événements email contre six.
- L'entrant, avec extraction de signature et pièces jointes.
- Un serveur MCP hébergé, découpé par module, et un second qui sert la documentation.
- Le volume gratuit.

## Ce que VaEmail fait mieux

- La clé qu'on peut confier à un programme : portées, plafond journalier, destinataires,
  domaines. Chez Brevo, une clé API donne tout le compte.
- L'essai à blanc qui dit *pourquoi* l'envoi ne passerait pas, là où le bac à sable Brevo
  ne vérifie que le format.
- L'idempotence en en-tête standard, sur 24 h, avec un 409 explicite si le contenu change,
  au lieu d'un champ propriétaire dans le corps sur 30 minutes.
- Le journal d'audit sur toutes les offres, une ligne par appel.
- Le diagnostic de délivrabilité par API.
- Les erreurs structurées avec l'action corrective.

## Quand choisir

Brevo si vous avez besoin de la plateforme (CRM, SMS, automation) ou de gros volumes en
lot. VaEmail si un agent tient la clé, si vous voulez des garde-fous par clé, ou si vous
voulez quitter Brevo sans toucher au code : la même API répond sur `app.vaemail.fr/v3`.

## Sources

Brevo, consultées le 06/09/2026 : https://www.brevo.com/ · https://developers.brevo.com/docs/api-key-authentication.md ·
https://developers.brevo.com/docs/api-clients.md · https://github.com/getbrevo/brevo-cli ·
https://developers.brevo.com/docs/mcp-protocol.md · https://developers.brevo.com/docs/agent-setup.md ·
https://api.brevo.com/v3/swagger_definition_v3.yml · https://developers.brevo.com/llms.txt ·
https://developers.brevo.com/docs/inbound-parse-webhooks.md · https://developers.brevo.com/docs/heterogenous-versions-batch-emails.md ·
https://developers.brevo.com/docs/using-sandbox-mode.md · https://developers.brevo.com/docs/ip-security.md ·
https://developers.brevo.com/docs/oauth-scopes.md · https://developers.brevo.com/docs/api-limits.md ·
https://developers.brevo.com/docs/user-activity-logs.md · https://developers.brevo.com/docs/transactional-webhooks.md ·
https://www.brevo.com/features/data-security/ · https://www.brevo.com/pricing/ ·
https://developers.brevo.com/docs/schedule-batch-sendings.md.
VaEmail : https://vaemail.fr/llms-full.txt · https://app.vaemail.fr/openapi.json.