Flux de messagerie WhatsApp - Étape « Connecter les API »

Avec ActiveCampaign, vous pouvez utiliser l'étape « Connecter des API » dans les flux de messagerie WhatsApp pour connecter toute application prenant en charge les requêtes API. Cette fonctionnalité vous permet d'étendre vos flux en vous intégrant à des systèmes externes, en automatisant des processus et en récupérant ou en envoyant des données.

Cet article explique l'étape « API » et fournit quelques exemples pour illustrer son potentiel.

Remarque

Cette option est destinée aux utilisateurs avancés. Vous devez être à l'aise avec le code. Notre équipe Expérience client n'est pas en mesure de vous aider à implémenter ou à résoudre des problèmes liés au code.

À propos de l'étape « Connecter les API »

L'étape « Connecter les API » vous permet d'effectuer des requêtes HTTP vers des API externes. Vous pouvez configurer cette étape pour envoyer ou récupérer des données depuis d'autres systèmes, permettant une intégration transparente entre ActiveCampaign et vos outils existants.

L'étape API prend en charge diverses méthodes HTTP, notamment GET, POST, PATCH, PUT et DELETE, et vous permet de personnaliser les en-têtes, les paramètres de requête et les corps de requête.

Configurer l'étape « Connecter les API »

1. Cliquez sur WhatsApp > Flux de messagerie dans le menu de gauche.
2. Modifiez ou créez un nouveau flux de messagerie.
   • Si vous modifiez un flux, cliquez sur un flux > Mettre à jour > Étapes. Cliquez sur un nœud (+) dans le générateur à l'endroit où vous souhaitez placer l'action. Une fenêtre modale s'affiche. Cliquez sur l'option « Connecter les API », puis cliquez sur le bouton « Ajouter »
   • Si vous créez un nouveau flux, une fenêtre modale apparaîtra dans le générateur de flux. Cliquez sur l'option « Connecter les API », puis cliquez sur le bouton « Ajouter »
3. Dans la fenêtre modale « Ajouter une étape » qui s'affiche :
   • Cliquez sur l'icône en forme de crayon et donnez un nom à votre étape. Nous vous recommandons d'utiliser des noms uniques, courts et descriptifs
   • Type de méthode - Sélectionnez la méthode HTTP appropriée en fonction de votre cas d'utilisation
   • URL - Saisissez l'URL de l'endpoint API externe auquel vous souhaitez vous connecter
   • Ajoutez les en-têtes API nécessaires, tels que Body, Headers et Query. Si l'endpoint API nécessite des paramètres de requête, vous pouvez les ajouter ici. Pour les requêtes POST ou PATCH, définissez l'objet JSON, le formulaire ou la chaîne de caractères qui sera envoyé(e) comme corps de la requête.
   • Requête de test - Cliquez sur ce bouton pour tester la connexion API
   • Activer le formatage des caractères d'échappement dans les variables - Si cette option est activée, les caractères spéciaux dans le texte de la variable seront formatés

Exemples

Exemple 1 : Envoi de données vers un CRM

Supposons que vous souhaitiez mettre à jour les informations d'un contact dans votre CRM chaque fois qu'il termine un flux dans ActiveCampaign. Vous pouvez utiliser l'étape « Connect APIs » pour envoyer une requête POST à l'API du CRM avec les informations mises à jour du contact. Pour cela :

1. Définissez l'URL de votre CRM. Par exemple, https://api.yourcrm.com/v1/contacts
2. Choisissez POST pour la méthode HTTP - POST
3. Configurer les en-têtes :

{
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
}

4. Définir le corps de la requête :

{
  "first_name": "{{contact.first_name}}","
  "last_name": "{{contact.last_name}}","
  "email" : "{{contact.email}}","
  "phone" : "{{contact.phone}}"
}

Exemple 2 : Récupération de données depuis un système externe

Imaginez que vous devez récupérer l'historique des commandes d'un client depuis un système externe et le lui présenter dans un flux de messagerie WhatsApp. Vous pouvez utiliser l'étape « Connecter les API » pour effectuer une requête GET vers l'API du système externe, puis utiliser les données récupérées dans les étapes suivantes du flux.

1. Définissez l'URL sur : https://api.yourordersystem.com/v1/orders?user_id={{contact.id}}
2. Choisissez GET comme méthode HTTP
3. Configurer les en-têtes :

{"
  "Authorization": "Bearer YOUR_API_KEY"
}

La réponse de l'API peut ensuite être utilisée dans le flux pour afficher l'historique des commandes du client.

Exemple 3 : Déclenchement d'un workflow externe

Supposons que vous souhaitiez déclencher un workflow externe chaque fois qu'un client complète une étape spécifique dans un flux WhatsApp. Vous pouvez utiliser l'étape « Connect APIs » pour envoyer une requête POST à l'API du système externe, en transmettant toutes les données nécessaires.

1. Définissez l'URL sur : https://api.yourworkflowtool.com/v1/trigger
2. Choisissez POST comme méthode HTTP
3. Configurer les en-têtes :

"Authorization": "Bearer YOUR_API_KEY","
  "Content-Type": "application/json"

4. Définir le corps de la requête :

{"
  "user_id": "{{contact.phone}}","
  "event": "flow_completed",
}