Language selection

Rechercher

Fonctions de rappel

Les fonctions de rappels peuvent automatiser la production d’un accusé de réception ou maintenir l’état d’une notification dans votre base de données.

Une fonction de rappel vous permet de recevoir des messages sur l’état des notifications de GC Notification à une adresse URL de votre choix. Les rappels sont lorsque GC Notification envoie des requêtes HTTP POST à votre service. Vous pouvez obtenir des rappels lorsqu’un courriel ou un message texte que vous avez envoyé est livré ou échoue.

Vous devrez fournir un jeton Bearer, pour des raisons de sécurité. Nous ajouterons ceci à l’en-tête Authorization de la demande de rappel.

#Configurer des fonctions de rappel

Vous devez fournir :

  • une adresse URL de destination vers laquelle GC Notification effectuera une requête HTTP
  • un jeton Bearer, pour des raisons de sécurité, que GC Notification placera dans l’en-tête Authorization des demandes

Pour ce faire :

  1. Connectez-vous à GC Notification (opens new window).
  2. Allez à la page Intégration API.
  3. Sélectionnez Fonctions de rappel.

Lors de la création d’un jeton Bearer, vous devez :

  • garder votre jeton Bearer sécurisé
  • le changer si vous avez une raison de penser qu’on ne peut plus lui faire confiance
  • Assurez-vous que les fonctions de rappel que vous recevez de GC Notification contiennent votre jeton Bearer dans l’en-tête Authorization
  • utiliser une valeur hachée pour que GC Notification ne contienne pas le vrai jeton

#Accusés de réception de message

Lorsque vous envoyez un courriel ou un message texte, GC Notification envoie un accusé de réception à votre adresse URL de rappel pour vous dire s’il a été livré ou non. Il s’agit d’une méthode automatisée pour obtenir l’état des messages.

Cette fonctionnalité fonctionne avec les clés API de test, mais ne fonctionne pas avec les adresses de courriel ou les numéros de téléphone de test de détection de fumée.

Le message de la fonction de rappel est formaté en JSON. Toutes les valeurs sont des chaînes de caractères. Voici la clé, la description et le format des arguments du message de la fonction de rappel :

CléDescriptionFormat de la chaîne
idID de GC Notification pour les accusés d’étatUUID
referenceRéférence envoyée par le service12345678
toL’adresse de courriel ou numéro de téléphone du destinatairehello@canada.ca ou 01234567890
statusÉtat de la notificationdeliveredpermanent-failuretemporary-failure ou technical-failure
provider_responseLa réponse détaillée venant du fournisseur. Ceci sera renseigné uniquement lorsque l’état de la notification est une erreur techniqueBlocked as spam by phone carrier (ou tout autre message) ou nul
created_atHeure à laquelle le service a envoyé la demande2017-05-14T12:15:30.000000Z
completed_atDernière mise à jour de l’état2017-05-14T12:15:30.000000Z ou nul
sent_atHeure d’envoi de la notification2017-05-14T12:15:30.000000Z ou nul
notification_typeType de notificationemail ou sms

Plusieurs fonctions de rappel pour une notification<br>

Vous pouvez recevoir plusieurs fonctions de rappel pour une seule notification envoyée. Par exemple, il est possible que le serveur de messagerie destinataire accepte le courriel (envoyant une fonction de rappel de livraison réussie), mais après avoir traité le courriel, le serveur de messagerie peut déterminer qu’en réalité ce courriel retourne un échec (envoyant une fonction de rappel d’échec).

Les fonctions de rappel sont envoyées dans l’ordre où elles sont reçues.

Date de modification :