Hub d'integrations
Le Hub d'integrations est l'endroit unique ou l'entreprise connecte les canaux et systemes externes pour qu'ils fonctionnent avec le CRM : messageries, formulaires de site, telephonie, echange de documents, applications maison. Un canal connecte cesse de vivre a part : les messages entrants, les demandes et les appels deviennent des sollicitations avec un responsable, un pipeline et un historique.
Le Hub se trouve dans la section CRM → Integrations (route /crm/integrations). Le concepteur de formulaires s'ouvre a cote, sur /crm/integrations/forms.
Procedure de connexion unifiee
Tous les connecteurs se connectent selon le meme parcours, en termes operationnels :
- Ajouter. Choisissez un type de connecteur dans le catalogue et suivez l'assistant pas a pas. Souvent, vous pouvez selectionner un scenario metier pret a l'emploi pour ne pas tout configurer manuellement.
- Parametrer. Renseignez les champs principaux ; les parametres avances de transport et d'autorisation restent masques tant qu'ils ne sont pas necessaires. Vous pouvez enregistrer le parametrage en brouillon et y revenir plus tard.
- Verifier la connexion. Lancez le test : il indique si la connexion fonctionne, et une raison comprehensible si quelque chose ne va pas.
- Activer. Enregistrez la connexion avec l'interrupteur d'activite. Pour le widget web et les formulaires, cette etape genere le code a inserer sur le site.
- Statut et bon fonctionnement. Chaque carte de connexion a un etat : actif et fonctionnel, avertissement, erreur, brouillon, archive ou desactive. On voit ainsi tout de suite quels canaux demandent de l'attention.
- Flux de travail. Chaque type a son ecran de travail propre : les compteurs de demandes pour les formulaires, le journal des requetes pour l'integration REST, les taches de synchronisation pour l'echange de documents, le bon fonctionnement de l'envoi et la file de reessais pour les messageries.
Qui parametre
Le Hub d'integrations est un parametrage d'administration, pas une action quotidienne d'un collaborateur. La consultation du catalogue est accessible avec le droit de lecture des communications ; creer, modifier, verifier et supprimer des connexions necessite le droit d'ecriture (l'administrateur du portail dispose d'un acces complet). Sans droit d'ecriture, le Hub s'ouvre en lecture seule : les connecteurs sont visibles, mais l'assistant, le test et les interrupteurs sont indisponibles, et une tentative affiche un message d'insuffisance de droits.
Catalogue de connecteurs
Le catalogue regroupe les types de connexions externes pris en charge par votre portail. L'ensemble des types s'etoffe et peut differer d'une installation a l'autre : consultez donc toujours la liste exacte dans le catalogue lui-meme, sur /crm/integrations, et non dans cet article. Les principales familles de connecteurs sont decrites ci-dessous.
Dans certaines versions deployees, une carte de connecteur peut afficher temporairement un nom technique interne au lieu d'un libelle destine a l'utilisateur. Cela ne change ni le type de connecteur ni ses droits, mais cet ecran ne doit pas etre considere comme preuve d'une capture localisee ni publie avant correction de l'interface et revue visuelle.
Le catalogue et le filtre des connexions sont regroupes par direction de travail : echange de documents, chats et messageries, formulaires, telephonie, courrier, acces programmatique (REST) et connexion au portail. Ces groupes facilitent la recherche du bon type lorsque le catalogue en contient beaucoup.
Echange de documents
- Echange de documents (SBIS) — integration avec l'operateur de gestion electronique des documents SBIS : depuis la fiche du document, on prepare les brouillons sortants, on recupere les statuts et les copies signees, et les documents entrants sont rapproches du client. C'est un connecteur regional pour la Russie. En detail sur la page Echange de documents (SBIS).
- Diadoc — un second operateur de gestion electronique des documents pour la Russie. Meme finalite : documents sortants, statuts de signature et rapprochement des entrants avec le client.
Chats et messageries
- Bot Telegram et bot MAX — canaux de dialogue bidirectionnels : les messages entrants de la messagerie sont rattaches aux sollicitations et aux discussions du CRM, et les reponses repartent par le connecteur.
- WhatsApp — canal de dialogue de messagerie suivant la meme logique : le message du client devient une sollicitation avec un responsable et un historique.
- Widget de chat — fenetre de chat integrable pour le site : le visiteur ecrit depuis le site, et la sollicitation apparait dans le flux commun du CRM. L'assistant exige au moins un domaine autorise sans protocole ; il permet aussi de choisir le groupe de travail, l'espace de travail et le pipeline, de configurer le formulaire avant chat et d'obtenir le code d'insertion apres l'enregistrement.
- Webhook de chat — reception des messages d'un systeme de chat externe via webhook, lorsqu'il n'existe pas de connecteur pret pour lui.
Formulaires et demandes
- Formulaire de site — reception unidirectionnelle des demandes d'un formulaire externe via webhook : les demandes deviennent des sollicitations selon le scenario choisi — directement dans le CRM, avec verification prealable ou en local seulement.
- Formulaires de site (module integre) — formulaires propres au portail que vous creez et publiez sans developpeur. Ils n'ont pas de parametrage distinct dans le Hub : le bouton « Ouvrir les formulaires » mene au concepteur de formulaires, et la carte du Hub affiche les compteurs de demandes et d'erreurs CRM. Voir aussi Formulaires.
- Enquetes — la collecte de reponses d'un formulaire d'enquete vers ce meme flux entrant.
Les sondages disposent d’un constructeur dédié pour les demandes entrantes. Dans CRM → Intégrations, créez un sondage, ajoutez des étapes, configurez les choix et champs de contact, puis vérifiez Publication et Réponses. Ajoutez les origines autorisées avant publication. Le portail fournit un lien public et le code d’un widget en fenêtre ou intégré. La publication et son retrait sont des actions distinctes qui peuvent être refusées par la vérification de préparation ou une erreur ; la suppression exige une seconde confirmation. Pas d’archivage dans l’interface. La page publique fonctionne sans connexion et la langue des boutons suit le visiteur. Le champ téléphonique public actuel convertit de force toute saisie au format russe +7, quelle que soit la langue ou le pays du visiteur ; un numéro international peut être modifié. Tant que ce défaut n’est pas corrigé, ne collectez pas de numéros via un sondage et ne considérez pas ce champ comme localisé ou prêt pour une preuve par capture. Utilisez uniquement des questions, origines et réponses synthétiques ; jamais de jetons, vrais contacts ou liens actifs.
Communication et courrier
- Telephonie — une carte pour un fournisseur téléphonique externe et des règles CRM pour les appels entrants. L’assistant actuel ne permet pas de choisir de cible de routage ; tant que ce champ manque, ne considérez pas le fournisseur connecté, le routage entrant ni les CDR comme disponibles.
- Boite mail — connexion de la messagerie professionnelle pour que la correspondance avec le client arrive dans le CRM au lieu de rester dans le client de messagerie personnel d'un seul collaborateur.
Acces programmatique et connexion
- Integration REST externe (cle API) — liaison bidirectionnelle programmatique : un systeme externe cree et met a jour des taches et des affaires via l'API avec une cle d'acces, au nom d'un compte de service dedie aux droits minimaux. En detail sur la page Integration REST externe.
- Authentification unique (OIDC) — la connexion des collaborateurs au portail via le systeme d'authentification de l'entreprise. C'est un parametrage administratif a l'echelle du portail : il change la maniere dont les personnes se connectent, et non le flux des demandes ; convenez-en donc avec l'administrateur avant activation. Consultez Authentification unique (OIDC) pour verifier le connecteur et gerer le secret a usage unique.
A part, on parametre l'AI : connexion de modeles de langage et d'assistants externes — voir AI et scenarios.
Limite actuelle de la téléphonie dans le Hub : la carte du connecteur est disponible, mais l’assistant n’affiche pas de cible de routage, ni file ni utilisateur direct. Le serveur refuse l’enregistrement sans cette cible ; les réglages du pipeline sont une couche distincte. Tant que le champ manque, ne considérez pas le fournisseur comme connecté et ne promettez ni routage entrant, ni file, ni secours, ni CDR. Le scénario reste bloqué par la source et planifié.
Connecteurs en un coup d'oeil
| Connecteur | Direction | Ce qu'il faut pour la connexion | Ou controler apres l'activation |
|---|---|---|---|
| Integration REST | Bidirectionnelle (via API) | Cle API, compte de service aux droits minimaux | Etat de la connexion, erreurs d'echange et evenements entrants |
| Bot Telegram / bot MAX | Bidirectionnelle (dialogue) | Jeton du bot, adresse de reception | Dialogues, erreurs d'envoi et reessais |
| Bidirectionnelle (dialogue) | Acces de l'operateur du canal, adresse de reception | Dialogues, erreurs d'envoi et reessais | |
| Widget de chat | Bidirectionnelle (dialogue) | Au moins un domaine autorise sans protocole et code d'insertion ; formulaire avant chat et routage facultatifs | Sollicitations et conversations creees depuis le site |
| Webhook de chat | Messages entrants | Adresse de reception et acces du systeme de chat externe | Messages recus et erreurs de traitement |
| Formulaire de site | Unidirectionnelle | Adresse de reception, nom de la source, jeton | Demandes recues et erreurs de traitement |
| Concepteur de formulaires | Unidirectionnelle | Assembler le formulaire dans le portail | Demandes recues et disponibilite du formulaire |
| Enquetes | Unidirectionnelle | Formulaire d'enquete et regle de reception des reponses | Reponses recues et erreurs de traitement |
| Telephonie | Catalogue et assistant limité | Fournisseur et pipeline ; pas de cible de routage | Ne prouve ni connexion, ni routage, ni CDR |
| Boite mail | Bidirectionnelle (e-mails) | Acces a la boite mail professionnelle | Correspondance par client et erreurs de reception |
| Echange de documents (SBIS) | Bidirectionnelle (documents) | Identifiant/mot de passe de l'operateur, entite juridique, environnement | Statuts d'echange des documents |
| Diadoc | Bidirectionnelle (documents) | Acces de l'operateur, entite juridique | Statuts d'echange des documents |
| Authentification unique (OIDC) | Connexion au portail | Donnees du systeme d'authentification de l'entreprise | La reussite de la connexion des collaborateurs |
Le tableau decrit les familles principales, et non la liste complete : l'ensemble des types du catalogue de votre portail peut etre plus large.
Bonnes pratiques
- Donnez a la connexion un nom comprehensible et lancez tout de suite le test de connexion, plutot que d'activer « a l'aveugle ».
- Pour chaque canal, attribuez un pipeline, une etape de depart et un responsable, afin qu'une demande ne reste pas sans proprietaire.
- Verifiez regulierement les statuts : un canal en avertissement ou en erreur, ce sont des demandes et des messages perdus.
- Ne montrez pas sur les captures d'ecran et ne transmettez pas les jetons, cles, mots de passe et codes d'insertion avec des valeurs reelles.
Pages liees