Connecteurs de données

Un connecteur de données est un appel à votre propre système — par exemple « trouver une commande » dans votre boutique. Vous le configurez une fois ; Are AI, les parcours et les automatisations peuvent ensuite l’utiliser.

Créer un connecteur

Allez dans Paramètres → Connecteurs de données → Nouveau connecteur.

1. Nom et Quand l’utiliser — Are AI lit ceci pour décider quand l’appeler, par ex. « Quand le client demande où en est sa commande. »
2. Requête — méthode et URL, par exemple https://shop.example.com/api/orders/{{input.order_id}}.
3. En-têtes — par exemple Authorization: Bearer …. Les valeurs sont stockées chiffrées et ne sont plus jamais affichées.
4. Entrées — ce dont l’appel a besoin, comme order_id. Donnez à chacune une courte description.
5. Champs à utiliser dans la réponse — lancez un test et cliquez sur les champs dont vous avez besoin, comme order.status. Seuls ces champs sont transmis.

Vous pouvez utiliser {{input.key}}, {{contact.email}}, {{contact.user_id}}, {{contact.name}} et {{contact.attributes.key}} dans l’URL, les en-têtes et le corps.

Protéger les données personnelles

• Uniquement pour les utilisateurs identifiés (activé par défaut) : les visiteurs anonymes ne peuvent pas déclencher le connecteur. Utilisez la vérification d’identité sur votre site.
• Les appels ne vont que vers des adresses Internet publiques, ne suivent jamais les redirections et expirent au bout de 8 secondes.
• Les réponses ne sont pas stockées ; seul le fait que l’appel a réussi ou non est conservé.

Avec Are AI

Activez Are AI peut l’utiliser. Lorsqu’une question nécessite des données en direct, Are AI appelle le connecteur, demande au client les entrées manquantes (comme le numéro de commande) et répond à partir du résultat. Elle peut appeler jusqu’à trois connecteurs à la suite — par exemple rechercher une commande, puis la modifier.

Les connecteurs qui modifient quelque chose (annuler une commande, changer une adresse) nécessitent l’accord du client. Are AI indique d’abord exactement ce qu’elle va faire et demande au client de confirmer ; l’appel n’est exécuté qu’après son accord, et uniquement avec exactement les mêmes entrées. C’est activé par défaut pour toutes les méthodes sauf GET — modifiez-le avec Demander au client avant de l’exécuter.

Si votre système répond « introuvable » (par exemple HTTP 404), Are AI le dit au client et lui demande de vérifier ce qu’il a saisi. La conversation n’est transmise à votre équipe que si votre système est injoignable.

Dans les parcours

Ajoutez l’étape Appeler un connecteur de données. Remplissez les entrées à partir du contact ou de réponses précédentes ({{answer.<step>}}), enregistrez des champs sur le contact et choisissez où aller en cas de succès ou d’échec. Les messages suivants peuvent afficher un champ avec {{result.status}}.

Dans les automatisations

Utilisez l’action Appeler un connecteur de données. Les entrées viennent du contact (e-mail, ID utilisateur ou un attribut du même nom) ; les champs choisis sont enregistrés sur le contact.