Développeurs : clés API, déclencheurs et webhooks
Connectez vos autres systèmes : invitez un client juste après un événement et recevez les résultats dès leur arrivée. À quoi sert chaque élément, sans code.
Ce que vous allez apprendre
- Savoir à quoi servent les clés API, les déclencheurs et les webhooks
- Créer et révoquer une clé
- Ajouter un webhook et lire son journal d’envois
- Tester un déclencheur
À quoi sert chaque élément
- Clé API : un secret que votre autre système utilise pour communiquer avec SmartSurv. Chaque clé appartient à votre organisation.
- Déclencheur : votre système demande à SmartSurv d’inviter une personne à un sondage en cours juste après un événement : un appel, une livraison, une visite en agence. Par exemple une note en une touche après chaque appel.
- Webhook : SmartSurv prévient votre système lorsqu’un événement se produit : une réponse complète, un paiement réussi ou une alerte déclenchée.
Étape par étape
- Ouvrez le menu de gauche Paramètres → Développeurs (app.smartsurvafrica.com/settings/developers).
- Dans Clés API, créez une clé avec un Nom de la clé comme « Centre de contact (note après appel) ». La clé n’est affichée qu’une seule fois : copiez-la tout de suite dans le coffre à secrets de votre système.
- Pour désactiver une clé, appuyez sur Révoquer. Les requêtes qui l’utilisent s’arrêtent immédiatement.
- Dans Webhooks, appuyez sur Ajouter un webhook, saisissez l’URL de destination fournie par vos développeurs et cochez les Événements : Réponse complète, Paiement réussi, Alerte. Le Secret de signature n’est affiché qu’une fois : transmettez-le à vos développeurs.
- Appuyez sur le bouton de test pour envoyer un événement de test. Le Journal des envois affiche chaque tentative et la réponse obtenue.
- Dans Console de test des déclencheurs, choisissez un Sondage en cours, un Téléphone, une Référence externe facultative et l’Origine du consentement, puis envoyez un déclencheur de test.
Ce que vous verrez
- « Vous ne reverrez plus cette clé. » après la création d’une clé.
- Les envois échoués sont automatiquement retentés pendant quelques heures.
Testez-vous
Choisissez une réponse pour chaque question, puis appuyez sur Vérifier mes réponses. Rien n’est enregistré ni envoyé.