Connecter votre système téléphonique (GoHighLevel, Rinkel et Voys)

Ceci est une tâche pour l'administrateur. Ces écrans ne sont visibles que pour le propriétaire de l'équipe.

Connectez votre système téléphonique pour que vos appels arrivent automatiquement dans Converdo et soient scorés. Dans les paramètres, allez à CRM & Téléphonie. Cela ouvre la page Connecteurs (« Connectez les systèmes qui amènent les données de conversation dans Converdo pour le scoring. »). Trois connexions sont utilisables aujourd'hui : GoHighLevel, Rinkel et Voys.

GoHighLevel

GoHighLevel pousse chaque appel vers Converdo, qui récupère ensuite l'enregistrement et le score. Il vous faut deux choses :

1. L'URL de webhook. Copiez sur la carte GoHighLevel l'URL de webhook et collez-la dans le webhook ou l'automation dans GHL. Dans l'app : « Collez cette URL dans le webhook/l'automatisation du système. Gardez-la secrète : elle identifie votre espace de travail. »
2. Un jeton Private Integration. Dans l'app : « Créez dans GoHighLevel une Private Integration (Settings → Private Integrations) avec ces scopes : View Conversations (conversations.readonly), View Conversation Messages (conversations/message.readonly), View Contacts (contacts.readonly). Collez le jeton ci-dessous (commence généralement par pit-). Stocké chiffré (Vault) ; jamais réaffiché. »

Rinkel

Rinkel pousse chaque appel vers Converdo, qui récupère l'enregistrement via l'API Rinkel et le score. Il vous faut l'abonnement Rinkel Expert : les webhooks et les enregistrements ne sont pas inclus dans les formules inférieures.

Renseignez sur la carte Rinkel votre clé API : « Générez une clé API dans My Rinkel (l'API Rinkel est en bêta, disponible sur Professional et Expert ; demandez l'accès via rinkel.com/integrations si nécessaire). Converdo utilise la clé uniquement pour récupérer vos enregistrements. Stockée chiffrée (Vault) ; jamais réaffichée. » Cliquez ensuite sur Tester la connexion ; en cas de succès vous voyez « Connexion réussie : la clé API fonctionne. » Si vous voyez une erreur, vérifiez que vous avez copié la clé entièrement, sans espaces avant ou après.

Suivez ensuite les quatre étapes telles qu'elles figurent sur la carte :

1. « Générez dans Rinkel sous Intégrations → API une clé API et collez-la ci-dessous. Converdo teste la connexion directement à l'enregistrement. »
2. « Enregistrez sous Intégrations → Webhooks l'URL de webhook ci-dessus, avec le content-type application/json. Utilisez le bouton Test de Rinkel et cliquez sur Save. »
3. « Activez les quatre événements d'appel. Converdo les traite tous les quatre : Appel entrant et Appel sortant (direction et numéro), Début d'appel (associe le collaborateur) et Fin d'appel (démarre le traitement et la récupération de l'enregistrement). Les autres événements, comme les call insights, peuvent rester désactivés ; Converdo les ignore. »
4. « Activez l'enregistrement des appels pour les numéros que vous voulez scorer : sans enregistrement, il n'y a rien à récupérer. Les webhooks et enregistrements nécessitent l'abonnement Rinkel Expert. »

Vérifier que ça fonctionne

Passez un appel de test et raccrochez. En quelques minutes, l'appel doit figurer dans votre aperçu Conversations. Sur la carte du connecteur, vous voyez aussi quand le dernier appel est arrivé ; c'est le moyen le plus rapide de vérifier que la connexion vit encore. Si rien n'arrive, consultez Si ça ne fonctionne pas (Rinkel) ci-dessous.

Remplacer la clé ou renouveler le jeton

Sur la carte Rinkel figurent deux boutons au but différent :

• Remplacer définit une nouvelle clé API, par exemple après l'avoir régénérée dans Rinkel. L'URL de webhook reste identique.
• Renouveler le jeton crée une nouvelle URL de webhook. Faites-le si vous soupçonnez que l'ancienne URL est tombée entre de mauvaises mains. N'oubliez pas d'enregistrer ensuite la nouvelle URL dans Rinkel, sinon plus aucun appel n'arrivera.

Si ça ne fonctionne pas (Rinkel)

Aucun appel n'arrive. Vérifiez dans Rinkel que le webhook est toujours enregistré et que les quatre événements sont activés. Retestez le webhook depuis Rinkel.

Les appels arrivent, mais sans enregistrement. L'enregistrement des appels n'est pas activé dans Rinkel pour ce numéro, ou la clé API n'est plus valide. Vérifiez la clé avec le bouton de test dans Converdo.

Les appels arrivent chez le mauvais collaborateur ou chez personne. Converdo associe par numéro de téléphone. Vérifiez sous Paramètres → Collaborateurs que le numéro de ce collaborateur est correct et complet.

GoHighLevel et Rinkel partagent le même jeton de webhook. Si vous renouvelez le jeton, les deux URL cessent de fonctionner jusqu'à ce que vous colliez la nouvelle URL aux deux endroits.

Voys

Voys envoie chaque appel à Converdo via un webhook ; Converdo récupère ensuite l'enregistrement via l'API Voys et le score. La connexion a deux volets : des réglages dans le portail Voys (que Converdo ne peut ni voir ni vérifier) et deux valeurs à recopier sur la carte Voys de la page Connecteurs.

D'abord : dans le portail Voys

Cinq réglages, dans cet ordre. Converdo ne peut pas détecter s'ils sont en place ; s'il en manque un, les appels ou l'audio cessent d'arriver, sans message. La carte Voys affiche les mêmes points sous forme de checklist, avec les pièges — gardez-la sous les yeux.

1. Créez un jeton API sous Paramètres personnels → Jetons utilisateur, avec un compte administrateur disposant des droits d'enregistrement. C'est l'étape qui échoue le plus souvent : un jeton d'utilisateur ordinaire semble fonctionner — les appels arrivent, la connexion se déclare active — mais ne livre aucun enregistrement, et l'erreur renvoyée par Voys est alors impossible à distinguer de « l'enregistrement n'est pas encore prêt ». Vérifiez donc les droits avant de continuer.
2. Activez l'enregistrement des appels globalement.
3. Ajoutez une étape d'enregistrement au plan d'appel, réglée sur « démarrer au décroché ».
4. Activez l'enregistrement des appels sortants, par compte VoIP. Il est désactivé par défaut et rien ne le signale.
5. Configurez le webhook sous Intégration → Notifications d'appel, avec l'URL de webhook affichée en haut de la carte Voys. Attention au nom : c'est le module gratuit Notifications d'appel. Le produit payant appelé « Webhooks » est autre chose (une étape du plan d'appel) et ne fonctionne pas ici.

Ensuite : recopier deux valeurs sur la carte

• UUID client, depuis Paramètres personnels → Jetons utilisateur. Ce n'est pas un mot de passe — il identifie seulement quel environnement Voys appartient à ce compte.
• ID client numérique, dans la barre d'adresse du portail Voys : /client/<numéro>/…, généralement six chiffres. Ce n'est pas votre numéro de registre du commerce ni l'UUID client ci-dessus. Converdo l'utilise pour récupérer la liste des comptes VoIP.

L'ordre sur la carte est imposé : le jeton API crée la connexion, l'UUID client ne peut donc être enregistré qu'ensuite. Si vous saisissez l'UUID en premier, la carte vous demande d'enregistrer d'abord le jeton.

Tester et relier les collaborateurs

Cliquez sur Tester la connexion sur la carte. Le test indique si le jeton et l'environnement correspondent et si des comptes VoIP ont été trouvés ; un problème de droits ou un ID client erroné y reçoit son propre message.

Choisissez ensuite le numéro de poste de chaque collaborateur sous Paramètres → Collaborateurs. Reprenez le numéro du compte VoIP (généralement la série 2xx : les postes), pas le numéro d'utilisateur (généralement 6xx). Si vous choisissez le mauvais, aucune erreur n'apparaît — les appels sont alors reliés en silence au mauvais collaborateur, ou à personne.

À quoi s'attendre ensuite

Un appel n'apparaît dans votre aperçu Conversations qu'après sa fin, pas pendant : Voys signale l'appel une fois terminé, puis Converdo récupère l'enregistrement et le score.

En cas de problème (Voys)

• Les appels arrivent, mais sans enregistrement. Presque toujours les droits du détenteur du jeton (étape 1) ou l'un des réglages d'enregistrement des étapes 2-4. Au besoin, créez un nouveau jeton sous un administrateur avec droits d'enregistrement et remplacez-le sur la carte.
• Rien n'arrive. Vérifiez le webhook sous Intégration → Notifications d'appel, y compris la dernière partie de l'URL — c'est votre jeton personnel, différent pour chaque client.
• L'UUID client n'est pas accepté. Il faut l'UUID complet (quatre tirets), sans espaces avant ni après.
• La liste des collaborateurs Voys reste vide. Vérifiez l'ID client numérique sur la carte ; les enregistrements eux-mêmes n'ont pas besoin de cet ID.

Routage vers une équipe (facultatif)

Sous Équipe par défaut, vous configurez un filet de sécurité : « les conversations de ce connecteur dont le collaborateur ne détermine pas d'équipe arrivent dans cette équipe. Laissé vide, elles vont au triage. »

Après la connexion

Dès qu'une conversation arrive, Converdo récupère l'enregistrement, le transcrit et le score. Veillez à ce que chaque collaborateur soit rattaché à l'équipe comme membre avec un rôle de fonction : sans cette association, une conversation reste sur En attente d'attribution (l'écran À traiter). Voir Comment Converdo score vos conversations.