Configurer une connexion webhook
Avec une connexion webhook, vous pouvez transmettre automatiquement les coordonnées collectées par votre Agent IA vers un système externe, comme votre CRM, outil marketing ou plateforme interne. Plus besoin de copier quoi que ce soit manuellement : les leads arrivent directement au bon endroit.
Dans cet article, nous vous guidons pas à pas pour configurer une connexion webhook depuis Heyloha.
Qu'est-ce qu'un webhook ?
Un webhook est un moyen d'envoyer automatiquement des données d'un système à un autre. Dès que votre Agent IA a collecté les coordonnées nécessaires, Heyloha envoie ces données via une requête HTTP POST à l'URL que vous avez configurée. Le système récepteur traite ensuite les données, par exemple en créant un nouveau contact dans votre CRM.
De quoi avez-vous besoin ?
- Un compte Heyloha actif avec au moins un Agent IA.
- Un système externe compatible avec les webhooks (par exemple un CRM, une plateforme marketing ou une application personnalisée).
- L'URL du webhook du système récepteur, y compris les éventuels paramètres.
La fonction webhook doit être activée au niveau de l'entreprise. Si vous ne voyez pas l'option 'Connexions' dans le menu de votre Agent IA, contactez votre administrateur.
Configurer une connexion webhook
Accédez à votre Agent IA
Ouvrez le tableau de bord Heyloha et cliquez sur l'Agent IA pour lequel vous souhaitez configurer la connexion.
Ouvrez le menu 'Connexions'
Dans le menu latéral de votre Agent IA, vous trouverez l'option 'Connexions'. Cliquez dessus pour ouvrir l'aperçu.
Cliquez sur 'Ajouter une intégration'
Vous accédez maintenant à un formulaire pas à pas pour créer une nouvelle connexion webhook.
Collez l'URL du webhook
Copiez l'URL complète du webhook depuis le système récepteur et collez-la dans le champ. L'URL contient souvent des paramètres comme 'company' et 'webhook'. Heyloha reconnaît automatiquement l'URL et ses paramètres.
Nommez l'intégration
Choisissez un nom facilement identifiable, par exemple 'Transfert lead CRM' ou 'Demande de devis'. Ce nom est également utilisé comme nom de fonction interne pour votre Agent IA.
Sélectionnez les champs de contact
Choisissez quelles informations votre Agent IA doit collecter et transmettre. Vous pouvez choisir parmi : prénom, nom, adresse e-mail, numéro de téléphone, adresse, code postal, ville et pays.
Décrivez quand la connexion doit être utilisée
Fournissez une courte description indiquant quand votre Agent IA doit déclencher cette connexion, par exemple : 'Utilisez cette connexion lorsqu'un visiteur montre de l'intérêt pour une visite et laisse ses coordonnées.'
Enregistrez et activez
Mettez la connexion sur 'Actif' et cliquez sur Enregistrer. N'oubliez pas de sauvegarder également l'Agent IA pour que les modifications prennent effet.
Les modifications des connexions ne prennent effet qu'après avoir sauvegardé l'Agent IA. N'oubliez pas cette étape !
Quelles coordonnées pouvez-vous transmettre ?
Vous décidez quels champs votre Agent IA collecte et transmet via le webhook. Les champs disponibles sont :
- Prénom
- Nom
- Adresse e-mail
- Numéro de téléphone
- Adresse
- Code postal
- Ville
- Pays
Sélectionnez au moins un champ. L'Agent IA demande ces informations de manière naturelle pendant la conversation et les transmet automatiquement une fois l'objectif atteint.
Comment ça fonctionne en pratique ?
Lorsqu'un visiteur discute avec votre Agent IA et fournit les informations requises, Heyloha envoie automatiquement une requête à l'URL du webhook configurée. Le système récepteur traite les coordonnées, pour que votre équipe puisse assurer le suivi immédiatement.
- Un visiteur du site web démarre une conversation avec votre Agent IA.
- L'Agent IA reconnaît l'objectif (par exemple : transmettre un lead) et demande les informations nécessaires.
- Après avoir collecté les informations, Heyloha les envoie au système externe via le webhook.
- Le système récepteur traite les informations (par exemple : créer un nouveau contact).
- Votre équipe reçoit une notification et peut assurer le suivi du lead.
Gérer les connexions
Dans l'aperçu 'Connexions', vous voyez toutes vos connexions webhook actives et inactives. Vous pouvez :
- Modifier une connexion (changer l'URL, le nom, les champs ou la description).
- Activer ou désactiver une connexion via le commutateur de statut.
- Supprimer une connexion si vous n'en avez plus besoin.
Vous pouvez configurer plusieurs connexions webhook par Agent IA, chacune avec son propre objectif et ensemble de champs de contact. Par exemple, vous pouvez configurer une connexion pour les visites et une autre pour les demandes de devis.
Exemples de connexions webhook
- Système CRM : Transmettre automatiquement les leads à votre système de gestion client.
- Outil d'email marketing : Ajouter de nouveaux contacts à une liste de diffusion.
- Plateforme interne : Transmettre les demandes de visite ou de devis à la bonne équipe.
- Helpdesk : Créer des tickets de support basés sur les conversations avec votre Agent IA.
Questions fréquentes
Puis-je tester le webhook ?
Oui. Sauvegardez la connexion et sauvegardez votre Agent IA. Lancez ensuite une conversation test avec votre Agent IA et fournissez les informations requises. Vérifiez dans le système récepteur si les informations ont été correctement reçues.
Que faire si le webhook ne fonctionne pas ?
Vérifiez que l'URL du webhook est correcte, que la connexion est sur 'Actif' et que vous avez sauvegardé l'Agent IA après avoir créé la connexion. Vérifiez également dans le système récepteur si le webhook est actif de leur côté.
Quels systèmes sont pris en charge ?
La connexion webhook fonctionne avec tout système capable de recevoir une requête HTTP POST avec des données de formulaire. Cela inclut les systèmes CRM, les outils marketing, les applications internes et plus encore.
Combien de connexions puis-je configurer ?
Il n'y a pas de limite. Vous pouvez configurer plusieurs connexions par Agent IA, chacune avec son propre objectif et ses propres champs de contact.
Configurer les objectifs pour votre Agent IAConfigurer un webhook avec KeyVue