Question 1

Quels champs sont communs à toutes les plateformes ?

Accepted Answer

Chaque payload SocialHook inclut : platform (facebook/instagram/whatsapp), event (message.received/conversation.started/status.update), timestamp, webhook_id, conversation_id et un objet message.

Question 2

Comment vérifier l'authenticité d'un payload ?

Accepted Answer

Vérifiez l'en-tête X-SocialHook-Signature, qui contient sha256=<hex> — un HMAC-SHA256 du corps de la requête brute signé avec votre clé secrète. Calculez le même hash côté serveur et comparez en utilisant une fonction sécurisée contre les attaques de timing.

Question 3

Les formats de payload sont-ils cohérents entre les plateformes ?

Accepted Answer

Oui. Les champs communs utilisent la même structure entre Facebook, Instagram et WhatsApp. Les champs spécifiques aux plateformes (comme le numéro de téléphone WhatsApp ou le @nom d'utilisateur Instagram) sont imbriqués dans la section spécifique à la plateforme du payload.

Question 4

Qu'est-ce que le champ conversation_id ?

Accepted Answer

conversation_id est un identifiant stable pour le fil de discussion entre un utilisateur spécifique et votre compte de plateforme connecté. Utilisez-le pour regrouper les messages du même utilisateur à travers plusieurs interactions.

Champ	Type	Description
`platform`	`string`	"facebook" \| "instagram" \| "whatsapp"
`event`	`string`	"message.received" \| "conversation.started" \| "status.update"
`timestamp`	`number`	Horodatage Unix (secondes) du moment où l'événement s'est produit
`webhook_id`	`string`	L'identifiant de votre configuration webhook SocialHook
`conversation_id`	`string`	Identifiant stable pour le fil de conversation
`message`	`object`	Objet de contenu du message (varie selon la plateforme et le type)

Champ	Type	Description
`from`	`string`	Numéro de téléphone de l'expéditeur au format E.164 (+15550001234)
`profile.name`	`string`	Nom d'affichage WhatsApp de l'expéditeur
`message.type`	`string`	"text" \| "image" \| "audio" \| "video" \| "document" \| "location" \| "sticker"
`message.body`	`string`	Texte du message (pour type="text")
`message.media_url`	`string`	URL pour télécharger les médias (pour image/audio/vidéo/document)

Champ	Type	Description
`from.id`	`string`	Identifiant utilisateur Facebook de l'expéditeur (PSID)
`from.name`	`string`	Nom d'affichage Facebook de l'expéditeur
`page_id`	`string`	Identifiant de la page Facebook qui a reçu le message
`message.text`	`string`	Contenu textuel du message
`message.attachments`	`array`	Tableau d'objets de pièces jointes pour les images, vidéos, etc.

Champ	Type	Description
`from.id`	`string`	Identifiant utilisateur Instagram de l'expéditeur
`from.username`	`string`	@nom d'utilisateur de l'expéditeur
`account_id`	`string`	Identifiant du compte Instagram Business
`message.text`	`string`	Contenu textuel du DM
`story_id`	`string`	Identifiant de la story lorsque le message est une réponse à une story (optionnel)

Référence des payloads

Champs communs (toutes plateformes)

WhatsApp— champs spécifiques

Facebook— champs spécifiques

Instagram— champs spécifiques