Envoyer un SMS opérationnel

Documentation :

http://webapi.mymarketing.co.il/api/docs/User/Api/POST-api-smscampaign-OperationalMessage

Vous pouvez envoyer un SMS opérationnel à plusieurs contacts à la fois.
L'exemple ci-dessous est simplifié et ne contient donc qu'un contact.

Le contact n'a pas besoin d'exister dans ActiveTrail, et il n'est pas créé après l'envoi du SMS.

Les SMS opérationnels peuvent être envoyés aux contacts de tous les statuts, sauf les non-livrés. La même logique des messages opérationnels s'applique à l'e-mail, au SMS et à WhatsApp. Le réglage du lien de désinscription et l'option d'envoi aux contacts inactifs se gèrent séparément : chacun se règle indépendamment.

Envoi fiable des SMS opérationnels : les SMS opérationnels peuvent continuer à partir même quand la base de données clients est momentanément indisponible : cette dépendance est contournée pour que les messages critiques (codes de vérification, alertes, notifications de service) continuent d'être envoyés. Comme les crédits ne sont déduits qu'une fois la base de données rétablie, le compte peut afficher temporairement un solde de crédits SMS négatif. Cette option n'est disponible que pour certains comptes.

Si le contact se désinscrit, il est créé dans ActiveTrail avec le statut « Désinscrit ».

Les paramètres :

  • unsubscribe_text : le texte de désinscription (par exemple « Cliquez ici pour vous désinscrire »). Utilisé quand can_unsubscribe vaut true.

  • can_unsubscribe : ajouter ou non un lien de désinscription.

  • name : le nom de la campagne dans ActiveTrail.

  • sms_sending_profile_id : l'ID du profil expéditeur (la façon de l'obtenir est détaillée dans l'article sur les profils expéditeur). Dans ce cas, le contact voit un numéro de téléphone comme expéditeur.

  • from_name : le nom de l'expéditeur affiché au destinataire. Le système vérifie d'abord si ce nom correspond à l'un des profils expéditeur du compte. Si c'est le cas, le message est envoyé. Sinon, le système vérifie si le compte est autorisé à utiliser un nom d'expéditeur en texte libre (le support ActiveTrail peut l'activer). Si oui, un nom d'expéditeur personnalisé peut être utilisé à condition de contenir au moins une lettre latine ; sinon, le message échoue avec une erreur de validation. Si le compte n'y est pas autorisé, un nom d'expéditeur qui ne correspond à aucun profil expéditeur renvoie une erreur.

À noter : si vous utilisez un profil expéditeur, n'ajoutez pas de texte libre, et inversement.

  • send_now : le message est envoyé tout de suite (doit valoir true).

  • scheduled_date_utc : programme le message à l'heure choisie.

À noter (2) : si vous envoyez tout de suite, n'indiquez pas de date de programmation, et inversement.

JSON :

{
"details": {
"unsubscribe_text": "sample string 1",
"can_unsubscribe": true,
"name": "sample string 3",
"sms_sending_profile_id": 5,
"from_name": "sample",
"content": "lets use API!"
},
"scheduling": {
"send_now": true
},
"mobiles": [
{
"phone_number": "0525162600"
}
]
}

Voir le contenu d'un SMS opérationnel envoyé

Le contenu de chaque message opérationnel envoyé peut être prévisualisé dans l'interface d'ActiveTrail. Ouvrez la liste des messages opérationnels et cliquez sur le message pour prévisualiser son contenu.

À noter : il n'est pas possible de récupérer ni de prévisualiser par l'API le contenu d'un message opérationnel envoyé. La prévisualisation n'est disponible que dans l'interface.