Configurer les Webhooks

Configurez les webhooks pour recevoir des notifications en temps réel sur les messages, les mises à jour de statut de livraison et les événements de campagne.

Un événement se produit (par ex., message reçu)

SendSeven envoie une requête HTTP POST à votre URL

Si pas de 200, nous réessayons avec backoff exponentiel

Événements : Sélectionnez les événements à recevoir

ID unique de l'evenement (utiliser pour la deduplication)

ID de la ressource ayant declenche l'evenement

Payload specifique a l'evenement (varie selon le type)

Afficher un exemple avec piece jointe media

Le tableau attachments n'est present que lorsque le message inclut un media. Chaque piece jointe comprend un id unique, content_type, file_size et deux URLs de telechargement. Types pris en charge : image, video, audio, document, sticker.

url — Endpoint API stable. Necessite une authentification (cle API ou token de session). N'expire jamais.

signed_url — URL GCS pre-signee. Aucune authentification requise. Expire apres 24 heures.

Si le telechargement media de la plateforme echoue, les donnees brutes de la plateforme sont transmises avec un marqueur "source": "platform" au lieu des champs enrichis. Les types non-fichier (localisation, contacts, reactions) ne sont pas affectes.

Chaque evenement incluant un objet contact contient egalement un tableau contact_methods[] listant tous les identifiants du contact (le principal en premier). Les champs phone et email de premier niveau sont conserves pour la compatibilite ascendante.

Les selections de reponse rapide et de liste arrivent avec message_type "button". La legende est dans "text" et un objet "meta.button" structure contient l'id et le payload, ce qui permet de router la selection sans analyser le texte.

Afficher un exemple avec clic sur bouton (reponse rapide / liste)

Identifiant stable du bouton tel que defini lors de l'envoi du message.

Payload retourne par le canal (correspond a l'id pour les reponses rapides).

Legende lisible que l'utilisateur a vue et touchee.

Les messages sortants incluant des pieces jointes contiennent le meme schema enrichi (id, url, signed_url, content_type, file_size) que les messages entrants.

Le champ error est au niveau data (pas dans message.meta). Les objets conversation et contact complets sont egalement inclus.

Les evenements de mise a jour de statut (delivered, read) utilisent un objet conversation simplifie sans bot_session_id ni champs d'horodatage last_*_at. L'objet contact_method n'est pas inclus.

Les objets conversation email incluent des champs supplementaires : email_integration_id et email_thread_id pour le contexte de fil de discussion.

L'evenement reopened inclut moins de champs de conversation que les autres evenements de conversation (pas de bot_session_id, d'horodatages last_*_at ou de subject).

contact.updated et contact.deleted utilisent la meme structure. Le champ type de l'evenement permet de les distinguer.

Obtenez le corps brut de la requête (avant parsing JSON)

Calculez HMAC-SHA256 en utilisant votre secret webhook

Comparez avec l'en-tête X-SendSeven-Signature

Utilisez une comparaison sécurisée contre les attaques temporelles

Votre URL est accessible publiquement (pas localhost)

Votre certificat SSL est valide (pas auto-signé)

Votre serveur autorise les requêtes POST

Aucun pare-feu ne bloque les IP de SendSeven

Utilisation de JSON analysé au lieu du corps brut

Mauvais secret webhook (copiez-le à nouveau depuis les paramètres)

Middleware modifiant le corps de la requête

Stockez l'ID de l'événement et vérifiez les doublons avant traitement

Rendez vos gestionnaires d'événements idempotents

Répondez avec 200 aussi rapidement que possible (traitement async)

Les Webhooks sont des callbacks HTTP que SendSeven utilise pour envoyer des evenements en temps reel a votre application. Au lieu d'interroger l'API REST, votre endpoint recoit des notifications instantanees lorsqu'un evenement important se produit — un message arrive, une conversation se termine, un contact est cree ou un statut de livraison change. Chaque requete webhook est signee par HMAC pour la securite et automatiquement retentee en cas d'echec avec un backoff exponentiel, garantissant qu'aucun evenement n'est perdu.

Un compte SendSeven avec au moins un canal connecte

Un endpoint HTTPS public capable de recevoir des requetes HTTP POST

Un certificat SSL valide (Let's Encrypt fonctionne tres bien)

Une comprehension de base des API REST et du JSON

Page Webhooks du tableau de bord SendSeven avec le bouton Ajouter un endpoint mis en evidence

Dialogue Ajouter un endpoint avec le champ URL HTTPS et les abonnements aux evenements dans SendSeven

Evenements : Selectionnez les evenements a recevoir

Popup Webhook cree avec succes affichant la cle secrete avec un bouton Copier

Page de detail du webhook affichant l'URL de l'endpoint, les evenements souscrits, l'historique de livraison et l'etat de sante dans SendSeven

Automatiquement lors de la creation d'un webhook via le tableau de bord

Automatiquement lors de la creation d'un webhook via l'API (POST /api/v1/webhook-endpoints)

Automatiquement lorsque l'URL du webhook est modifiee

A la demande via l'endpoint de verification (POST /api/v1/webhook-endpoints/{id}/verify)

1. Créer un point de terminaison webhook
2. Enregistrer le webhook dans SendSeven
3. Sélectionner les types d'événements à recevoir
4. Gérer la vérification du webhook
5. Vérifier la signature du webhook
6. Traiter les événements entrants
7. Tester avec des événements exemples