Notifications push pour votre application : une API, une plateforme
Envoyez des notifications push aux utilisateurs de votre application depuis la même API REST que pour le SMS, WhatsApp et RCS, puis joignez sur un autre canal ceux qui n'ont pas ouvert l'application.
curl -X POST https://api.broadnet.me/push/message/send \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userRefs": ["user-10293"],
"title": "Your order has shipped",
"body": "Tap to track your parcel.",
"deepLink": "https://example.com/orders/8842",
"category": "UTILITY",
"priority": "HIGH",
"ttl": 3600
}'Requête de notification push envoyée à l'API OmniChannels.ai. Valeurs fictives.
En bref
Mis à jour le
OmniChannels.ai est un service et une API de notifications push pour applications mobiles. Vous appelez POST /push/message/send avec un titre, un texte et une audience : ID utilisateur, jetons d'appareil, topics ou segment. Les notifications peuvent inclure images, liens profonds et boutons d'action, utiliser des modèles, être programmées et validées par un test à blanc. Notre équipe connecte votre projet Firebase Cloud Messaging et, pour iOS, vos identifiants APNs à la mise en service.
Ce que fait l'API de notifications push
Ciblez par utilisateur, jeton, topic ou segment
Adressez vos propres ID utilisateur (userRefs), des jetons d'appareil FCM, des topics FCM ou un segment défini par pays, ville, langue et tags.
Notifications enrichies
Ajoutez une image HTTPS, un lien profond ouvert au toucher et des boutons d'action comme Confirmer ou Reporter.
Modèles enregistrés
Créez, prévisualisez, testez et publiez des modèles avec historique des versions, puis envoyez-les par templateId avec vos propres variables.
Priorité, durée de vie et programmation
Marquez les messages urgents en priorité haute, fixez une durée de vie, remplacez les anciennes notifications grâce à une clé de regroupement ou programmez l'envoi.
Test à blanc avant l'envoi
Définissez dryRun sur true pour valider une requête de bout en bout sans rien livrer à de vrais utilisateurs.
Contrôle des lots
Listez les lots, consultez leur détail, puis mettez en pause, reprenez ou interrompez un lot avec les endpoints dédiés.
Notifications déclenchées par la localisation
Les géorepérages peuvent déclencher des notifications selon la position. Notre équipe active le géorepérage pour votre application sur demande.
Statuts de livraison par webhook
Suivez les statuts de livraison sur l'URL de webhook configurée sur votre compte, comme pour les autres canaux.
Push, SMS ou WhatsApp : lequel choisir ?
Le push touche les personnes qui ont installé votre application. Le SMS et WhatsApp touchent un numéro de téléphone. La plupart des entreprises utilisent les trois, dans cet ordre de préférence pour chaque message.
| Canal | Touche | Idéal pour | Remarque |
|---|---|---|---|
| Notification push | Les utilisateurs qui ont installé votre application et enregistré un appareil | L'activité de l'application : statut de commande, rappels, offres in-app, réengagement | À utiliser en premier lorsque l'utilisateur est dans votre application. |
| Des clients consentants, via leur numéro de téléphone | Conversations riches, modèles, support et reçus | À utiliser lorsque vous avez besoin d'une conversation ou de médias. | |
| SMS | N'importe quel numéro mobile | Codes OTP, alertes urgentes et clients sans l'application ni WhatsApp | À utiliser comme solution de secours universelle. |
Comment commencer à envoyer des notifications push
Le push repose sur Firebase Cloud Messaging et, pour iOS, sur l'APNs d'Apple : une courte étape de mise en service vient donc en premier.
- 1
Connectez votre application
Notre équipe connecte votre projet Firebase Cloud Messaging et, pour iOS, vos identifiants APNs, puis vous communique l'ID de votre application.
- 2
Associez les appareils à vos ID utilisateur
Votre application enregistre chaque appareil sous votre propre identifiant, le userRef, pour que vous écriviez à des personnes plutôt qu'à des jetons.
- 3
Vérifiez une requête par un test à blanc
Appelez POST /push/message/send avec dryRun sur true et vérifiez que la requête est valide avant que de vrais utilisateurs ne voient quoi que ce soit.
- 4
Envoyez ou programmez
Envoyez à des userRefs, des jetons, des topics ou un segment, ou programmez l'envoi. Enregistrez les messages récurrents comme modèles.
- 5
Ajoutez un canal de secours
Décidez quels messages nécessitent un second canal, par exemple le SMS pour un OTP ou une alerte de livraison, et définissez l'ordre pour chaque cas d'usage.
Quand le push est-il le bon canal ?
Adapté si
- Vous avez une application mobile et voulez joindre les utilisateurs qui l'ont installée sans avoir besoin de leur numéro de téléphone.
- Vos messages sont liés à l'activité de l'application : statut de commande, rappels de rendez-vous, alertes de compte.
- Vous voulez une seule API et un seul format de webhook pour le push, le SMS, WhatsApp et les autres canaux.
- Vous voulez envoyer avec votre propre ID utilisateur plutôt que gérer des jetons d'appareil.
Bon à savoir avant de commencer
- Le push ne touche que les personnes qui ont installé votre application et autorisé les notifications.
- L'API documentée couvre le push des applications mobiles via FCM et APNs. Interrogez notre équipe sur tout ce qui dépasse ce cadre avant de bâtir votre plan dessus.
- Ne comptez pas sur le push seul pour les codes OTP ou les alertes critiques : ajoutez le SMS ou la voix en secours.
- Le géorepérage est activé sur demande pour votre application.
Questions sur le service de notifications push
Qu'est-ce qu'un service de notifications push ?
Un service de notifications push achemine de courts messages de vos serveurs vers les appareils des utilisateurs, même lorsque votre application est fermée. Sur Android, la livraison passe par Firebase Cloud Messaging, et sur iOS par l'APNs d'Apple. Un service comme OmniChannels.ai se place devant les deux et vous donne une seule API à appeler.
Comment fonctionne une API de notifications push ?
Votre application enregistre chaque appareil avec un jeton. Votre backend appelle ensuite l'API avec l'audience et le contenu, et le service transmet la notification à FCM ou à l'APNs pour la livraison. Avec OmniChannels.ai, vous appelez POST /push/message/send et pouvez cibler les utilisateurs par vos propres ID.
Quelle différence entre notifications push et SMS ?
Le push touche les personnes qui ont installé votre application et autorisé les notifications, et nécessite une connexion de données. Le SMS touche n'importe quel numéro mobile sans application. Le push convient aux mises à jour et à l'engagement in-app, le SMS aux codes OTP, aux alertes urgentes et aux clients sans votre application.
Puis-je envoyer une notification push à un segment d'utilisateurs ?
Oui. Outre les ID utilisateur, les jetons d'appareil et les topics, l'API accepte un objet segment avec des critères tels que le pays, la ville, la langue et les tags, accompagné de l'ID de votre application. Vous pouvez aussi programmer l'envoi et l'associer à un nom de campagne.
Puis-je tester une notification push avant de l'envoyer ?
Oui. Définissez dryRun sur true pour valider la requête sans rien livrer. Pour les modèles, vous pouvez prévisualiser avec des données d'exemple et envoyer un test sur votre propre appareil avant de publier une version.
Puis-je ajouter des images, des liens et des boutons ?
Oui. Les notifications peuvent inclure une image HTTPS, un lien profond ouvert au toucher, des données personnalisées pour votre application et des boutons d'action, chacun avec un ID, un titre et une action. Vous pouvez aussi envoyer des messages de données seules et des messages silencieux.
Que se passe-t-il si l'utilisateur n'a pas ouvert l'application ou a désactivé les notifications ?
Le push ne peut pas le joindre. Pour les messages importants, configurez un canal de secours comme le SMS ou WhatsApp. L'ordre de secours se définit par cas d'usage, et les statuts de livraison arrivent dans un seul format de webhook.
Comment démarrer ?
Réservez une démonstration. Notre équipe connecte votre projet Firebase et vos identifiants APNs lors de la mise en service, vous remet l'ID de votre application, puis vous appelez l'API avec votre jeton. La documentation développeur liste tous les endpoints push.
Guides sur ce sujet
- OmnicanalStratégie de repli multicanal : WhatsApp, RCS et SMS12 min de lecture
- SMS et OTPWhatsApp, SMS ou RCS : quel canal pour l'OTP et le marketing ?8 min de lecture
- IntégrationIntégration d'API de messagerie : REST, SMPP et webhooks9 min de lecture
- ConformitéConsentement (opt-in) : WhatsApp, SMS et e-mail en règle8 min de lecture
- OmnicanalMessagerie omnicanale : définition, architecture, exemples10 min de lecture
Découvrir le reste de la plateforme
Ajoutez le push à votre dispositif de messagerie
Parlez-nous de votre application. Nous connecterons FCM et APNs et vous montrerons le push aux côtés du SMS et de WhatsApp.
Présentez-nous votre stack et ce que vous souhaitez connecter. Un ingénieur solutions reviendra vers vous.