Messages transactionnels

L’envoi de messages opportuns et personnalisés à des individus ou à de petits groupes est essentiel pour offrir une excellente expérience client et maintenir l’engagement. Les messages transactionnels, tels que les codes à usage unique (OTP), les mises à jour de facturation ou les confirmations d’activité, vous permettent de partager des mises à jour significatives et en temps réel depuis votre serveur. Ce guide explique comment envoyer des messages transactionnels (push, e-mail ou SMS) avec l’API de OneSignal en utilisant des données personnalisées et des identifiants utilisateur.

Cas d’utilisation courants

Utilisez les messages transactionnels pour :

Envoyer des codes de connexion et de vérification (OTP)
Confirmer des commandes, des reçus ou des changements d’abonnement
Livrer des statuts de facturation ou des alertes de renouvellement
Rappeler aux utilisateurs des rendez-vous ou des échéances
Accuser réception d’actions clés (par ex. inscriptions ou achats)

Exigences

Avant d’envoyer des messages transactionnels, nous vous suggérons de consulter les guides suivants :

Comprendre les Users, Subscriptions et Aliases de OneSignal.
Configurer votre base de données, DMP ou CRM pour communiquer avec OneSignal ou utiliser l’une de nos Integrations.
Créer des Templates pour personnaliser vos messages.
Utiliser la syntaxe Liquid pour personnaliser vos messages.

Identification des utilisateurs

Pour cibler des utilisateurs individuels, vous devez les identifier dans OneSignal. L’approche recommandée consiste à définir un External ID, qui doit correspondre à l’identifiant utilisateur utilisé dans votre base de données ou CRM. OneSignal prend également en charge jusqu’à 20 alias par utilisateur, vous permettant d’associer plusieurs identifiants (par ex. other_user_id, facebook_id, etc.) à travers vos systèmes. Pour les e-mails et les SMS, vous pouvez également envoyer des messages directement en utilisant l’adresse e-mail ou le numéro de téléphone respectivement.

Ciblage des utilisateurs

Utilisez l’API Create Message pour envoyer des messages transactionnels sur les canaux push, e-mail et SMS en ciblant les utilisateurs via des alias, des adresses e-mail, des numéros de téléphone ou des ID d’abonnement.

Envoyer vers des alias (recommandé)

Utilisez include_aliases pour cibler l’external_id recommandé ou d’autres alias comme suit :

{
  "app_id": "YOUR_APP_ID",
  "include_aliases": {"external_id": ["userA", "userB"]},
  "contents": {"en": "English Message"},
  "target_channel": "push"
}

{
  "app_id": "YOUR_APP_ID",
  "include_aliases": { "alias_label": ["alias_id_1", "alias_id_2"] },
  "contents": { "en": "English Message" },
  "target_channel": "email"
}

Envoyer vers des abonnements

Si vous souhaitez envoyer vers des Abonnements spécifiques, vous pouvez utiliser la propriété include_subscription_ids. Cette option n’est pas recommandée car les utilisateurs peuvent avoir plusieurs Abonnements.

{
  "app_id": "YOUR_APP_ID",
  "include_subscription_ids": ["1dd608f2-c6a1-11e3-851d-000c2940e62c"],
  "contents": { "en": "English Message" }
}

Envoyer vers des adresses e-mail

Si vous avez l’adresse e-mail de l’utilisateur, vous pouvez lui envoyer des e-mails en utilisant la propriété include_email_tokens. Tous les e-mails inclus qui n’existent pas dans votre application OneSignal créeront automatiquement un nouvel abonnement e-mail.

{
  "app_id": "YOUR_APP_ID",
  "include_email_tokens": ["user1@email.com", "user2@email.com"],
  "email_subject": "Welcome to Cat Facts!",
  "email_body": "<html><head>Welcome to Cat Facts</head><body><h1>Welcome to Cat Facts</h1><h4>Learn more about everyone's favorite furry companions!</h4><hr/><p>Hi Nick,</p><p>Thanks for subscribing to Cat Facts! We can't wait to surprise you with funny details about your favorite animal.</p><h5>Today's Cat Fact (March 27)</h5><p>In tigers and tabbies, the middle of the tongue is covered in backward-pointing spines, used for breaking off and gripping meat.</p><a href='https://catfac.ts/welcome'>Show me more Cat Facts</a><hr/><p><small>(c) 2018 Cat Facts, inc</small></p><p><small><a href='[unsubscribe_url]'>Unsubscribe</a></small></p></body></html>"
}

Envoyer vers des numéros de téléphone

Si vous avez le numéro de téléphone de l’utilisateur, vous pouvez lui envoyer des SMS et MMS en utilisant la propriété include_phone_numbers. Tous les numéros de téléphone inclus qui n’existent pas dans votre application OneSignal créeront automatiquement un nouvel abonnement SMS.

{
  "app_id": "YOUR_APP_ID",
  "include_phone_numbers": ["+15555555555"],
  "contents": { "en": "English Message" }
}

Ajout de données personnalisées

Pour un contenu personnalisé, transmettez des custom_data spécifiques à l’utilisateur au message en utilisant des Templates et la syntaxe Liquid. Étapes pour ajouter des données personnalisées :

Créez un Template via le tableau de bord ou l’API Create template.
Ajoutez des variables Liquid (par ex., {{ message.custom_data.order_id }}) à votre template.
Référencez le template_id et les custom_data dans votre appel API Create Message.

{
  "app_id": "YOUR_APP_ID",
  "include_aliases": { "external_id": ["userA"] },
  "template_id": "8458af75-4da2-4ecf-afb5-f242a8926cc3",
  "custom_data": { "order_id": 123, "currency": "USD", "amount": 25 }
}

Exemple : Code à usage unique (OTP)

Identifiez l’utilisateur en utilisant un alias, un e-mail ou un numéro de téléphone.
Créez un Template qui inclut un code de vérification :

Votre code de vérification est {{ message.custom_data.verification_code }}

Générez le verification_code sur votre serveur lorsque l’utilisateur demande l’accès.
Saisissez la valeur verification_code dans la requête API.

{
  "app_id": "YOUR_APP_ID",
  "include_aliases": { "external_id": ["userA"] },
  "template_id": "8458af75-4da2-4ecf-afb5-f242a8926cc3",
  "custom_data": { "verification_code": "123456" }
}

Alternative : Si vous ne souhaitez pas utiliser de templates et custom_data, vous pouvez saisir la valeur de la variable directement dans le message avec une concaténation de chaînes. Par exemple :

{
  "app_id": "YOUR_APP_ID",
  "include_aliases": {"external_id": ["userA"]},
  "contents": {"en": "Your verification code is " + verification_code}
}

Dépannage

Pour include_aliases, l’alias doit être enregistré sur l’utilisateur au préalable.
Pour les e-mails/SMS, assurez-vous du formatage correct.

Tutoriels

🏢 Par secteur

📈 Augmenter l'engagement et la rétention

🔔 Délivrer des messages critiques ou urgents

🧠 Améliorer le ciblage et la personnalisation

🛠️ Améliorer l'expérience utilisateur et l'intégration

Messages transactionnels

Cas d’utilisation courants

Exigences

Identification des utilisateurs

Ciblage des utilisateurs

Envoyer vers des alias (recommandé)

Envoyer vers des abonnements

Envoyer vers des adresses e-mail

Envoyer vers des numéros de téléphone

Ajout de données personnalisées

Exemple : Code à usage unique (OTP)

Dépannage

Ressources supplémentaires

​Cas d’utilisation courants

​Exigences

​Identification des utilisateurs

​Ciblage des utilisateurs

​Envoyer vers des alias (recommandé)

​Envoyer vers des abonnements

​Envoyer vers des adresses e-mail

​Envoyer vers des numéros de téléphone

​Ajout de données personnalisées

​Exemple : Code à usage unique (OTP)

​Dépannage

​Ressources supplémentaires

Cas d’utilisation courants

Exigences

Identification des utilisateurs

Ciblage des utilisateurs

Envoyer vers des alias (recommandé)

Envoyer vers des abonnements

Envoyer vers des adresses e-mail

Envoyer vers des numéros de téléphone

Ajout de données personnalisées

Exemple : Code à usage unique (OTP)

Dépannage

Ressources supplémentaires