SocialHub.AI
Ressources · Centre de développement

Fournisseurs de messagerie

Envoyez vos e-mails via vos fournisseurs de messagerie existants. Un administrateur configure un ou plusieurs fournisseurs ainsi qu'une solution de repli ordonnée dans l'interface d'administration ; Flash effectue l'envoi en cascade, aboutissant toujours au service de messagerie géré par la plateforme. Le fournisseur sert uniquement de relais de transport  ; Flash continue d'injecter le suivi, la personnalisation, les tests A/B et la gestion des désabonnements. Ainsi, la création et le suivi de vos campagnes restent inchangés.

Ce que vous pouvez connecter

Configuré dans Paramètres → Fournisseurs de messagerie par un administrateur de l’organisation, jamais par campagne par un responsable marketing.

SendGrid

Connectez votre compte SendGrid avec une clé API. Flash envoie les messages via le service de messagerie v3 API.

Amazon SES (votre compte)

Apportez votre propre compte AWS SES (clé d'accès/région/vérifié depuis). Distinct du SES de repli de la plateforme.

REST personnalisé — tout ESP

Pointez Flash vers l’envoi JSON API de n’importe quel fournisseur avec une correspondance de champs. Aucun adaptateur à attendre.

Le relais SMTP brut est sur la feuille de route, pas encore disponible – connectez-vous via le API d'un fournisseur pour l'instant.

La cascade de repli

Chaque envoi essaie vos fournisseurs dans l'ordre de priorité que vous avez défini ; un fournisseur défaillant ou indisponible est ignoré et la livraison revient au suivant. Le service de messagerie géré de la plateforme constitue toujours la solution de secours du terminal.

// Providers are tried in the priority order an admin sets. The list ALWAYS ends at
// the platform's managed Amazon SES account (the terminal fallback), which uses its
// own verified from-address so a fallback never bounces on an unverified domain.
Priority 1  →  SendGrid            (your account)
Priority 2  →  Amazon SES          (your own AWS account)
Priority 3  →  Custom REST         (any ESP with a send API)
Terminal    →  Platform Amazon SES (always on — the safety net)
// A provider that errors or is circuit-broken is skipped; delivery falls to the next.

Connectez n'importe quel ESP avec des communautés personnalisées REST

Si votre fournisseur n'est pas intégré, connectez-le via son envoi API : fournissez le point de terminaison, l'en-tête d'authentification et une correspondance de champs. Aucun code, aucun adaptateur à créer.

// A "Custom REST" provider connects ANY ESP that exposes a JSON send API — no
// code, just configuration. An admin supplies the endpoint, the auth header, and a
// field map; Flash builds the request per message. Example (a generic ESP):
{
  "provider": "custom_rest",
  "config": {
    "endpoint":    "https://api.your-esp.com/v1/send",
    "authHeader":  "Authorization",
    "authScheme":  "Bearer",              // → "Authorization: Bearer <apiKey>"
    "toField":     "to",
    "fromField":   "from",
    "subjectField":"subject",
    "htmlField":   "html"
  },
  "secret": { "apiKey": "sk_live_…" }      // encrypted at rest; never returned
}
// Per send, Flash POSTs: { "to": "...", "from": "...", "subject": "...", "html": "..." }
// with the auth header applied. 401/403 → credentials error (skip to next provider),
// 5xx/timeout → transient (skip to next provider). The HTML already carries Flash's
// own tracking pixel + link redirects, so opens/clicks keep working.

Synchronisation des désabonnements vers Flash

Lorsque vous envoyez via vos propres fournisseurs, les désinscriptions peuvent être capturées en dehors de Flash — par votre ESP, votre centre de préférences ou un formulaire. Repoussez-les avec le désabonnement API afin que Flash supprime cette adresse à chaque envoi. Vous pouvez également lire le statut de désinscription d'une adresse. Authentifiez-vous avec une clé de locataire API ; l'e-mail est l'identité.

// Push an opt-out INTO Flash — from your ESP's unsubscribe webhook, your own
// preference center, or a third-party form. Flash then suppresses this address on
// EVERY campaign send (the same signal the audience resolver checks). Idempotent.
POST https://flash.socialhub.ai/api/v2/members/unsubscribe
Authorization: Bearer fl_live_…            // scope: members:write
Content-Type: application/json
{ "email": "ada@acme.com" }
// → 200  { "data": { "email": "ada@acme.com", "unsubscribed": true } }

// Read an address's opt-out status (e.g. reconcile before a bulk send):
GET https://flash.socialhub.ai/api/v2/members/unsubscribe?email=ada@acme.com
Authorization: Bearer fl_live_…            // scope: members:read
// → 200  { "data": { "email": "ada@acme.com", "unsubscribed": true } }

// Re-subscribing is deliberately NOT an API toggle — re-granting marketing consent
// needs provable opt-in (CAN-SPAM / CASL), so it goes through the member's own
// consent flow, never this endpoint.

Comment les informations d'identification sont conservées en sécurité

Chiffré au repos

Chaque clé secrète du fournisseur est chiffrée immédiatement (AES-256-GCM) et n'est jamais renvoyée par API ni affichée ultérieurement (accès en écriture seule dans l'interface utilisateur).

Réservé à l'administrateur.

Seuls les propriétaires/administrateurs de l’organisation peuvent ajouter, réorganiser, tester ou supprimer des fournisseurs. Les spécialistes du marketing ne voient ni ne choisissent jamais un fournisseur.

Transport uniquement

Les fournisseurs diffusent le message. Flash conserve la gestion du suivi, de la personnalisation, des tests A/B, des en-têtes de désabonnement et des limitations de fréquence ; changez de fournisseur sans rien modifier.

Sécurisé par défaut

Si la configuration d'un fournisseur est illisible ou si tous les fournisseurs sont indisponibles, la distribution bascule vers le service de messagerie géré par la plateforme, assurant ainsi la continuité des envois.

Voir aussi : Distribution multicanal · REST API

Vous avez votre propre fournisseur de messagerie ?

Contactez un ingénieur pour discuter de votre ESP, de la délivrabilité, de votre stratégie de repli ou de la connexion d’un fournisseur via son API.

Parlez à l'ingénierie