Webhooks push web

​

Aperçu

• Suivez l’engagement des notifications en temps réel
• Déclenchez des flux de travail automatisés basés sur les interactions des utilisateurs
• Synchronisez les données de notification avec votre plateforme d’analyse
• Implémentez une logique métier personnalisée pour les événements de notification

​

Support des navigateurs

​

Événements webhook disponibles

​

notification.willDisplay

​

notification.clicked

​

notification.dismissed

​

Méthodes de configuration

• Configuration du tableau de bord (recommandé pour la plupart des utilisateurs)
• Intégration de code personnalisé

1

Naviguez vers Paramètres > Web dans votre tableau de bord OneSignal

2

Activez le bouton “Activer les webhooks”

3

Entrez vos URL de webhook pour chaque événement que vous souhaitez suivre

Ajoutez la configuration de webhook à votre méthode OneSignal.init() existante :

Copier

Demander à l'IA

// Ajoutez à votre initialisation OneSignal existante - N'appelez PAS init deux fois
OneSignal.init({
  // Vos autres paramètres existants ici
  webhooks: {
    cors: false, // Recommandé : laissez sur false sauf si vous avez besoin d'en-têtes personnalisés
    'notification.willDisplay': 'https://votresite.com/webhook/display',
    'notification.clicked': 'https://votresite.com/webhook/click',
    'notification.dismissed': 'https://votresite.com/webhook/dismiss' // Chrome uniquement
  }
});

​

Configuration CORS

• cors: false (recommandé) : Configuration plus simple, aucune configuration CORS nécessaire sur votre serveur
• cors: true : Fournit des en-têtes supplémentaires mais nécessite la prise en charge CORS sur votre serveur

• Vous avez besoin de l’en-tête Content-Type: application/json
• Vous voulez l’en-tête X-OneSignal-Event pour une identification plus facile des événements
• Votre serveur prend déjà en charge CORS pour les requêtes non simples

​

Format de requête webhook

​

Requête standard (cors: false)

{
  "event": "notification.clicked",
  "notificationId": "ed46884e-0e3f-4373-9e11-e28f27746d3d",
  "heading": "Votre titre de notification",
  "content": "Votre message de notification",
  "additionalData": {
    "userId": "12345",
    "campaignId": "summer-sale",
    "customField": "customValue"
  },
  "actionId": "buy-now-button",
  "url": "https://yoursite.com/product/123"
}

​

Requête améliorée (cors: true)

Content-Type: application/json
X-OneSignal-Event: notification.clicked

​

Référence des champs de payload

​

Meilleures pratiques d’implémentation

​

Exigences du point de terminaison webhook

• Utilisez uniquement des URL HTTPS (les URL HTTP seront bloquées par Chrome)
• Implémentez une authentification/validation appropriée pour vos points de terminaison webhook
• Envisagez une limitation de débit pour gérer les notifications à volume élevé

• Retournez un statut HTTP 200 pour un traitement réussi
• Répondez dans les 10 secondes pour éviter les timeouts
• Gérez les appels de webhook en double avec élégance (implémentez l’idempotence)

​

Gestion des erreurs

// Exemple de point de terminaison webhook (Node.js/Express)
app.post('/webhook/notification', (req, res) => {
  try {
    const { event, notificationId, additionalData } = req.body;

    // Valider les champs requis
    if (!event || !notificationId) {
      return res.status(400).json({ error: 'Champs requis manquants' });
    }

    // Traiter les données du webhook
    processNotificationEvent(req.body);

    // Toujours répondre avec 200 OK
    res.status(200).json({ success: true });
  } catch (error) {
    console.error('Erreur de traitement du webhook:', error);
    res.status(500).json({ error: 'Erreur interne du serveur' });
  }
});

​

Problèmes courants et solutions

​

Les webhooks ne se déclenchent pas

• Le code webhook n’est pas présent sur toutes les pages avec l’initialisation OneSignal
• L’utilisateur n’a pas visité une page avec le code webhook après son ajout
• L’exigence HTTPS n’est pas satisfaite
• Le serveur retourne des codes de statut non-200

​

Données manquantes dans les webhooks

​

Appels de webhook en double

​

Limitations des webhooks

• Une URL de webhook par événement : Vous ne pouvez pas définir plusieurs URL de webhook pour le même type d’événement
• HTTPS uniquement : Les URL HTTP ne fonctionneront pas en raison des restrictions de sécurité du navigateur
• Suivi du rejet Chrome uniquement : L’événement notification.dismissed ne fonctionne que dans Chrome
• Dépendance de page : Les utilisateurs doivent visiter des pages avec le code webhook actif pour que le suivi fonctionne

​

Tester vos webhooks

1. Envoyez une notification de test via votre tableau de bord OneSignal
2. Surveillez votre point de terminaison webhook pour les requêtes entrantes
3. Vérifiez que la structure du payload correspond à vos attentes
4. Testez différents scénarios :
   • Affichage de notification
   • Clic sur le corps de la notification
   • Clic sur les boutons d’action (si configurés)
   • Rejet des notifications (Chrome uniquement)

​

Étapes suivantes

• Intégration d’analyses : Transférez les données de webhook vers votre plateforme d’analyse
• Segmentation des utilisateurs : Utilisez les événements webhook pour créer des segments d’utilisateurs basés sur l’engagement
• Flux de travail automatisés : Déclenchez des campagnes par email ou des notifications d’application basées sur les interactions avec les notifications push
• Tests A/B : Utilisez les données de webhook pour mesurer l’efficacité de différentes stratégies de notification