Préparer une intégration CRM

Le CRM est l’application de gestion de la relation client. Sélectionnez le client et ouvrez CRM. Préparez les accès de votre fournisseur. La page distingue les connecteurs natifs et la Connexion personnalisée, qui utilise un relais. Les droits de lecture, d’écriture et de consultation du journal sont indépendants.

Recherchez une intégration et filtrez celles à reconnecter, en erreur, incomplètes ou connectées. Ajouter ouvre la configuration native. Cliquez sur une ligne pour ouvrir sa configuration. Une intégration activée n’est pas nécessairement testée avec succès : l’écran présente séparément ces informations.

Préparer une intégration CRM, en mode clair avec données fictives ; masquer les identifiants personnels, secrets et adresses privées.

Configurer un connecteur natif

  1. Choisissez Type de CRM parmi les fournisseurs disponibles du catalogue.
  2. Lisez les capacités annoncées pour ce fournisseur et ouvrez Guide de connexion ou Ouvrir la console si nécessaire.
  3. Remplissez les champs proposés pour ce fournisseur.
  4. Cliquez sur Enregistrer.
  5. Une fois la configuration enregistrée, cliquez sur Tester et lisez le compte reconnu, la date et le résultat.
Champ À quoi ça sert Valeurs possibles Exemple
Type de CRM Déterminer les champs et capacités Fournisseurs disponibles dans le catalogue serveur Fournisseur de votre entreprise
Hôte, domaine ou portail Désigner votre instance Format et longueur indiqués par le fournisseur ; un hôte n’est pas une URL complète crm.exemple.test
Région Choisir la région Zoho us, eu, au, in, cn, jp ou ca eu
Base de données, société, organisation Identifier le compte quand le fournisseur le demande Champs propres au connecteur Identifiant fourni par votre administrateur CRM
Identifiant client, clé publique ou utilisateur Identifier l’application Valeur fournie par le CRM Identifiant de l’application créée pour le PBX
Secret client, clé API, clé privée ou jeton Authentifier la connexion Secret ; champ vide conserve un secret déjà enregistré lorsque l’identité ne change pas Secret du gestionnaire de mots de passe
Modèle d’URL de contact Ouvrir une fiche depuis l’interface Modèle autorisé avec l’identifiant du contact Modèle préparé par l’intégrateur
Activée / Désactivée Mettre l’intégration en service Interrupteur Désactivée pendant la préparation

Les champs obligatoires et leurs limites dépendent du catalogue chargé. Un fournisseur indisponible ne peut pas être choisi. Changer de fournisseur réinitialise les champs et désactive le nouveau brouillon. Si l’identité du connecteur change, certains secrets doivent être saisis de nouveau.

Effacer ce secret à l’enregistrement prépare explicitement l’effacement du secret concerné et désactive sa saisie. Laisser simplement un champ vide n’a pas le même effet. Le modèle de lien de contact sert à la navigation ; il ne constitue pas une requête du PBX vers le CRM.

Configurer un connecteur natif, en mode clair avec données fictives ; masquer les identifiants personnels, secrets et adresses privées.

Autoriser OAuth

Pour Salesforce, Dynamics 365 et Zoho, le parcours peut utiliser OAuth, une autorisation accordée chez le fournisseur.

  1. Copiez URL de rappel à enregistrer chez le fournisseur avec Copier l’URL de rappel.
  2. Enregistrez cette adresse dans l’application du fournisseur, en suivant le guide de connexion affiché.
  3. Enregistrez la configuration du PBX avant Connecter avec OAuth.
  4. Effectuez l’autorisation chez le fournisseur, puis revenez sur le même client et la même session.
  5. Testez la configuration enregistrée.

Rafraîchir la connexion renouvelle l’autorisation lorsque ce mode est actif. Déconnecter OAuth retire la connexion ; pour Microsoft, l’écran précise les limites de révocation distante. Ces commandes sont indisponibles pendant une opération ou tant que le brouillon diffère de l’enregistrement. Une URL de rappel absente doit être corrigée avant de lancer l’autorisation.

Autoriser OAuth, en mode clair avec données fictives ; masquer les identifiants personnels, secrets et adresses privées.

Utiliser un relais personnalisé

Champ À quoi ça sert Valeurs possibles Exemple
Étiquette (sans effet sur l’envoi) Identifier le relais Étiquette proposée Connexion personnalisée
URL du serveur Joindre le relais ; nécessaire pour activer URL acceptée par le formulaire https://relais.exemple.test/api
Clé API Authentifier le relais Vide conserve la clé enregistrée Secret du relais
Numéro connu dans le relais (test en lecture seule) Vérifier une recherche De 3 à 32 caractères dans le champ Numéro de test connu

Enregistrez avant Tester. Le test du relais recherche le numéro et distingue un contact inconnu d’un échec de connexion. Le connecteur natif et le relais ne doivent pas être activés simultanément : l’écran signale ce conflit. Choisir une étiquette de fournisseur dans le relais ne transforme pas celui-ci en connecteur natif.

Utiliser un relais personnalisé, en mode clair avec données fictives ; masquer les identifiants personnels, secrets et adresses privées.

Journal, retrait et dépannage

Le journal présente les envois CRM, leur fournisseur, leur date, leur durée et le résultat disponible. Il ne représente pas tous les appels. Une reprise en attente n’est pas une preuve d’échec définitif ni de livraison finale. Parcourez le journal par pages de cinquante lignes.

Retirer ouvre la confirmation du connecteur natif. Confirmez pour retirer sa configuration, ou Annuler pour la conserver. Après une erreur de lecture, Recharger la configuration relit le catalogue et les valeurs. Un coffre de secrets indisponible exige l’intervention de l’administrateur de l’installation. Après un refus fournisseur, corrigez les identifiants ou l’autorisation indiqués, enregistrez et retestez ; un simple enregistrement ne valide pas la connexion.

Journal, retrait et dépannage, en mode clair avec données fictives ; masquer les identifiants personnels, secrets et adresses privées.