Importer depuis Help Scout
Sur cette page
Transférez vers Deskwoot vos conversations, clients, organisations, Saved Replies et votre base de connaissances Docs depuis Help Scout. Il vous faut l'App ID et l'App Secret d'une app que vous créez dans Help Scout, et une clé Docs API pour vos articles Docs. Tout est repris par défaut, et vous pouvez choisir d'en importer moins. L'import tourne en arrière-plan, continue pendant les mises à jour de Deskwoot et peut être relancé sans risque. Rien ne change dans votre compte Help Scout.
Ce qui est repris
- Les conversations arrivent avec tous leurs fils : les messages du client, les réponses de votre équipe, les lignes de chat, les notes privées et les lignes d'activité de Help Scout (assignée, fermée, un workflow s'est exécuté, etc.), avec leurs pièces jointes et leurs images. Chacune garde son objet, ses tags, les valeurs de ses champs personnalisés, ses dates d'origine et le membre de l'équipe ou l'équipe à qui elle était assignée. Un appel qu'un membre de l'équipe a consigné et la note avec laquelle une conversation a été transférée arrivent en notes privées.
- Tickets Deskwoot : si votre espace de travail utilise les tickets (votre plan les inclut et ils sont activés dans Paramètres > Tickets), chaque conversation importée reçoit en plus un ticket Deskwoot. Le ticket reprend le statut, l'objet, l'équipe, l'assignation et les étiquettes, et porte le travail à partir de là. La conversation garde tous ses messages, est résolue pour passer la main au ticket et affiche une carte privée Ticket #… importé depuis Help Scout. Une réponse dans le ticket part par cette conversation. Sans tickets, la conversation garde son statut Help Scout.
- Les tags deviennent des étiquettes. Tous les tags de votre compte sont repris, même un tag qu'aucune conversation importée ne porte (par exemple un tag que seul un workflow ajoute), pour que vous le retrouviez quand vous recréez ce workflow.
- Les notes de satisfaction deviennent des notes CSAT avec le commentaire du client sur la conversation correspondante : Great devient 5, Okay 3 et Not Good 1 sur l'échelle de Deskwoot de 1 à 5. Une conversation avec plusieurs notes garde la plus récente.
- Les clients deviennent des contacts avec toutes leurs adresses e-mail et tous leurs numéros de téléphone, leur poste, leur localisation, leur adresse, leurs sites web, leurs profils sociaux, leurs identifiants de chat, les valeurs de vos propriétés client et leur photo de profil. Le champ Notes d'un client devient la description du contact.
- Les organisations arrivent avec leurs coordonnées et les valeurs de vos propriétés d'organisation, et chaque contact garde son organisation.
- Les users sont associés aux membres de votre équipe grâce à leur e-mail, y compris les adresses e-mail supplémentaires qu'ils ont dans Help Scout (voir plus bas). Les équipes deviennent des équipes, avec ceux de leurs membres qui sont déjà dans votre espace de travail.
- Les Saved Replies deviennent des réponses prédéfinies avec leurs images et leurs fichiers. Le code court vient du nom de la Saved Reply. Une Saved Reply qui a aussi un texte de chat apporte une deuxième réponse prédéfinie pour ce texte, dont le code court se termine par
_chat. Les Saved Replies de plusieurs boîtes de réception avec le même nom et le même texte deviennent une seule réponse prédéfinie ; avec le même nom et un autre texte, elles reçoivent_2,_3, etc. Si une réponse prédéfinie avec le même code court existe déjà dans Deskwoot, celle importée est laissée de côté, et l'Historique des imports indique combien ont été laissées de côté. - Les champs personnalisés de vos boîtes de réception deviennent des attributs de conversation (les champs de même nom et de même type dans plusieurs boîtes de réception n'en font qu'un), les propriétés client des attributs de contact et les propriétés d'organisation des attributs d'organisation.
- Les workflows actifs dans Help Scout deviennent des règles d'automatisation du même nom, désactivées et sans conditions ni actions, car l'API de Help Scout ne les fournit pas. Chaque règle indique dans sa description de quel workflow et de quelle boîte de réception Help Scout elle vient, pour que vous puissiez la recréer.
- Docs : avec une clé Docs API, chaque site Docs devient un centre d'aide à part, qui porte le nom du site. Les collections deviennent des catégories de premier niveau, avec leurs catégories en dessous. Les articles publiés restent publiés, tous les autres arrivent en brouillon.
Fichiers et images
L'import copie dans Deskwoot tous les fichiers hébergés par Help Scout : pièces jointes des conversations, images collées dans les messages et les notes, images et liens vers des fichiers dans les articles Docs et les Saved Replies, et photos de profil que vous avez téléversées pour vos clients. Rien ne reste un simple lien vers Help Scout, donc vos fichiers continuent de fonctionner après votre départ de Help Scout. Si votre espace de travail a souscrit l'Analyse antivirus, chaque fichier est analysé avant d'être stocké.
- Les liens entre les pages de votre site Docs, et les liens vers elles dans les Saved Replies et les conversations, pointent vers la page correspondante de votre centre d'aide Deskwoot, même quand cette page est un brouillon ou en Équipe uniquement. Vos clients peuvent ouvrir une telle page dès que vous la publiez pour eux. Sans la base de connaissances (pas de clé Docs API, ou Base de connaissances désactivée), ces liens restent des liens vers votre site Docs.
- Une photo de profil que Help Scout affiche depuis un autre service, comme Gravatar ou un réseau social, est laissée de côté : l'import ne la demande jamais à ces services. Il en va de même pour les images par défaut que Help Scout dessine pour les clients sans photo.
- Une pièce jointe que l'analyse antivirus de Help Scout a elle-même bloquée est laissée de côté.
- Si un fichier ne peut pas être copié pour le moment (Help Scout ne répond pas, même après plusieurs essais, ou l'antivirus ou le stockage de Deskwoot est injoignable), l'import se termine avec Importé en partie. Relancez l'import pour le copier. Quand 3 fichiers d'affilée venant du même serveur n'arrivent pas, l'exécution met de côté les fichiers de ce serveur pendant 2 minutes, puis réessaie avec l'un d'eux. Si ce fichier arrive, l'exécution continue avec les fichiers du serveur. Sinon, elle attend encore 2 minutes. Ainsi, un serveur qui ne répond pas ne peut pas bloquer tout l'import, et l'exécution suivante réessaie les fichiers mis de côté.
- Un fichier qu'aucune exécution ne peut copier est laissé de côté, et l'import se termine quand même. Cela comprend un fichier resté injoignable pendant 3 exécutions, pour qu'un serveur qui ne répond jamais ne puisse pas bloquer votre import sur Importé en partie. Seules comptent les exécutions où le fichier était injoignable, pas celles où l'antivirus ou le stockage était en panne. Le compteur repart de zéro quand la dernière de ces exécutions date de plus de 7 jours, et la suppression de n'importe quel import de votre espace de travail le remet à zéro.
- L'Historique des imports liste ces fichiers sous Fichiers non importés avec la raison, par exemple trop volumineux (plus de 25 MB, plus de 2 MB pour les photos de profil), type de fichier non autorisé, refusé par une analyse antivirus ou plus disponible chez Help Scout.
- Les images qu'un message ou un article charge depuis un autre site web, comme le vôtre, restent telles quelles.
Ce qui n'est pas repris
Certaines choses ne sont pas fournies par l'API de Help Scout, et pour d'autres Deskwoot n'a pas de place :
- Les conditions et les actions d'un workflow (voir plus haut). Les workflows inactifs restent de côté.
- Les dossiers et les vues (Mine, Assigned, Closed et les vues créées par votre équipe), donc aucun filtre enregistré n'est repris.
- Les brouillons, les réponses retenues pour vérification, et les conversations en spam ou supprimées.
- Une priorité, car Help Scout n'en a pas, et un report : Help Scout garde active une conversation reportée, elle arrive donc ouverte.
- Les adresses en À, Cc et Cci des conversations et des réponses, pour que « Répondre à tous » dans une ancienne conversation ne leur écrive jamais. La note avec laquelle une conversation a été transférée arrive sans l'adresse à laquelle elle a été envoyée.
- Le lien entre une conversation transférée et celle que le transfert a ouverte : les deux arrivent, chacune avec ses propres messages, mais sans lien entre elles.
- Le canal de messagerie (WhatsApp, SMS, Messenger, Instagram) par lequel une conversation est arrivée. Help Scout la liste comme une conversation e-mail, chat ou téléphone, et elle arrive comme telle.
- Les messages individuels d'un chat Beacon terminé : Help Scout garde sa transcription en un seul message, et elle arrive en un seul message.
- Dans Docs : les articles associés, les mots-clés, les redirections, le logo et les couleurs du site, et le brouillon non publié d'un article publié (son texte publié est repris). Un article présent dans plusieurs catégories va dans la première d'entre elles. Une catégorie vide, comme la catégorie Uncategorized de chaque collection, n'arrive qu'une fois qu'elle contient un article.
- Les logos et les couleurs de marque des organisations, ainsi que les photos des users et des équipes.
- Les numéros de conversation de Help Scout. Deskwoot numérote les conversations dans l'ordre où Help Scout les liste, de la plus récente à la plus ancienne.
Ce qui reste interne
Deskwoot garde privé tout ce que votre site Docs ne montrait pas à tout le monde :
- Une collection privée devient une catégorie Équipe uniquement, avec toutes les catégories qu'elle contient. Une catégorie qui n'est pas publique passe aussi en Équipe uniquement.
- Toutes les catégories d'un site Docs qui n'a pas de site public, qui est désactivé ou qui utilise Restricted Docs (visiteurs approuvés uniquement, plans Plus et Pro) passent en Équipe uniquement.
Les catégories Équipe uniquement et leurs articles ne sont visibles que par votre équipe dans le tableau de bord. Ils n'apparaissent jamais sur le centre d'aide public, dans le plan du site, dans le widget de chat ni pour Fynn, le bot IA.
Avant de commencer
- Vérifiez votre plan Help Scout. L'import lit via l'API de Help Scout, incluse dans tous les plans payants et dans l'essai. Le plan Free de Help Scout n'a pas d'API, l'import a donc besoin d'un plan payant ou d'un essai.
- Dans Help Scout, cliquez sur votre avatar et ouvrez Your Profile > My Apps. Faites-le en tant que propriétaire du compte, pour que l'import voie toutes les boîtes de réception. Cliquez sur Create App, saisissez un nom au choix (par exemple « Deskwoot Migration ») et une URL de redirection au choix (par exemple https://deskwoot.com), puis enregistrez. Copiez l'App ID et l'App Secret.
- Pour vos articles Docs, copiez aussi la clé sous Your Profile > Security & Access > Docs API.
- Invitez les membres de votre équipe dans Deskwoot avec le même e-mail que dans Help Scout. Vous pouvez aussi le faire plus tard.
Comment importer
- Dans Deskwoot, allez dans Paramètres > Import et migration. Seuls les admins peuvent importer.
- Choisissez Help Scout.
- Saisissez l'App ID et l'App Secret, ainsi que la Clé Docs API si vous voulez vos articles Docs. Sans la clé, vos articles Docs ne sont pas importés. Au lancement, Deskwoot vérifie les clés auprès de Help Scout et vous prévient si Help Scout les refuse.
- Sous Que faut-il reprendre ?, choisissez ce qui est repris. Tout est activé par défaut. Pour n'importer que les conversations plus récentes, choisissez un jour sous Uniquement les conversations créées à partir du.
- Sous Dans quelle boîte de réception les conversations doivent-elles aller ?, choisissez une boîte de réception pour chaque type de conversation, ou laissez Aucune boîte de réception. Seules les boîtes de réception e-mail, Telegram, WhatsApp et SMS sont proposées, configurez-les donc d'abord.
- Cliquez sur Lancer l'import.
Pendant l'import
- L'import tourne en arrière-plan, vous pouvez donc fermer la page. La page d'import affiche l'étape en cours et le nombre d'enregistrements traités. Après quelques minutes de mesure, elle affiche aussi la vitesse. Elle indique également combien d'appels API par minute votre compte Help Scout autorise et combien l'import en utilise au maximum.
- Help Scout accorde à chaque compte un nombre d'appels API par minute, selon son plan, et compte ensemble les appels de toutes vos applications et intégrations. L'import utilise au maximum 85% de cette limite, pour que vos autres applications continuent de fonctionner pendant qu'il tourne. Quand la limite est atteinte, l'import attend puis reprend.
- Les mises à jour de Deskwoot et les redémarrages du serveur ne l'arrêtent pas. Il reprend là où il s'était arrêté. Si une exécution plante ou reste bloquée 3 fois de suite sans avancer, l'import s'arrête et le signale. Relancez-le pour continuer.
- Un seul import tourne à la fois par espace de travail. Lancez le suivant quand l'import en cours est terminé.
- Pour arrêter un import, cliquez sur Annuler l'import sur la page d'import et confirmez avec Annuler et supprimer. L'import s'arrête et ce qu'il a importé jusque-là est supprimé. Une conversation dans laquelle quelqu'un a écrit entre-temps garde ces nouveaux messages.
- Si Help Scout ne répond plus ou refuse une liste, l'import garde ce qu'il a déjà lu, termine les autres étapes et se termine avec Importé en partie et les étapes arrêtées avant la fin. Relancez l'import pour continuer. Une liste que votre plan Help Scout n'a pas (les équipes et les champs personnalisés des boîtes de réception viennent avec Plus et Pro) est ignorée sans avertissement.
Les conversations et les réponses des membres de votre équipe
Une conversation assignée à un user Help Scout va au membre de l'équipe qui a le même e-mail, et ses réponses et notes l'affichent comme expéditeur. Avec les tickets activés, le ticket Deskwoot va aussi à ce membre de l'équipe. Une conversation assignée à une équipe Help Scout va à l'équipe Deskwoot de ce nom. Si le user n'a pas encore de compte Deskwoot, la conversation arrive sans assignation et ses réponses affichent son nom avec (importé).
Quand cette personne rejoint plus tard votre espace de travail avec le même e-mail, Deskwoot lui transmet automatiquement son travail : ses conversations importées non assignées lui sont assignées et elle devient l'expéditrice de ses réponses. Les conversations ouvertes, en attente et reportées arrivent avec une seule notification pour toutes. Les conversations résolues sont assignées sans notification. Aucun statut ne change, et vos clients ne voient rien. Une conversation que quelqu'un dans Deskwoot a déjà prise en charge reste telle quelle. Les tickets Deskwoot créés par l'import ne sont pas transmis de cette façon : assignez-les à la main.
Les conversations importées restent silencieuses
Les conversations importées sont de l'historique, elles restent donc silencieuses jusqu'à ce que le client écrive à nouveau ou que quelqu'un de votre équipe réponde dans Deskwoot. D'ici là, Deskwoot n'envoie rien au client depuis ces conversations (ni message d'au revoir, ni enquête de satisfaction), ne lance aucun compteur SLA et ne les résout pas automatiquement. Les conversations importées ne comptent jamais dans la limite mensuelle de conversations de votre plan et ne sont jamais bloquées par elle, même après que le client a écrit à nouveau. Résoudre ou rouvrir une conversation à la main ne déclenche aucun webhook ni aucune règle d'automatisation. Dès le premier nouveau message, la conversation fonctionne comme n'importe quelle autre, sauf que Fynn, le bot IA, ne répond jamais dans une conversation importée.
Boîtes de réception pour les conversations importées
- Help Scout note si chaque conversation est un e-mail, un chat ou un appel, et si elle est arrivée par un formulaire de contact Beacon ou Docs. L'import place chaque conversation dans la boîte de réception que vous avez choisie pour son type (E-mail, Chat, Formulaires web et centre d'aide ou Téléphone), pour que votre équipe puisse y répondre. Help Scout liste aussi les conversations WhatsApp, SMS et Messenger sous l'un de ces types, donc les lignes WhatsApp, SMS et Tout le reste ne reçoivent aucune conversation Help Scout.
- Une conversation ne va que dans une boîte de réception où Deskwoot peut joindre le client : une boîte e-mail a besoin de son adresse e-mail, une boîte Telegram de son chat Telegram, et une boîte WhatsApp ou SMS de son numéro de téléphone. Les autres conversations arrivent sans boîte de réception.
- Quand vous relancez l'import, les conversations importées auparavant vont aussi dans les boîtes de réception que vous choisissez, si elles n'en ont pas encore. Une conversation qui a déjà une boîte de réception, ou dans laquelle quelqu'un de votre équipe a écrit, reste où elle est. L'import suivant part des boîtes de réception du dernier.
- Un ticket Deskwoot n'a pas de boîte de réception à lui : ses réponses partent par sa conversation, qui a donc besoin d'une boîte de réception.
- L'Historique des imports affiche les boîtes de réception choisies et combien de conversations sont allées dans l'une d'elles.
Après l'import
- Une conversation sans boîte de réception (parce que vous n'en avez choisi aucune pour son type, ou que Deskwoot ne peut pas y joindre le client) en a besoin d'une avant que vous répondiez : ouvrez-la et choisissez une boîte de réception dans l'avis Cette conversation n'a pas de boîte de réception. L'Historique des imports indique sous Reste à faire combien il y en a.
- Recréez vos workflows : ajoutez les conditions et les actions à chaque règle importée, puis activez celles que vous voulez. L'Historique des imports y mène avec Vérifier et activer les règles.
- Vérifiez les articles et les catégories de votre nouveau centre d'aide, et publiez ceux que vos clients doivent voir.
Questions fréquentes
De quel plan Help Scout ai-je besoin ?
D'un plan payant ou d'un essai : le plan Free de Help Scout n'a pas d'accès à l'API. Les équipes, les champs personnalisés des boîtes de réception et Restricted Docs n'existent dans Help Scout que sur Plus et Pro. Sur Standard, les notes sont datées de la réponse qu'elles évaluent, car les rapports de Help Scout, qui donnent l'heure de chaque note, font partie de Plus et Pro uniquement.
Puis-je importer seulement une partie de mes données ?
Oui. Sous Que faut-il reprendre ?, tout est activé par défaut, et vous pouvez désactiver Conversations, Contacts et organisations, Base de connaissances, Réponses prédéfinies et Notes de satisfaction. Avec un jour sous Uniquement les conversations créées à partir du, seules les conversations créées ce jour-là ou après sont reprises, et seulement les notes données depuis ce jour. Les notes ne sont reprises qu'avec les conversations qu'elles évaluent, donc cette option est grisée sans les conversations. Les tags arrivent aussi avec les conversations. Les users, les équipes, les workflows et les champs des conversations et des contacts sont toujours repris. Si vous laissez de côté les contacts, chaque conversation importée apporte quand même son propre contact.
L'Historique des imports affiche sous chaque import ce qui n'a pas été sélectionné et la date de début. Pour récupérer le reste plus tard, lancez un import avec tout sélectionné : il ignore ce qui est déjà dans Deskwoot et apporte ce qui avait été laissé de côté.
Mes contacts sont déjà dans Deskwoot. L'import les utilise-t-il ?
Oui. Avant d'ajouter un contact, l'import cherche cette personne dans Deskwoot par chacune de ses adresses e-mail, qu'elle soit écrite en majuscules ou en minuscules. Ses conversations vont alors au contact que vous avez déjà, et son nom, ses coordonnées et ses champs restent tels quels. Si tous vos contacts sont déjà dans Deskwoot, vous pouvez désactiver Contacts et organisations : chaque conversation va quand même à son contact, et un contact que Deskwoot n'a pas encore arrive avec la conversation.
Puis-je relancer l'import ?
Oui, sans risque. Une nouvelle exécution trouve ce qui est déjà dans Deskwoot et l'ignore, donc les conversations, contacts et articles ne sont pas dupliqués. Elle apporte ce qui est nouveau ou manquait, par exemple après une exécution terminée avec Importé en partie. Dans une conversation importée auparavant, elle ajoute les nouveaux messages et tags, et reprend un nouveau statut, objet, assignation ou équipe, tant que personne n'a travaillé sur cette conversation dans Deskwoot. Les valeurs de champs modifiées dans Help Scout et les tags qui y ont été retirés ne sont pas repris.
Si vous avez fusionné deux conversations dans Help Scout après un import précédent, une nouvelle exécution apporte les messages déplacés dans la conversation que Help Scout a gardée, et la conversation fusionnée reste dans Deskwoot telle qu'elle a été importée.
Les articles du centre d'aide modifiés par votre équipe dans Deskwoot gardent leur nouveau texte, et une nouvelle exécution ne publie jamais un article que vous avez dépublié ou passé en Équipe uniquement. Si Help Scout a depuis rendu privée une collection ou une catégorie, une nouvelle exécution la passe aussi en Équipe uniquement dans Deskwoot. Si Help Scout a depuis dépublié un article, une nouvelle exécution le dépublie aussi dans Deskwoot, mais seulement si votre équipe ne l'a pas modifié.
Gardez en tête que les conversations, contacts et notes que vous avez supprimés ou effacés dans Deskwoot depuis le dernier import reviennent si Help Scout les a encore, tout comme les contacts que vous avez fusionnés.
L'import s'est terminé avec « Importé en partie ». Que faire ?
Help Scout a cessé de répondre pendant une ou plusieurs étapes, par exemple parce que sa limite d'API est restée épuisée longtemps. Tout ce qui a été lu jusque-là est dans Deskwoot. Relancez l'import : il ignore ce qui est déjà là et continue.
Comment annuler un import ?
Dans l'Historique des imports, cliquez sur Supprimer à côté de l'import, confirmez et saisissez votre mot de passe. Cela supprime les conversations, les tickets et les contacts qu'il a créés, ainsi que les fichiers qu'il a copiés pour eux. Une conversation dans laquelle quelqu'un a écrit entre-temps reste avec ces nouveaux messages, sans les messages importés, et un contact qui a encore une conversation reste aussi. Les équipes, réponses prédéfinies, étiquettes, champs, règles d'automatisation, articles du centre d'aide et autres paramètres restent. La suppression continue après un redémarrage, et vous pouvez lancer un nouvel import une fois qu'elle est terminée. Tant qu'un autre import tourne, aucun import ne peut être supprimé. Si vous avez importé depuis Help Scout plusieurs fois, supprimez les imports du plus récent au plus ancien : tant qu'un import Help Scout plus récent existe, Deskwoot vous demande de supprimer celui-là d'abord.
Ce guide vous a-t-il aidé ?
Continuer la lecture
- Importer depuis TidioTransférez vers Deskwoot vos tickets, chats en direct, contacts et les connaissances Lyro de Tidio avec votre clé API Tidio.Lire le guide
- Coéquipiers IA : les agents IA dans votre équipeConnectez Claude, ChatGPT, Grok Bot ou Cursor comme coéquipiers IA : rôles, ce qu'ils lisent, autonomie et sujets retenus, validations, pause, arrêt et facturation.Lire le guide
- Connecter Grok Bot à DeskwootConnectez Grok Bot comme coéquipier IA : la phrase pour son chat, la page de consentement, les questions de configuration, le réveil pour un nouveau travail et vos données.Lire le guide
Demander à Fynn à propos de ce guide
Obtenez une réponse courte tirée de ce guide et du reste du centre d'aide.