Importer depuis Gorgias
Sur cette page
Transférez vers Deskwoot vos tickets, clients, macros, tags, champs, règles et vues Gorgias avec votre sous-domaine Gorgias, votre adresse e-mail et une clé API. L'import lit tous les tickets avec tous leurs messages et fichiers. Tout est repris par défaut, et vous pouvez choisir d'en importer moins. Il tourne en arrière-plan, continue pendant les mises à jour de Deskwoot et peut être relancé sans risque. Rien ne change dans votre compte Gorgias.
Ce qui est repris
- Les tickets deviennent des conversations avec tous leurs messages, leurs notes internes (en notes privées), leurs pièces jointes, leur statut, leur priorité, leur équipe, leur agent, leurs tags et les valeurs de vos champs de ticket. Chacun garde ses dates d'origine et le canal par lequel il est arrivé (e-mail, chat, téléphone, etc.). Un e-mail arrive tel que Gorgias le conserve pour la lecture : sans sa signature et sans les réponses précédentes qu'il cite. Les messages envoyés par une règle ou un bot Gorgias apparaissent comme ceux de votre équipe, sans agent.
- Tickets Deskwoot : si votre espace de travail utilise les tickets (ils font partie du forfait Enterprise et de l'essai gratuit, et un administrateur peut les désactiver dans Paramètres > Tickets), chaque ticket Gorgias devient aussi un ticket Deskwoot à côté de sa conversation. Le ticket reprend le statut, la priorité, l'objet, l'équipe, l'agent et les étiquettes, et porte le travail à partir de là. Sa conversation est résolue pour le transfert et affiche une carte privée qui indique que le ticket a été importé depuis Gorgias. Sans tickets, la conversation garde le statut Gorgias.
- Les tags deviennent des étiquettes avec leur couleur et leur description. Les tags supprimés restent de côté.
- Les notes de satisfaction deviennent des notes CSAT avec leur score et leur commentaire sur la conversation correspondante. Les enquêtes auxquelles le client n'a jamais répondu restent de côté.
- Les clients deviennent des contacts avec toutes leurs adresses e-mail et tous leurs numéros de téléphone (numéros WhatsApp compris), leur identifiant X, leur langue, leur fuseau horaire, leur note (en note de contact), les valeurs de vos champs client et les données supplémentaires enregistrées sur eux dans Gorgias. Leurs autres canaux, comme Instagram ou Facebook, sont aussi enregistrés sur le contact.
- Les équipes arrivent avec leur description et avec ceux de leurs membres qui sont déjà dans votre espace de travail. Les utilisateurs (vos agents Gorgias) sont associés aux membres de votre équipe grâce à leur e-mail (voir plus bas).
- Les macros qui ne sont pas archivées deviennent des réponses prédéfinies avec leur texte de réponse, leurs images et leurs pièces jointes. Les variables Gorgias que Deskwoot connaît aussi deviennent celles de Deskwoot, par exemple
{{ticket.customer.firstname}}devient{{contact.first_name}}. Le code court vient du nom de la macro. 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'import dans l'Historique des imports indique combien ont été laissées de côté. Ce qu'une macro fait en plus de sa réponse (ajouter des tags, changer le statut ou la priorité, attribuer un agent ou une équipe, ajouter une note interne) devient une macro Deskwoot du même nom pour toute votre équipe. Une macro de ce nom qui existe déjà dans Deskwoot reste telle quelle. - Les champs de ticket et les champs client deviennent des attributs personnalisés avec leur type et les choix d'une liste déroulante. Les champs archivés sont aussi repris, pour que leurs anciennes valeurs arrivent.
- Les règles actives dans Gorgias deviennent des règles d'automatisation, et elles arrivent désactivées. Gorgias écrit une règle sous forme de code, et Deskwoot n'exécute pas ce code : chaque règle importée le garde et liste les actions qu'elle effectuait, pour que vous puissiez la reconstruire avec les conditions et les actions de Deskwoot. Telle qu'elle arrive, elle ne se déclenche jamais.
- Les vues de tickets actives créées par votre équipe deviennent des filtres enregistrés de l'administrateur qui a lancé l'import. Tout ce sur quoi Deskwoot peut filtrer est repris (statut, report, agent, équipe, tags, priorité, valeurs de champs, mots de recherche et tri). Le reste est laissé de côté, donc un filtre peut afficher plus de conversations que la vue, jamais moins. Une vue dont Deskwoot ne peut lire aucune partie du filtre, par exemple une vue basée uniquement sur les champs IA de Gorgias, est laissée de côté, car elle afficherait toutes les conversations.
Fichiers et images
L'import copie dans Deskwoot tous les fichiers hébergés par Gorgias : les pièces jointes et les images de chaque message, les images de vos macros et les fichiers que vos macros joignent, que les réponses prédéfinies proposent comme fichiers que le client peut ouvrir. Rien ne reste un simple lien vers Gorgias, donc vos fichiers continuent de fonctionner après votre départ de Gorgias. Si votre espace de travail a souscrit l'Analyse antivirus, chaque fichier est analysé avant d'être stocké.
- Si un fichier ne peut pas être copié pour le moment (Gorgias 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.
- Chaque import de l'Historique des imports liste ces fichiers sous Fichiers non importés avec la raison, par exemple trop volumineux (plus de 25 MB), type de fichier non autorisé, refusé par l'analyse antivirus ou plus disponible à la source.
- Les images qu'un message ou une macro charge depuis un autre site web, comme le vôtre, restent telles quelles.
Ce qui n'est pas repris
- Votre centre d'aide Gorgias. Gorgias n'a pas d'API pour lui, et sa propre aide indique que les articles ne peuvent pas être exportés.
- Les organisations, car Gorgias n'a pas d'entreprises, et les photos de profil, car les clients Gorgias n'en ont pas. Les membres de votre équipe gardent leur profil Deskwoot.
- Les macros archivées, et les parties d'une macro pour lesquelles une macro Deskwoot n'a pas d'action : remplir un champ de ticket, les actions HTTP et les actions de boutique.
- Les règles et les vues désactivées, les vues système de Gorgias (les dossiers intégrés de la boîte de réception de Deskwoot les remplacent) et les vues de clients.
- Les champs IA de Gorgias et les suppositions de son IA sur les messages (intents). Le motif de contact est repris comme valeur de champ.
- Les données de boutique d'un client issues de Shopify et d'autres applications. Les intégrations de Deskwoot les lisent directement dans votre boutique.
- L'historique des événements d'un ticket. Gorgias ne le fournit qu'un ticket à la fois et seulement pour les 12 derniers mois.
- Les enregistrements et les détails des appels. Un ticket téléphonique arrive avec ses messages.
- Le CC et le CCI des e-mails.
- Les tickets en spam ou dans la corbeille, et les messages supprimés. Un ticket que Gorgias a fusionné avec un autre fait déjà partie de celui-ci.
- Le fait que Gorgias n'a pas pu envoyer une réponse : une telle réponse arrive comme envoyée.
Ce qui reste interne
Deskwoot garde privé ce que seule votre équipe voyait dans Gorgias :
- Les notes internes arrivent en notes privées, et la note d'un client devient une note de contact. Seule votre équipe les voit.
- La carte d'une conversation qui indique son ticket Deskwoot est privée elle aussi.
- Les filtres enregistrés issus des vues Gorgias appartiennent à l'administrateur qui a lancé l'import.
Avant de commencer
- Dans Gorgias, ouvrez Settings > REST API en tant qu'administrateur. Cliquez sur Create API Key, ou copiez la clé déjà présente. La même page affiche votre Username, c'est-à-dire votre adresse e-mail. Seul un administrateur ou le propriétaire du compte peut créer une clé, et une clé lit avec les droits de la personne qui l'a créée : utilisez donc la clé d'un administrateur, pour que l'import puisse lire toutes les parties de votre helpdesk.
- Notez votre sous-domaine Gorgias :
votre-entreprisedansvotre-entreprise.gorgias.com. - Gorgias propose son API REST dans tous ses forfaits Helpdesk, vous n'avez donc besoin d'aucun forfait Gorgias en particulier pour l'import.
- Invitez les membres de votre équipe dans Deskwoot avec la même adresse e-mail que dans Gorgias. Vous pouvez aussi le faire plus tard.
- Pour que les tickets importés arrivent dans une boîte de réception, configurez d'abord vos boîtes de réception e-mail, Telegram, WhatsApp ou SMS.
Comment importer
- Dans Deskwoot, allez dans Paramètres > Import et migration. Seuls les administrateurs peuvent importer.
- Sous D'où viennent vos données ?, choisissez Gorgias.
- Saisissez le Sous-domaine, l'E-mail (le Username que Gorgias affiche à côté de votre clé) et la Clé API.
- Sous Que faut-il reprendre ?, choisissez ce qui est repris. Tout est activé par défaut. Pour n'importer que les tickets plus récents, choisissez un jour sous Uniquement les tickets créés à partir du.
- Sous Dans quelle boîte de réception les tickets doivent-ils aller ?, choisissez une boîte de réception pour chaque type de ticket (E-mail, Chat, Formulaires web et centre d'aide, Téléphone, WhatsApp, SMS, Tout le reste), ou laissez Aucune boîte de réception. Seules les boîtes de réception e-mail, Telegram, WhatsApp et SMS sont proposées. Lors de votre premier import Gorgias, une boîte de réception e-mail, WhatsApp ou SMS qui est la seule de son type dans votre espace de travail est déjà choisie.
- Cliquez sur Lancer l'import. Deskwoot vérifie d'abord le sous-domaine, l'e-mail et la clé auprès de Gorgias. Si Gorgias les refuse, le panneau l'indique et rien ne démarre.
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'éléments déjà traités. Après quelques minutes de mesure, elle affiche aussi la vitesse. Sous À quelle vitesse va l'import, elle indique combien d'appels API par minute votre compte Gorgias autorise et combien l'import en utilise au maximum.
- Gorgias autorise une clé API à faire 40 appels toutes les 20 secondes (toutes les 10 secondes avec son forfait Enterprise). L'import en utilise au maximum 85 %, pour que vos autres applications continuent de fonctionner. Si la limite est quand même 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 vous le signale. Relancez-le pour continuer.
- Un seul import peut tourner à la fois dans un espace de travail. Lancez le suivant quand celui 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 tout ce qu'il a importé jusque-là est supprimé. Une conversation dans laquelle quelqu'un a écrit depuis garde ces nouveaux messages.
- Si Gorgias ne répond plus, l'import garde ce qu'il a déjà lu, termine les autres étapes et s'achève avec Importé en partie et les étapes qui se sont arrêtées trop tôt. Relancez l'import pour continuer. Si Gorgias n'accepte plus la clé, par exemple parce que quelqu'un l'a supprimée, l'exécution s'arrête : lancez un nouvel import avec une clé valide, il saute ce qui est déjà dans Deskwoot.
Les tickets et les réponses de vos agents
Un ticket attribué à un agent Gorgias va au membre de l'équipe qui a la même adresse e-mail, et ses réponses l'affichent comme expéditeur. Quand les tickets sont activés, le ticket Deskwoot va aussi à ce membre de l'équipe. Si cette personne n'a pas encore de compte Deskwoot, le ticket arrive non attribué et ses réponses affichent son nom avec (importé).
Quand elle rejoint plus tard votre espace de travail avec la même adresse e-mail, Deskwoot lui confie automatiquement son travail : ses conversations importées non attribuées lui sont attribuées et elle devient l'expéditeur de ses réponses. Les conversations ouvertes, en attente et reportées arrivent avec une seule notification pour toutes. Les conversations résolues lui sont attribuées discrètement. Aucun statut ne change, et vos clients ne voient rien. Une conversation que quelqu'un a déjà prise en charge dans Deskwoot reste telle quelle. Les tickets Deskwoot créés par l'import ne sont pas confiés de cette façon : attribuez-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 de 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 de SLA et ne les résout pas automatiquement. Les conversations importées ne comptent jamais dans la limite mensuelle de conversations de votre forfait et ne sont jamais bloquées par elle, même après que le client a écrit de nouveau. Résoudre ou rouvrir l'une d'elles à la main ne déclenche aucun webhook ni aucune règle d'automatisation. À partir du 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. Les tickets Deskwoot créés par l'import sont de l'historique eux aussi.
Boîtes de réception pour les tickets importés
- Gorgias note le canal de chaque ticket. L'import place chaque ticket dans la boîte de réception que vous avez choisie pour son type, pour que votre équipe puisse y répondre. Chat correspond au chat en direct de votre site web et de votre application, Formulaires web et centre d'aide aux formulaires de contact et à votre centre d'aide Gorgias, Téléphone aux appels et aux messages vocaux, et Tout le reste à Facebook, Instagram, X, aux tickets créés via l'API et à tous les autres canaux.
- Un ticket 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 tickets arrivent sans boîte de réception.
- Quand les tickets sont activés, la boîte de réception va à la conversation, et une réponse envoyée depuis le ticket Deskwoot joint le client par elle (voir Répondre au client depuis un ticket).
- Quand vous relancez l'import, les tickets que vous avez importés auparavant depuis ce compte Gorgias vont aussi dans les boîtes de réception choisies, s'ils n'en ont pas encore. Un ticket qui a déjà une boîte de réception, ou dans lequel quelqu'un de votre équipe a écrit, reste où il est. L'import suivant part des boîtes de réception du dernier.
- Chaque import de l'Historique des imports indique les boîtes de réception choisies et combien de tickets sont allés dans l'une d'elles.
Après l'import
- Un ticket 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-le et choisissez une boîte de réception dans le message Cette conversation n'a pas de boîte de réception. Pour une boîte e-mail, WhatsApp ou SMS, vous pouvez aussi ajouter au contact l'adresse e-mail ou le numéro de téléphone manquant et relancer l'import.
- Reconstruisez les règles dont vous avez besoin. Ouvrez l'import dans l'Historique des imports : sous Reste à faire, Vérifier et activer les règles vous y mène. Donnez à chacune des conditions et des actions Deskwoot, puis activez-la.
- Vérifiez les filtres enregistrés et les macros : une vue Gorgias peut filtrer sur plus d'éléments que Deskwoot n'en lit, et une action de macro sans équivalent dans Deskwoot a été laissée de côté.
Questions fréquentes
Puis-je relancer l'import ?
Oui, sans risque. Une nouvelle exécution trouve ce qui est déjà dans Deskwoot et le saute : les tickets, contacts, étiquettes et réponses prédéfinies ne sont donc pas dupliqués. Elle reprend ce qui est nouveau ou manquait, par exemple après une exécution qui s'est terminée avec Importé en partie. Un ticket modifié dans Gorgias depuis reçoit ses nouveaux messages et, tant que personne de votre équipe n'a travaillé dessus dans Deskwoot, il reprend aussi le nouveau statut, l'objet, la priorité, l'équipe et l'agent (sur son ticket Deskwoot, s'il en a un). Un contact créé par l'import reçoit ce qui lui manque encore, et rien de ce que votre équipe a saisi n'est écrasé.
Les réponses prédéfinies et les macros que votre équipe a modifiées dans Deskwoot restent telles que vous les avez laissées. Une règle que vous avez reconstruite reste aussi, mais la nouvelle exécution ne retrouve plus l'originale et reprend la version Gorgias, désactivée : supprimez cette copie si vous n'en avez pas besoin.
Gardez à l'esprit que les conversations, contacts et notes que vous avez supprimés ou effacés dans Deskwoot depuis le dernier import reviennent si Gorgias les a encore, tout comme les contacts que vous avez fusionnés.
L'import s'est terminé avec « Importé en partie ». Que faire ?
Gorgias a cessé de répondre pendant une ou plusieurs étapes, par exemple parce que sa limite d'API est restée atteinte longtemps. Tout ce qui a été lu jusque-là est dans Deskwoot. Relancez l'import : il saute ce qui est déjà là et continue.
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 : d'abord par l'ID Gorgias, puis par l'adresse e-mail, qu'elle soit écrite en majuscules ou en minuscules. Ses tickets vont alors au contact que vous avez déjà, et son nom, ses coordonnées et ses champs restent tels quels. Pour qu'il corresponde par ID, donnez à chaque contact son ID Gorgias quand vous l'ajoutez ou le mettez à jour via l'API, dans le champ externalId : gorgias:, votre sous-domaine Gorgias en minuscules, deux-points et l'ID du client dans Gorgias, par exemple gorgias:acme:4711 pour le client 4711 sur acme.gorgias.com. Si tous vos contacts sont déjà dans Deskwoot, vous pouvez désactiver Contacts : chaque ticket va quand même à son contact, et un contact que Deskwoot n'a pas encore arrive avec le ticket.
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 Tickets, Contacts, Réponses prédéfinies (vos macros, avec les macros Deskwoot qui en sont issues) et Notes de satisfaction. Avec un jour sous Uniquement les tickets créés à partir du, seuls les tickets créés ce jour-là ou après sont repris. Les notes ne sont reprises qu'avec les tickets qu'elles évaluent : cette option est donc grisée sans les tickets. Les équipes, les agents, les tags, les champs, les règles et les vues sont toujours repris. Si vous laissez de côté les contacts, chaque ticket importé apporte quand même son propre contact.
Chaque import de l'Historique des imports indique sous Votre choix 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 saute ce qui est déjà dans Deskwoot et reprend ce qui avait été laissé de côté.
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 Deskwoot 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 depuis reste avec ces nouveaux messages, sans ceux importés, et un contact qui a encore une conversation reste aussi. Les équipes, réponses prédéfinies, macros, étiquettes, attributs personnalisés, règles d'automatisation, filtres enregistrés 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 Gorgias plusieurs fois, supprimez les imports du plus récent au plus ancien : tant qu'un import Gorgias plus récent existe, Deskwoot vous demande de supprimer celui-là d'abord.
Deskwoot conserve-t-il ma clé API ?
Seulement pendant l'import, stockée de manière chiffrée, pour pouvoir continuer après un redémarrage. Elle est supprimée à la fin de l'import.
Ce guide vous a-t-il aidé ?
Continuer la lecture
- 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
- Forfaits et tarifs : ce que comprend chaque forfait DeskwootPrix, limites et fonctionnalités des forfaits Hacker, Startup, Business et Enterprise, comment les conversations IA sont comptées et ce qui se passe à la fin d'un essai ou quand vous changez de forfait.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.