Intégration du streaming d'événements

Source : les données sont envoyées de Pushwoosh vers votre système via HTTP ou gRPC en fonction des déclencheurs d’événements configurés.

Pushwoosh transmet les données d’événements de communication (par ex., l’activité push/email) à un point de terminaison défini par le client. Les données sont envoyées par lots à des intervalles planifiés ou lorsqu’une taille de lot minimale est atteinte.

Les données ne sont envoyées que si elles correspondent aux événements, plateformes et filtres optionnels sélectionnés (codes de campagne/message, activité en direct). Le point de terminaison client doit être prêt à recevoir et éventuellement à répondre avec un statut.

URL du point de terminaison : point de terminaison côté serveur qui permet de recevoir des requêtes. Le client peut spécifier un port si nécessaire.

Exemples :

• https://clientdomainname.com/webhook_endpoint
• https://clientdomainname.com:8081/webhook_endpoint

• Événements de statistiques de communication (par ex., Push envoyé, E-mail délivré)

• Suivi de l’engagement en temps réel

Surveillez les interactions des utilisateurs telles que l’envoi d’un push, l’ouverture d’un e-mail ou la livraison d’un message au moment où elles se produisent, offrant ainsi une visibilité immédiate sur les performances de la campagne.

• Intégration avec des outils d’analyse externes

Diffusez des événements vers des plateformes d’analyse tierces pour un reporting et une analyse centralisés.

• Workflows utilisateur automatisés

Déclenchez des actions dans des systèmes externes (comme les CRM ou les outils d’automatisation du marketing) en fonction du comportement des utilisateurs, par exemple, envoyer un message de suivi lorsqu’un utilisateur ouvre un e-mail.

Pour configurer l’intégration :

1. Dans votre compte Pushwoosh, allez dans Paramètres > Intégrations tierces, trouvez l’Intégration de streaming d’événements, et cliquez sur Configurer.

2. Dans la fenêtre qui s’ouvre, remplissez les champs nécessaires.

Dans le champ URL du point de terminaison, saisissez l’URL complète où les événements seront envoyés, y compris le protocole et le port le cas échéant.

Exemple

• https://clientdomainname.com/webhook_endpoint
• https://clientdomainname.com:8081/webhook\_endpoint

Dans le menu déroulant Événements, sélectionnez au moins un événement. Si aucun n’est sélectionné, la validation échouera. La liste des événements est gérée par le backend et peut changer au fil du temps.

Si votre serveur l’exige, saisissez la valeur complète de l’en-tête Authorization dans le champ Autorisation.

Exemples :

• Bearer your_token_here

• Basic base64encoded_credentials

Dans le menu déroulant Type de transport, choisissez le protocole de livraison pour la transmission des événements : HTTP ou gRPC. Chacun a un comportement et une configuration spécifiques.

Avec le type de transport HTTP, Pushwoosh envoie les données par lots en fonction de l’une des conditions suivantes :

• Au moins 100 événements sont prêts à être envoyés, ou

• Une heure s’est écoulée depuis la dernière transmission.

Après l’envoi des données, la connexion est fermée une fois qu’une réponse positive est reçue.

Si le serveur répond avec une erreur 5xx, Pushwoosh réessaiera la requête conformément à la politique de nouvelle tentative définie.

Mécanisme de nouvelle tentative

Si toutes les nouvelles tentatives échouent, la requête est abandonnée.

Délai d’attente

Le délai d’attente par défaut pour une requête est de 30 secondes. Il peut être personnalisé sur demande via le support.

Le type de transport gRPC utilise le streaming bidirectionnel pour la transmission des données. Pour en savoir plus, consultez la documentation gRPC.

Un flux est ouvert lorsque l’une des conditions suivantes est remplie :

• Au moins 1 000 événements sont prêts à être livrés
• Une heure s’est écoulée depuis l’ouverture du dernier flux

Le flux est fermé après l’envoi des événements. Cela garantit qu’un nouveau flux n’est pas ouvert pour chaque événement individuel dans un court laps de temps.

Mécanisme de nouvelle tentative
Chaque événement inclut un uuid unique. Si un événement échoue :

1. La réponse doit inclure un status différent de "Success"
2. L’uuid original de la requête doit être inclus

Pushwoosh réessaiera la livraison en fonction de cette réponse.

Paramètres de connexion

Les options avancées comme TLS, keep-alive ou les politiques de nouvelle tentative sont configurées manuellement via le support et peuvent nécessiter l’intervention de développeurs.

Dans la section Plateformes, sélectionnez au moins une plateforme pour activer le streaming d’événements.

Les plateformes prises en charge incluent :

• iOS, Android, macOS, Windows, Amazon, Safari
• Chrome, Firefox, Internet Explorer, Baidu, Huawei
• E-mail, SMS, Line, Xiaomi, WhatsApp

Dans la section Filtres avancés, affinez les critères de livraison des événements à l’aide de filtres :

• Événements d’activité en direct : activez pour recevoir les événements d’activité en direct. Ces événements ne contiennent que des métadonnées, y compris le live_activity_id.

• Filtres de campagne : filtrez par code de campagne. Seuls les événements liés à ces campagnes seront livrés.

• Filtres de message : filtrez par code de message. Seuls les événements liés à ces messages seront livrés.

Après avoir rempli tous les champs obligatoires, cliquez sur le bouton Appliquer pour enregistrer et activer votre intégration.

Exemple de corps de requête

{
  "event_name": "Email Opened",
  "message_code": "E682-E6D92B9A-53E24868",
  "campaign_id": 961048,
  "platform": "Email",
  "payload": "Welcome to Headway! 👋",
  "application_code": "32E5A-9B411",
  "hwid": "irun4716@gmail.com",
  "user_id": "1894410",
  "timestamp": 1723799271,
  "journey_title": "",
  "journey_point_title": "5_Welcome_ID_new"
}

Réponse
Pour le moment, le code de réponse et le corps sont ignorés.

Vous commencerez à recevoir des requêtes de Pushwoosh sur le point de terminaison que vous avez configuré.