Intégration Webhook

Aperçu de l’intégration

Cette intégration vous permet de configurer un point de terminaison Webhook pour recevoir des données en temps réel de Pushwoosh, en particulier les événements de statut des e-mails, tels que E-mail envoyé, E-mail délivré, E-mail retourné, E-mail ouvert, etc.

Type d’intégration

Source : Les données sont envoyées de Pushwoosh à votre système via le webhook.

Glossaire

Point de terminaison Webhook : une URL côté serveur qui reçoit les requêtes HTTP POST de Pushwoosh. Les clients peuvent spécifier le port exact.

Exemple sans port : https://clientdomainname.com/webhook_endpoint
Exemple avec le port spécifié : https://clientdomainname.com:8081/webhook_endpoint

Entités synchronisées

Les événements de statut des e-mails qui fournissent des données sur les interactions des utilisateurs avec les messages que vous envoyez.

Configuration de l’intégration

Pour configurer l’intégration :

Dans votre compte Pushwoosh, allez dans Paramètres > Intégrations tierces et trouvez Intégration Webhook. Cliquez sur Configurer.

Dans la fenêtre qui s’ouvre, saisissez l’URL complète du point de terminaison du webhook et cliquez sur Appliquer.

Une fois la configuration réussie, vous commencerez à recevoir des requêtes de Pushwoosh.

Comment vérifier que l’intégration fonctionne

Une fois l’intégration configurée, vous recevrez des requêtes HTTP POST de Pushwoosh au point de terminaison webhook spécifié.

Corps de la requête Webhook

Nom du champ	Type	Requis	Description	Exemple
event_name	string	Oui	Le nom de l’événement	`"Email Sent"`
message_id	uint64	Non	L’ID unique du message associé à l’événement.	`200XXXX3258`
message_code	string	Oui	Le code du message associé à l’événement.	`"B780-XXXXXX3C-XXXX0375"`
campaign_id	uint64	Non	L’ID unique de la campagne associée à l’événement.	`96XXXX`
platform	string	Oui	La plateforme de l’appareil associée à l’événement (par ex., iOS, Android, E-mail).	`"Email"`
application_code	string	Oui	Le code de l’application associée à l’événement.	`"3XXXX-XXXX1"`
hwid	string	Oui	L’identifiant de l’appareil (HWID) associé à l’événement.	`"example@gmail.com"`
user_id	string	Oui	L’ID utilisateur (User ID) Pushwoosh associé à l’événement.	`"15XXXX8"`
payload	string	Non	Le contenu lié au message dépend de la plateforme. Pour les événements d’e-mail, cela contient l’objet de l’e-mail. Pour les autres plateformes, cela peut inclure différents contenus pertinents spécifiques à l’événement (par ex., le contenu ou le titre du message).	`"Ne manquez pas nos soldes d'été !"`
timestamp	int64	Oui	L’heure à laquelle l’événement s’est produit, au format d’horodatage UNIX.	`1723798222`
journey_title	string	Non	Le titre du parcours (Journey) associé à l’événement.	`"Summer sale"`
journey_point_title	string	Non	Le titre du point spécifique dans le parcours (Journey) associé à l’événement.	`"5_summer sale_new"`

Exemple de requête

{
  "event_name": "Email Sent",
  "message_code": "B780-XXXXXX3C-XXXX0375",
  "campaign_id": 96XXXX,
  "platform": "Email",
  "payload": "Don't miss our summer sale!",
  "application_code": "3XXXX-XXXX1",
  "hwid": "example@gmail.com",
  "user_id": "15XXXX8",
  "timestamp": 1723798222,
  "journey_title": "Summer sale",
  "journey_point_title": "5_summer sale_promoemail"
}