Mise à jour des assistants de messagerie pour l’utilisation des connexions d’API sécurisées pour les appels API

Quelle est mon édition?

À compter du 31 mai 2023, vous ne pourrez authentifier les appels API REST d’un assistant de messagerie qu’en utilisant les connexions d’API. Un assistant de messagerie peut effectuer des appels API REST en utilisant l’étape Effectuer un appel API du Créateur de workflow.

Avant la sortie des connexions d’API, les administrateurs pouvaient authentifier les appels API REST d’un assistant de messagerie en transmettant les identifiants dans les en-têtes des demandes. Les connexions d’API sont un moyen plus pratique et plus sûr pour stocker ces identifiants.

Cet article vous explique le processus de mise à jour de vos assistants de messagerie pour qu’ils utilisent les connexions d’API. Cet article aborde les sujets suivants :

• En-têtes d’authentification non autorisés
• Mise à jour de l’étape Effectuer un appel API pour qu’elle utilise les connexions

En-têtes d’authentification non autorisés

Après le 31 mai 2023, les étapes Effectuer un appel API qui incluent des en-têtes associés à l’authentification échoueront automatiquement. Cela inclut les en-têtes suivants :

• authorization
• x-api-key
• x-api-token

En cas d’échec de l’étape Effectuer un appel API, la conversation suit la branche Échec de l’appel API de l’étape.

Mise à jour de l’étape Effectuer un appel API pour qu’elle utilise les connexions

Pour éviter toute perturbation, créez des connexions d’API pour stocker les identifiants API utilisés par nos assistants de messagerie. Mettez ensuite à jour toutes les étapes Effectuer un appel API associées dans les réponses de chaque assistant pour qu’elles utilisent les connexions pour l’authentification.

Pour mettre à jour une étape Effectuer un appel API pour qu’elle utilise une connexion d’API

1. Si une connexion d’API n’existe pas déjà pour l’identifiant, créez-en une dans le Centre d’administration. Consultez Création de connexions d’API pour le Créateur de workflow.

   Vous pouvez utiliser la même connexion d’API pour plusieurs assistants et étapes Effectuer un appel API.

2. Dans l’onglet Réponses de la page de modification de l’assistant, cliquez sur Modifier pour accéder au Créateur de workflow pour la réponse.
3. Dans le Créateur de workflow, cliquez sur l’étape Effectuer un appel API.
4. Dans l’étape, utilisez le menu déroulant Authentification pour sélectionner la connexion d’API associée.

   

5. Sous En-têtes, supprimez tous les en-têtes associés à l’authentification.

   

6. Cliquez sur Effectuer un appel API pour tester l’appel API en utilisant les identifiants de la connexion d’API.
7. Cliquez sur Terminé en haut à droite du Créateur de workflow.
8. Publiez l’assistant pour déployer les modifications.