Vue d'ensemble
Ce guide vous présente le processus complet étape par étape. Que vous créiez votre première intégration ou que vous fassiez évoluer un système existant, SocialHook simplifie la connexion des plateformes de messagerie Meta à votre infrastructure.
Pour commencer
La première chose dont vous avez besoin est un compte SocialHook. Une fois connecté, vous aurez accès à la livraison de webhooks en temps réel pour Facebook, Instagram et WhatsApp — depuis un seul tableau de bord.
Concepts clés
Comprendre comment SocialHook route les messages est essentiel avant de construire. Chaque message entrant de n'importe quelle plateforme connectée est normalisé dans une structure JSON cohérente et livré à votre point de terminaison webhook en moins de 50ms.
Le payload inclut toujours platform, event, timestamp et le contenu du message. Les informations sur l'expéditeur varient selon la plateforme mais sont toujours incluses.
Implémentation
Votre serveur doit répondre avec un code de statut 200 dans les 10 secondes. Dans le cas contraire, SocialHook réessaiera la livraison jusqu'à 3 fois avec un backoff exponentiel (5s, 25s, 125s). Toutes les tentatives de livraison sont enregistrées dans votre tableau de bord.
Sécurité
Vérifiez toujours l'en-tête X-SocialHook-Signature avant de traiter tout payload. Cette signature HMAC-SHA256 garantit que la requête provient de SocialHook et n'a pas été altérée.
Mise en production
Une fois que vous avez testé votre intégration webhook dans un environnement de staging, mettez à jour votre configuration SocialHook de production avec l'URL de votre point de terminaison en direct. Surveillez les journaux de livraison pendant les premières heures pour vous assurer que tout fonctionne correctement.