Ce qui est migré et où

L'outil de migration importe les clients, les transactions et l'historique des activités depuis Bitrix24 ou amoCRM vers Mavibot CRM.

Pour y accéder, allez dans CRM → Paramètres du pipeline (icône d'engrenage) → "Migration CRM" → "Ouvrir".

Si votre projet n'a pas encore de pipelines, vous verrez un lien "Migrez vos données" sur l'écran CRM vide.

Données Bitrix24 amoCRM Destination dans Mavibot
Clients Contacts Contacts Clients CRM
Entreprises Y compris les détails de l'entreprise et les informations bancaires Y compris les détails du champ "Entité légale" Entreprises clientes
Transactions Tous les pipelines Tous les pipelines Transactions dans les pipelines sélectionnés
Transactions closes Optionnel Optionnel Statuts "Gagnée" et "Perdue"
Prospects Optionnel, importés dans un pipeline séparé amoCRM n'a pas de prospects séparés Pipeline "Prospects (Bitrix24)"
Tâches Activités et tâches Tâches Tâches CRM
Commentaires Commentaires du fil Notes et SMS Notes dans les conversations clients
Appels Y compris les liens d'enregistrement Y compris les liens d'enregistrement Enregistrements d'appels dans les conversations clients
Conversations Canaux ouverts, incluant optionnellement les fichiers Non disponible : amoCRM ne fournit pas de conversations via son API Conversations clients
Champs personnalisés Champs de contact, de transaction et de prospect Champs de contact et de transaction Variables de client et de transaction
Employés assignés Via le mappage des employés Via le mappage des employés Membres de l'équipe du projet
Tags Type de contact et source Tags Tags clients

Avant de commencer

Seuls les employés ayant la permission de modifier les données CRM dans Mavibot peuvent démarrer une migration.

Dans votre CRM précédent, les identifiants d'accès doivent être créés par un administrateur. L'outil de migration ne peut accéder qu'aux données que la personne ayant créé les identifiants est autorisée à voir.

  • Votre CRM précédent reste inchangé. L'outil de migration ne fait que lire les données. Vous pouvez continuer à travailler dans Bitrix24 ou amoCRM comme d'habitude.
  • Pas de clients en double. Si un client avec le même numéro de téléphone ou la même adresse e-mail existe déjà dans Mavibot (par exemple, quelqu'un qui vous a contacté via WhatsApp), son profil existant sera mis à jour. Seuls les champs vides sont remplis ; les valeurs existantes restent inchangées.
  • Aucun message n'est envoyé aux clients. Les automatisations CRM, les bots et les campagnes ne sont pas déclenchés pendant la migration. Les clients importés ne sont pas déplacés en haut de la liste des conversations.
  • Vous pouvez relancer la migration en toute sécurité. Les enregistrements précédemment importés sont mis à jour ou ignorés, et seules les nouvelles données sont ajoutées.

Avant de commencer, vous devez cocher la case confirmant :

"Les données appartiennent à notre entreprise, et nous autorisons Mavibot à les migrer."

La migration ne peut pas démarrer sans cette confirmation.

Migration depuis Bitrix24

Pour connecter Bitrix24, vous avez besoin d'un webhook entrant. Sa création prend environ deux minutes.

Créez le webhook avec un compte administrateur Bitrix24 afin que la migration puisse accéder à toutes les transactions et conversations.

  1. Dans Bitrix24, allez dans Développeurs → Autre → Webhook entrant.
  2. Sélectionnez les permissions listées dans le tableau ci-dessous. Seul CRM est strictement requis, mais sans les autres permissions, certaines données ne seront pas importées.
  3. Cliquez sur Enregistrer et copiez l'URL du champ "Webhook pour appeler l'API REST". Elle ressemble à ceci : https://votre-portail.bitrix24.ru/rest/1/xxxxxxxxxxxx/.
  4. Dans Mavibot, ouvrez Migration CRM, sélectionnez l'onglet Bitrix24, et collez l'URL dans le champ "URL du webhook entrant".
  5. Confirmez que vous possédez les données et cliquez sur "Vérifier l'accès et découvrir les données". Suivez ensuite les étapes de l'assistant de migration décrites ci-dessous.
Permission du webhook Ce qu'elle fournit Sans elle
CRM Clients, entreprises, transactions, prospects, activités, commentaires La migration ne peut pas démarrer
Utilisateurs (de base) Liste des employés pour le mappage Les transactions n'auront pas d'employés assignés
Canaux ouverts Conversations clients Les conversations ne seront pas importées
Tâches Tâches du module Tâches Seules les activités CRM seront importées
Téléphonie Durée des appels et liens d'enregistrement Les appels n'auront ni durée ni liens d'enregistrement
Drive Fichiers des conversations Certains fichiers resteront comme liens dans les messages

Si une permission manque, l'assistant affichera un avertissement lors de l'étape "Données trouvées".

Ajoutez la permission requise dans les paramètres de votre webhook Bitrix24 et cliquez sur "Découvrir à nouveau".

Bitrix24 ne permet pas plus de deux requêtes par seconde, donc la collecte de données depuis un grand portail peut prendre plus de temps.

Vous pouvez fermer la page pendant que la migration s'exécute en arrière-plan.

Erreurs de connexion

Message d'erreur Que faire
"Ce n'est pas une URL de webhook" Vous avez saisi une adresse de portail ou un e-mail. Copiez l'URL du champ "Webhook pour appeler l'API REST"
"L'URL du webhook doit commencer par https://" Copiez l'URL complète, y compris https://
"Bitrix24 a rejeté le webhook" Le webhook a été supprimé ou l'URL a été copiée incorrectement. Créez un nouveau webhook
"Le webhook n'a pas la permission CRM" Activez la permission CRM dans les paramètres du webhook
"Bitrix24 ne répond pas" Vérifiez l'adresse du portail dans l'URL du webhook et réessayez
"Bitrix24 n'a pas levé la limite de débit" Le portail peut être occupé par d'autres intégrations. Réessayez plus tard

Si la section Développeurs manque dans votre menu Bitrix24 ou si vous ne pouvez pas enregistrer un webhook, vérifiez votre plan d'abonnement Bitrix24.

Les webhooks peuvent ne pas être disponibles sur le plan Bitrix24 gratuit.

Migration depuis amoCRM

Pour connecter amoCRM, vous avez besoin de l'adresse de votre compte et d'un jeton à long terme provenant d'une intégration externe.

Seul un administrateur de compte peut générer le jeton.

Lors de la création de l'intégration, amoCRM envoie un code de vérification à l'adresse e-mail de l'administrateur, alors assurez-vous d'avoir accès à cette boîte de réception.

  1. Dans amoCRM, ouvrez amoMarket → ⋯ (coin supérieur droit) → Créer une intégration → Intégration externe → Créer.
  2. Remplissez le formulaire :
    • URL de redirection — toute adresse HTTPS, comme votre site web. Elle n'est pas utilisée pour le jeton.
    • Accorder l'accès — sélectionnez "Accès aux données du compte". Aucune autre permission n'est requise.
    • Nom et description — par exemple, "Migration vers Mavibot".
    • Logo — toute image 400×272. Sans logo, amoCRM peut ne pas enregistrer l'intégration.
  3. Cliquez sur Enregistrer. amoCRM vous demandera de confirmer l'intégration. Cliquez sur Envoyer le code, saisissez le code à six chiffres de l'e-mail, puis cliquez sur Confirmer.
  4. Ouvrez l'intégration créée et allez dans Clés et accès → Générer un jeton à long terme. Sélectionnez une période d'expiration. Un mois est généralement suffisant pour la migration.
  5. Copiez le jeton immédiatement. amoCRM ne l'affiche qu'une seule fois.
  6. Dans Mavibot, ouvrez Migration CRM et sélectionnez l'onglet amoCRM. Saisissez company.amocrm.ru ou simplement company dans le champ "Adresse du compte". L'adresse company.amocrm.com est également prise en charge. Collez votre jeton dans le champ "Jeton à long terme".
  7. Confirmez que vous possédez les données et cliquez sur "Vérifier l'accès et découvrir les données". Suivez ensuite les étapes de l'assistant décrites ci-dessous.

L'adresse du compte et le jeton sont stockés sous forme cryptée et supprimés lorsque l'enregistrement de migration est supprimé.

amoCRM ne fournit pas d'accès aux conversations via son API. L'assistant de migration affiche un avertissement à ce sujet avant le début de la migration.

Erreurs de connexion

Message d'erreur Que faire
Code de vérification non reçu Le code est envoyé à l'e-mail associé à votre compte amoCRM. Vérifiez votre dossier Spam ou créez l'intégration avec un autre compte administrateur
"L'adresse du compte doit être un domaine tel que company.amocrm.ru, pas une adresse e-mail" Saisissez le domaine affiché dans la barre d'adresse de votre navigateur lorsque amoCRM est ouvert
"amoCRM a rejeté le jeton" Le jeton a été copié incorrectement, a expiré ou a été révoqué. Générez-en un nouveau
"L'abonnement amoCRM a expiré" Les données peuvent encore être accessibles pendant 30 jours après l'expiration. Renouvelez votre abonnement ou contactez amoCRM
"amoCRM a bloqué l'accès" L'intégration peut manquer de la permission "Accès aux données du compte", ou le compte peut être temporairement bloqué en raison de requêtes excessives. Vérifiez l'accès et réessayez plus tard
"amoCRM ne répond pas" ou "amoCRM n'a pas pu trouver…" Vérifiez l'adresse du compte et réessayez

Étapes de l'assistant de migration

Après avoir connecté votre CRM, le processus de migration est le même pour Bitrix24 et amoCRM.

Aucune donnée n'est écrite dans Mavibot avant d'atteindre l'étape "Migrer".

1. Collecte des données

L'assistant récupère les données de votre CRM précédent et affiche la section en cours de traitement.

Vous pouvez fermer la page pendant que la collecte des données continue en arrière-plan.

2. "Données trouvées"

L'assistant affiche le nombre de pipelines, transactions, contacts, entreprises, tâches, appels et employés trouvés.

La section "Éléments à examiner" montre quelles données ne peuvent pas être migrées et pourquoi, comme les permissions de webhook manquantes.

3. Mappage

Configurez comment les données de votre CRM précédent doivent être mappées vers Mavibot.

Pipelines et étapes

Pour chaque pipeline source, sélectionnez un pipeline Mavibot existant ou choisissez "Créer un nouveau pipeline".

Les étapes avec des noms correspondants sont mappées automatiquement. Les étapes manquantes sont créées dans le même ordre que dans votre CRM précédent.

Employés

Les employés avec des adresses e-mail correspondantes sont mappés automatiquement et marqués "Correspondance par e-mail".

Pour tous les autres, sélectionnez l'employé approprié ou laissez "Non assigné".

Champs vers variables

Sélectionnez les champs personnalisés que vous souhaitez migrer et examinez leurs clés de variable.

Vous pouvez immédiatement utiliser ces clés de variable dans les bots et les campagnes.

Quoi migrer

Configurez les options suivantes :

  • Inclure les transactions closes.
  • Importer uniquement les données créées après une date spécifiée.
  • Pour Bitrix24, inclure optionnellement les prospects non convertis, les conversations des canaux ouverts et les fichiers de conversation.

Lorsqu'un filtre de date est sélectionné, tous les clients et entreprises sont importés, tandis que les transactions, tâches, commentaires, appels et conversations sont importés uniquement à partir de la date spécifiée.

Cliquez sur "Enregistrer le mappage" lorsque vous avez terminé.

4. "Examen"

L'assistant calcule ce qui se passera pendant la migration sans écrire aucune donnée.

Pour chaque catégorie de données, il affiche :

  • Sera créé — les enregistrements qui seront ajoutés.
  • Existe déjà — les enregistrements déjà trouvés dans Mavibot.
  • Ignoré — les enregistrements qui ne peuvent pas être importés.

Pour les clients, "Existe déjà" signifie qu'un numéro de téléphone ou une adresse e-mail correspondant a été trouvé dans Mavibot.

Vous pouvez ajuster le mappage et relancer l'examen.

5. "Migrer"

La migration s'exécute en arrière-plan, vous pouvez donc fermer la page.

Le bouton Arrêter interrompt le processus.

Les enregistrements déjà importés restent dans Mavibot, et relancer la migration continue sans créer de doublons.

6. Résultats de la migration

L'écran final affiche un tableau avec :

  • Créé
  • Existe déjà
  • Ignoré

Il comprend également une liste des enregistrements ignorés avec des explications.

Pour télécharger le rapport complet, cliquez sur "Télécharger le rapport CSV".

Pour voir les enregistrements importés, cliquez sur "Ouvrir le CRM".

Importer de nouvelles données plus tard

Si votre équipe continue de travailler dans le CRM précédent, vous pouvez utiliser "Migrer de nouvelles données" pour importer les modifications récentes.

Les nouveaux enregistrements seront ajoutés, tandis que les transactions précédemment importées verront leurs étapes, montants et employés assignés mis à jour.

Le bouton "Découvrir à nouveau" actualise uniquement les données collectées, par exemple après avoir ajouté de nouvelles permissions à un webhook.

Ce qui ne peut pas être migré

Toute donnée qui ne peut pas être importée apparaît dans le rapport de migration avec la raison.

Les limitations suivantes sont connues à l'avance :

  • Conversations amoCRM. amoCRM ne fournit pas l'historique des conversations via son API. Les notes, messages SMS et appels peuvent toujours être importés.
  • Fichiers amoCRM. Les notes contenant des fichiers sont importées avec le nom du fichier, mais les fichiers réels restent dans amoCRM. Les champs personnalisés de type "Fichier" ne peuvent pas être importés depuis l'un ou l'autre CRM.
  • Champs personnalisés d'entreprise. Mavibot stocke uniquement le nom de l'entreprise et les détails de l'entreprise.
  • Historique système amoCRM. Les changements d'étapes et les messages envoyés par des robots d'automatisation ne sont pas importés.
  • Prospects Bitrix24 convertis. Le prospect d'origine est ignoré, mais la transaction et le contact créés à partir de ce prospect sont importés.
  • Enregistrements sans relation valide. Par exemple, une transaction appartenant à un pipeline supprimé ou une tâche liée à une transaction supprimée. Les transactions sans contacts ne sont pas perdues : elles sont liées à un profil d'entreprise ou à un profil "Aucun contact".
  • Enregistrements d'appels. Seuls les liens vers les enregistrements dans le CRM précédent sont importés. Ces liens peuvent cesser de fonctionner après la déconnexion de l'ancien portail ou compte.

Numéros de téléphone et adresses e-mail

Le premier numéro de téléphone et la première adresse e-mail sont ajoutés aux champs principaux du profil du client.

Les numéros de téléphone supplémentaires, les numéros complets avec extensions, et les valeurs qui ne correspondent pas aux formats standard de téléphone ou d'e-mail sont enregistrés dans les variables "Numéros de téléphone" et "Adresses e-mail".

Après la migration

Les transactions importées apparaissent dans vos pipelines Mavibot CRM.

L'historique des activités des clients est affiché dans les conversations clients, y compris les notes, les appels et les messages importés avec leurs dates d'origine.

Les variables du profil client contiennent l'"ID Bitrix24" ou l'"ID amoCRM", ainsi que des informations supplémentaires telles que :

  • Source
  • Devise
  • Date de clôture
  • Raison de la transaction perdue
  • Étiquettes

En bas de l'assistant de migration, vous trouverez une liste "Migrations".

Elle affiche le statut de chaque migration et le nombre de clients et de transactions importés dans Mavibot.

Déconnectez votre CRM précédent

Une fois la migration terminée, révoquez l'accès à votre CRM précédent.

Bitrix24

Supprimez le webhook dans Développeurs → Intégrations.

amoCRM

Allez dans amoMarket → Votre intégration → Révoquer l'accès.

Mavibot

Vous pouvez cliquer sur "Supprimer la migration" pour supprimer l'URL du webhook ou le jeton et les données de migration collectées.

Les clients et transactions importés resteront dans Mavibot.

Questions fréquemment posées

Puis-je relancer la migration ?

Oui. Utilisez le bouton "Migrer de nouvelles données".

Aucun enregistrement en double ne sera créé. Les enregistrements précédemment importés seront mis à jour, et de nouveaux enregistrements seront ajoutés.

Un client nous a déjà contactés via un messager. Un profil en double sera-t-il créé ?

Non.

Mavibot trouve automatiquement les clients existants avec des numéros de téléphone ou des adresses e-mail correspondants.

Leurs profils existants sont mis à jour, et les transactions importées sont liées à ces profils.

Pourquoi certaines transactions n'ont-elles pas d'employés assignés ?

L'employé peut ne pas avoir été mappé, ou le webhook Bitrix24 peut ne pas avoir la permission Utilisateurs.

Ajoutez l'employé à votre projet Mavibot, sélectionnez-le dans les paramètres de mappage, puis cliquez sur "Migrer de nouvelles données".

L'employé assigné sera mis à jour.

Où puis-je voir quels enregistrements n'ont pas été importés ?

Ouvrez les résultats de la migration et examinez la liste des enregistrements ignorés.

Vous pouvez également télécharger le rapport CSV.

Chaque enregistrement ignoré inclut une explication.

Les robots et campagnes CRM s'exécuteront-ils pour les transactions importées ?

Non.

La migration s'exécute en silence. Les automatisations CRM, les bots et les campagnes ne sont pas déclenchés, et les clients ne reçoivent aucun message.

Et si j'ai migré des données vers le mauvais projet ? Puis-je annuler ?

Il n'y a pas de rollback automatique.

Les clients et transactions importés restent dans Mavibot même après avoir cliqué sur "Supprimer la migration".

Avant de commencer, assurez-vous d'avoir sélectionné le bon projet et examinez attentivement les résultats à l'étape "Examen".