Automatiser les étiquettes de contact

​

Pourquoi les étiquettes sont-elles utiles

​

Configurer un workflow pour automatiser l’étiquetage des contacts

​

Exemple de cas :

​

Objectif :

​

Étapes

1. Avant de créer le workflow, nous devons générer un jeu unique de clés API à utiliser plus tard. Depuis le Dashboard, accédez à Compte->Paramètres et cliquez sur l’en-tête Clés API. Si nécessaire, générez une paire de clés API inutilisée via le bouton + Ajouter une clé API. Copiez-collez ces valeurs dans un document privé ou conservez-les d’une autre manière pour les utiliser plus loin dans la procédure.
2. Depuis Compte -> Automatisations des flux de travail dans le Dashboard, cliquez sur le bouton bleu + Ajouter un workflow.
   
3. Nommez le workflow de manière descriptive.
   
4. La première étape de filtrage de tout workflow est le Déclencheur. Nous voulons que l’objet du déclencheur soit un appel et, comme action du déclencheur, nous choisissons terminé. Cette combinaison fait en sorte que notre automatisation se déclenche à la fin d’un appel.
   
5. Notre objectif dans cet exemple nous oblige également à définir des Conditions supplémentaires. L’automatisation ne doit pas se déclencher après chaque appel terminé. Nous ne voulons d’abord pas inclure les appels sans temps de conversation, car il s’agirait d’appels perdus. Définissez ce filtre en créant une Condition avec une valeur dynamique. Cliquez dans le champ Propriété. Ensuite, dans la section Données utiles pour vos flux de travail à droite, cliquez sur talking_time pour remplir le champ avec la valeur dynamique correspondante. La notation obtenue doit correspondre à l’image ci-dessous. Comme Opérande, choisissez est supérieur à et, comme Valeur, saisissez 10 afin de compenser la latence de connexion éventuelle.
   
   Cette Condition filtrera les appels dont le temps de conversation est supérieur
   à dix secondes. 
   
6. Une autre Condition doit être ajoutée pour ne filtrer que les appels sortants. + Ajouter une condition. Remplissez le champ Propriété comme dans la condition précédente, cette fois avec la valeur dynamique de direction. Comme Opérande, choisissez est égal à, ce qui recherchera une correspondance exacte des caractères. Saisissez outgoing entièrement en minuscules comme Valeur. Si aucune autre condition n’est à ajouter, nous pouvons Confirmer et continuer.
   
7. Il existe trois types d’Action au choix. Pour les besoins de cet exemple, nous allons renvoyer des informations via l’api CloudTalk. Cela nécessite une Action Requête API.
8. L’Action Requête API est conçue pour être flexible ; les utilisateurs devront donc consulter de la documentation et des ressources supplémentaires afin de formater correctement les en-têtes et les valeurs. Comme cet exemple consiste à envoyer une requête API à l’api CloudTalk, nous pouvons nous référer à la Référence de l’API CloudTalk pour le format à utiliser. Nous devons d’abord saisir un Point de terminaison. Pour décomposer les choses, le point de terminaison nécessaire comprendra une référence à l’adresse web ou au token (https://my.cloudtalk.io/api), une référence à l’aspect de l’adresse que nous souhaitons manipuler (contacts), une référence au contact concerné (the contact id), une référence à la fonction que nous voulons exécuter pour ce contact (addTags), et enfin un type de format (.json). En suivant la documentation de l’API liée ci-dessus, le format de notre Point de terminaison ressemblera à : https://my.cloudtalk.io/api/contacts/addTags/{contactId}.json
   
   Comme Méthode, nous choisissons PUT, en demandant au système de bien vouloir placer de nouvelles informations dans la base de données si elles n’existent pas encore. Notez également que sur l’image, contactId est surligné, car il doit être remplacé par une valeur dynamique qui permettra à l’API de référencer l’identifiant réel d’un contact donné.
9. La référence de valeur dynamique à insérer à la place de {contactId} ressemble à ceci : #{{ event.properties.contacts[0].id }}
   
10. La plupart des appels d’API nécessitent une forme d’autorisation. C’est là qu’interviennent les Clés API récupérées sur notre page Paramètres. En raison de la manière créative dont nous envoyons une requête à l’API CloudTalk elle-même, nous devrons ouvrir un onglet séparé et faire appel à une plateforme d’API telle que Workato, SAP Integration ou AWS pour construire le format correctement encodé de notre en-tête d’autorisation. À titre d’exemple, vous trouverez ci-dessous une image de ce à quoi peut ressembler la combinaison de l’Access Key ID et de l’Access Key Secret, via l’interface Postman. Les deux clés seront saisies comme valeurs d’autorisation basique, et le résultat sera un en-tête formaté composé d’une Clé et d’une Valeur sous forme de chaîne chiffrée.
    
    Remarque : la navigation sur la page web et le nom des champs varieront légèrement selon la plateforme d'API utilisée. 
    
    
11. Une fois que nous avons obtenu une paire Clé:Valeur au bon format, nous saisissons ces séquences dans les champs du même nom sous En-têtes dans notre requête API CloudTalk.
    
12. Dans la section Valeurs de la requête, nous pouvons définir le nom de l’étiquette à ajouter lorsque l’automatisation se déclenche. Comme Clé, saisissez tags.0 pour référencer la liste des étiquettes. Saisissez le nom d’étiquette souhaité dans le champ Valeur.
    
13. S’il n’y a pas d’autres en-têtes ou valeurs à ajouter, nous pouvons vérifier notre Action Requête API et nous assurer que toutes les saisies sont au bon format. Ensuite, Confirmer et continuer.
14. Une fois l’automatisation enregistrée et définie sur Actif, elle peut commencer à s’exécuter. Lorsque les conditions sont remplies, notre étiquette outbound_lead est automatiquement ajoutée aux profils de contact qui ne la possèdent pas déjà.

​

Pourquoi mon automatisation ne fonctionne-t-elle pas ?

• ​

  Le compteur « exécutions ce mois-ci » n’augmente pas

  Cela signifie que l’automatisation n’est pas déclenchée, ce qui indique que les Conditions définies ne sont pas remplies. Assurez-vous que les Conditions sont logiques et qu’elles englobent les événements censés déclencher l’automatisation.

• ​

  Le compteur « exécutions ce mois-ci » augmente, mais mon action API ne se produit pas

  Cela résulte le plus souvent d’un problème dans la structure de l’API à l’étape Action de l’automatisation. Vérifiez que :
  • le point de terminaison est correctement formaté, comme indiqué dans les étapes ci-dessus
  • des valeurs dynamiques sont utilisées à la place d’espaces réservés de formatage comme « ContactId »
  • un en-tête d’autorisation a été correctement appliqué
  • les chaînes Clé de la partie Valeurs de la requête sont écrites dans le format attendu par l’interpréteur de l’API