Configurer un webhook avec KeyVue
Tu utilises KeyVue comme CRM ? Tu peux connecter directement ton Agent IA Heyloha à KeyVue via un webhook. Les leads collectés par ton Agent IA sont alors automatiquement créés comme nouveaux leads dans KeyVue, avec le bon statut, la bonne source et la bonne priorité.
Dans cet article, découvre comment créer d'abord un webhook dans KeyVue, puis le connecter dans Heyloha.
Lis d'abord l'article 'Configurer une connexion webhook' si tu n'es pas encore familier avec les webhooks dans Heyloha.
Étape 1 : Créer un webhook dans KeyVue
Dans KeyVue, crée un webhook sous Paramètres > Smart Marketing > Webhooks. Clique sur 'Créer un nouveau webhook' et configure les éléments suivants :
- Nom : un nom facilement identifiable pour un usage interne (par exemple 'Heyloha Chat Leads').
- Type de lead : quel type de lead doit être créé à l'arrivée.
- Statut : le lead doit-il arriver comme 'Nouveau' ou comme 'Opportunité'.
- Source : d'où vient le lead (par exemple 'Chat Site Web' ou 'Agent IA').
- Commentaire : un commentaire par défaut ajouté à chaque lead.
- Priorité : la priorité du lead entrant.
- Probabilité de succès : une estimation du taux de réussite pour ce type de leads.
Clique sur Enregistrer. Tu reviens à l'aperçu des webhooks.
Étape 2 : Copier l'URL du webhook
Dans l'aperçu des webhooks, tu vois le webhook que tu viens de créer. Clique sur 'Copier l'url du webhook'. L'URL est copiée dans ton presse-papiers. Cette URL contient une référence unique au webhook que tu as configuré, y compris toutes les instructions pour KeyVue.
L'URL du webhook ressemble à ceci : https://app.keyvue.nl/webhook?company=votreentreprise&webhook=abc123. Garde cette URL à portée de main, tu en auras besoin dans Heyloha.
Étape 3 : Créer la connexion dans Heyloha
Va dans Agent, puis Intégrations
Dans le menu de gauche, clique sur Agent et ouvre l'onglet Intégrations. Dans la section Webhooks, clique sur Ajouter un webhook.
Choisis KeyVue comme plateforme
Sélectionne KeyVue dans le formulaire. Tu peux aussi limiter le webhook à certains canaux ; si tu laisses vide, il s'applique à tous les canaux.
Colle l'URL du webhook KeyVue
Colle l'URL que tu as copiée à l'étape 2. Heyloha reconnaît automatiquement les paramètres 'company' et 'webhook' et affiche 'Lien reconnu'.
Nomme l'intégration
Choisis un nom clair, par exemple 'KeyVue Lead' ou 'CRM Visite'. Ce nom devient aussi le nom de fonction que ton agent IA utilise.
Sélectionne les champs de contact
Choisis quelles informations ton agent IA doit collecter : prénom, nom, e-mail, téléphone, adresse, code postal, ville ou pays.
Décris le moment d'utilisation
Explique quand ton agent IA doit déclencher cette connexion. Par exemple : 'Envoie les coordonnées à KeyVue lorsqu'un visiteur montre de l'intérêt pour un bien et laisse ses coordonnées.'
Active et enregistre
Mets la connexion sur 'Actif' et clique sur Enregistrer. La connexion est active immédiatement.
Que se passe-t-il quand un lead arrive ?
- Un visiteur démarre une conversation avec ton Agent IA sur ton site web.
- L'Agent IA collecte les coordonnées pendant la conversation.
- Heyloha envoie les informations à KeyVue via le webhook.
- KeyVue crée automatiquement un nouveau lead avec le statut, la source et la priorité configurés.
- Ton équipe voit le lead dans KeyVue et peut assurer le suivi.
Conseils pratiques
- Crée des webhooks séparés dans KeyVue pour différents types de leads, par exemple un pour les demandes de visite et un pour les estimations.
- Configure la source dans KeyVue avec un nom reconnaissable, comme 'Heyloha Chat' ou 'Agent IA Site Web', pour identifier l'origine des leads dans tes rapports.
- Teste la connexion en ayant une conversation avec ton Agent IA et en vérifiant que le lead apparaît correctement dans KeyVue.
Attention : l'URL du webhook doit utiliser HTTPS. Heyloha n'accepte pas les connexions HTTP pour des raisons de sécurité.
Questions fréquentes
Puis-je connecter plusieurs webhooks KeyVue au même Agent IA ?
Oui. Tu peux configurer plusieurs webhooks par marque, chacun avec sa propre URL de webhook KeyVue. Ainsi tu envoies différents types de leads vers différents webhooks dans KeyVue.
Les leads apparaissent-ils immédiatement dans KeyVue ?
Oui. Dès que ton Agent IA a collecté les informations et que le webhook est déclenché, le lead apparaît dans KeyVue presque instantanément.
Que se passe-t-il si je modifie les paramètres du webhook dans KeyVue ?
L'URL du webhook reste la même. Si tu modifies les paramètres dans KeyVue (par exemple le statut ou la source), les futurs leads seront créés avec les nouveaux paramètres. Tu n'as rien à modifier dans Heyloha.
Configurer une connexion webhook