Les postbacks sont des notifications automatisées envoyées depuis GelatoConnect vers des systèmes externes chaque fois que le statut d'une commande change. Ils sont essentiels pour tenir les Fournisseurs de Services d'Impression (FSI) et les clients informés de leurs commandes en temps réel, sans nécessiter de mises à jour manuelles.
Les postbacks vous permettent de :
Informez automatiquement vos clients lorsque le statut de leur commande change (par ex. reçue, expédiée, livrée).
Alertez votre équipe concernant les commandes nécessitant une attention particulière (commandes échouées).
Mettez à jour vos systèmes de gestion des stocks lorsque les commandes sont terminées.
Suivez la progression des commandes tout au long de votre processus de traitement des commandes.
Ces notifications peuvent être transmises via webhooks (URL) ou par e-mail, selon vos besoins d'intégration.
Prérequis pour configurer les postbacks
Avant de créer des postbacks, assurez-vous d'avoir :
Les clients qui recevront des notifications sont configurés dans la section clients de GelatoConnect.
Les points de terminaison URL sont prêts à recevoir les données webhook (si vous utilisez la méthode de livraison URL).
Une compréhension de base des modèles et des déclencheurs.
Connaissance du flux des statuts de commande dans GelatoConnect.
Guide étape par étape pour configurer les postbacks
1. Créer un modèle de postback
Les modèles définissent la structure et le contenu de vos notifications de postback. Vous pouvez les créer de deux façons :
Option A : Via la section des modèles
Accédez à Flux de travail > Réception des commandes > Modèles
Cliquez sur Ajouter un modèle
Sélectionnez le type de modèle :
Déclencheur : Webhook - Pour envoyer des données JSON ou XML vers des systèmes externes
Déclencheur : E-mail - Pour envoyer des notifications par e-mail
Choisissez le format approprié (JSON ou XML)
Option B : Via le profil client
Accédez au profil de votre client
Accédez à l'onglet Déclencheurs et cliquez sur Ajouter un déclencheur
Vous pourrez créer le modèle directement dans la configuration du déclencheur
Pour des conseils détaillés sur la création de modèles, consultez Création de modèles pour la réception des commandes.
2. Configurer un déclencheur
Les déclencheurs déterminent quand les retours d'information sont envoyés et où ils sont livrés :
Nommez votre déclencheur de façon descriptive (par ex., « Notification de commande expédiée »)
Sélectionnez l'événement qui activera le déclencheur :
Commande reçue
La commande a échoué
Commande annulée
Commande retournée
Commande produite
Commande livrée
Commande expédiée
commande en transit
Choisissez votre mode de livraison :
URL (webhook) : Envoie des données vers un point de terminaison spécifié
E-mail : Envoie des notifications par e-mail
Pour la livraison par URL, configurez :
L'URL de destination où les notifications seront envoyées
Définir la méthode sur POST (recommandé)
Vous pouvez choisir JSON ou XML comme format de données
Activez \"Réessayer en cas d'échec\" pour plus de fiabilité
Pour la livraison par e-mail, configurez l'adresse e-mail du destinataire.
3. Ajouter un modèle
Votre modèle transforme les données internes de GelatoConnect en un format exploitable pour vos systèmes et ceux de vos clients.
Si un modèle est déjà créé, vous pouvez le sélectionner lors de la configuration du déclencheur, sinon, vous devrez en créer un nouveau.
Donnez à votre modèle un nom explicite (par exemple, « OrderShippedNotification »)
Utilisez les exemples de charges utiles fournis pour votre type d'événement sélectionné
Associez les champs de données d'entrée au format de sortie souhaité à l'aide du Template Mapper
Exemple de modèle pour l'événement « Commande expédiée » :
{ \"event\": \"Commande expédiée\", \"orderId\": \"##{{ orderId }}\", \"orderReferenceId\": \"##{{ orderReferenceId }}\", \"timestamp\": \"##{{ created }}\", \"status\": \"##{{ fulfillmentStatus }}\", \"trackingInfo\": { {% for item in items %} {% for fulfillment in item.fulfillments %} \"trackingCode\": \"##{{ fulfillment.trackingCode }}\", \"trackingUrl\": \"##{{ fulfillment.trackingUrl }}\", \"carrier\": \"##{{ fulfillment.carrierName }}\" {% endfor %} {% endfor %} }}Utilisez le bouton \"Render\" pour prévisualiser l'apparence de votre résultat
Testez le modèle pour vous assurer qu'il génère le résultat attendu
Pour plus d'exemples de modèles, consultez Exemples de mappeur de modèles.
4. Tester et activer
Avant de mettre en service votre postback, envoyez quelques tests pour vérifier que tout fonctionne comme prévu. Vous pourrez ensuite modifier les statuts de votre déclencheur et de votre modèle pour les activer.
Une fois ces étapes terminées, le système enverra un retour d'information à l'URL ou à l'adresse e-mail désignée avec les informations pertinentes de la commande chaque fois que l'événement de commande spécifié se produit.
Techniques avancées de postback
Utilisation des recherches dans vos modèles
Les recherches sont utiles pour associer des valeurs internes à des formats adaptés aux clients :
{% set carrier = lookups({\"shipmentMethodUid\": fulfillment.carrierUid}, strict=False, default=\"\") %}\"transporteur\" : \"##{{ carrier }}\"Ceci convertit les codes internes GelatoConnect en valeurs plus significatives pour vos clients. En savoir plus dans Comment configurer les recherches.
Champs de données spécifiques à l'événement
Différents événements fournissent différents champs de données. Voici les principaux champs disponibles pour les événements courants :
Commande expédiée/livrée : codes de suivi, informations sur le transporteur, dates de livraison
Commande échouée/annulée : motifs d'erreur, horodatages
Commande reçue : détails de la commande, informations sur les articles
Pour une compréhension complète de ces champs, consultez Introduction aux Template Mappers dans GelatoConnect.
Dépannage des postbacks
Si vos retours de données ne fonctionnent pas comme prévu :
Vérifiez que l'URL de destination est correcte et accessible
Vérifier la syntaxe du modèle pour détecter les erreurs
Confirmez que le déclencheur est correctement configuré pour l'événement approprié
Recherchez les types de données incompatibles ou les champs manquants
Testez le modèle avec des données d'exemple avant de l'activer
Pour les retours d'information par e-mail spécifiquement :
Vérifiez que les détails de votre serveur SMTP sont corrects (si configuré)
Vérifiez que l'adresse e-mail de l'expéditeur est correctement formatée
Assurez-vous que votre serveur SMTP autorise la connexion depuis GelatoConnect
Vérifiez si les informations d'authentification (nom d'utilisateur/mot de passe) sont correctes
Pour des conseils plus complets sur le dépannage, consultez la section « Dépannage » dans Création de modèles pour la réception des commandes.
Configuration de votre serveur de messagerie pour les retours d'information
En tant que prestataire de services d'impression, vous pouvez configurer GelatoConnect pour envoyer des notifications par e-mail en utilisant votre propre serveur de messagerie. Ainsi, les destinataires verront des e-mails provenant de votre domaine plutôt que de GelatoConnect, ce qui préserve la cohérence de votre marque.
Pour configurer les paramètres de votre serveur de messagerie :
Accédez à la section Workflow dans la barre latérale gauche
Trouvez la section Configuration et sélectionnez Paramètres de travail
Localisez la section Paramètres du serveur de messagerie sortant
Saisissez les informations suivantes :
Adresse e-mail de l'expéditeur : L'adresse e-mail qui apparaîtra dans le champ « De »
Nom de l'expéditeur : Le nom qui apparaîtra à côté de l'adresse e-mail
Serveur SMTP : L'adresse de votre serveur de messagerie (par ex., smtp.votreentreprise.com)
Port SMTP : Le port utilisé par votre serveur de messagerie (généralement 587 ou 465)
Nom d'utilisateur SMTP : Le nom d'utilisateur pour s'authentifier auprès de votre serveur SMTP
Mot de passe SMTP : Le mot de passe pour votre serveur SMTP
Utiliser TLS : Activez cette option si votre serveur SMTP nécessite le chiffrement TLS (recommandé)
Enregistrez votre configuration
Une fois la configuration terminée, tous les retours d’e-mails passeront par votre serveur de messagerie, ce qui garantit une image de marque cohérente et améliore la délivrabilité auprès de vos clients.
Prochaines étapes
Après avoir configuré vos postbacks :
Surveillez le succès des livraisons dans la page Demandes au sein de la Réception des commandes.
Vérifiez auprès de vos clients qu'ils reçoivent correctement les notifications
En mettant en place un système de postback robuste, vous améliorerez l'expérience de vos clients grâce à des mises à jour de commande en temps réel tout en réduisant la communication manuelle.