Importer depuis Tidio
Sur cette page
Transférez vos tickets, chats en direct, contacts et les connaissances Lyro de Tidio vers Deskwoot avec votre clé API Tidio. 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 projet Tidio. Tidio ne fournit une partie des données de chaque jour que le lendemain : relancez donc l'import le lendemain pour récupérer le reste.
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 objet, leur statut et leur priorité. Les priorités Low, Normal et High de Tidio deviennent Basse, Moyenne et Haute. Le département devient l'équipe et l'agent la personne attribuée (voir plus bas). Les tags des tickets deviennent des étiquettes, et les champs personnalisés des tickets des attributs personnalisés avec leurs valeurs.
- Tickets Deskwoot : si votre espace de travail utilise les tickets (votre forfait les inclut et ils sont activés dans Paramètres > Tickets), chaque ticket Tidio devient aussi un ticket Deskwoot à côté de sa conversation. Le ticket reprend le statut, la priorité, l'objet, l'équipe et l'agent. Sa conversation garde tous les messages, est résolue lors du passage de relais et affiche une carte privée qui nomme le ticket. Sans tickets, la conversation garde le statut de Tidio.
- Les chats en direct deviennent des conversations, une par chat, avec leurs messages et les fichiers envoyés, y compris les chats de visiteurs qui n'ont jamais laissé d'e-mail. Les messages des bots de Tidio (Flows, Workflows et Lyro) arrivent sans agent. Le premier agent qui a répondu devient la personne attribuée.
- Les notes de satisfaction des tickets et des chats en direct, avec le commentaire du client, deviennent des notes CSAT sur la conversation correspondante.
- Les contacts avec leur nom, e-mail, téléphone, langue, pays, ville et consentement aux e-mails. Les propriétés de contact deviennent des attributs personnalisés avec leurs valeurs. Les notes que vos agents ont écrites sur un visiteur deviennent des notes de contact. Un visiteur sans contact Tidio reçoit son propre contact.
- Les départements deviennent des équipes, sauf « General », qui regroupe tous les agents dans Tidio. Les agents sont associés aux membres de votre équipe grâce à leur e-mail (voir plus bas).
- Connaissances Lyro : les questions et réponses à partir desquelles Lyro, l'agent IA de Tidio, répond deviennent des articles d'un nouveau centre d'aide appelé « Tidio Lyro knowledge », réservé à votre équipe (voir « Ce qui reste interne »).
Fichiers et images
L'import copie dans Deskwoot tous les fichiers hébergés par Tidio : pièces jointes des tickets, images et fichiers dans les messages des tickets, fichiers envoyés dans les chats en direct et images des réponses de Lyro. Rien ne reste un simple lien vers Tidio, donc vos fichiers continuent de fonctionner après votre départ de Tidio. Un lien dans une réponse de Lyro qui mène à votre centre d'aide Tidio ne garde que son texte, car cette page disparaît avec votre compte Tidio. 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 (Tidio 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 chez Tidio.
- 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
- Les réponses prédéfinies (Tidio les appelle Macros), les Flows, les Workflows et les vues enregistrées. Tidio n'a pas d'API pour eux.
- Les organisations, car Tidio n'a pas d'entreprises.
- Les tags de clients, les photos de profil des contacts et les membres de chaque département. Aucune API de Tidio ne les fournit, ajoutez donc les membres de votre équipe aux équipes dans Deskwoot.
- Votre centre d'aide Tidio, car Tidio n'a pas d'API pour lui. Un article que vous avez activé pour Lyro ou Copilot arrive avec les connaissances Lyro, dans la mesure où Tidio l'y liste.
- Les fichiers que vous avez téléversés dans Lyro, comme des PDF. Leurs questions et réponses sont reprises, mais pas le fichier lui-même.
- Les notes internes des chats en direct, car les API de Tidio ne les marquent pas comme des notes. Les notes internes des tickets arrivent en notes privées.
- Le CC et le CCI des tickets e-mail.
- Les tickets du dossier spam de Tidio et les tickets que vous avez supprimés. Tidio supprime un ticket qu'il fusionne avec un autre, et ses messages arrivent avec cet autre ticket.
- Les pages qu'un contact a consultées, les liens vers votre panneau Tidio, le canal par lequel un chat en direct est arrivé, et le fait qu'une note concernait un agent ou Lyro.
Ce qui reste interne
Les connaissances de Lyro sont ce à partir de quoi l'agent IA de Tidio répond, pas une page pour vos clients. L'import les réserve donc à votre équipe :
- Chaque catégorie du centre d'aide « Tidio Lyro knowledge » est en Équipe uniquement : une pour chaque dossier Lyro, avec ses sous-dossiers en dessous, et une appelée « Lyro Q&A » pour les questions hors de tout dossier.
- Les questions et réponses utilisées par Lyro ou par le Copilot de Tidio arrivent publiées. Celles qui sont désactivées dans Tidio arrivent en brouillon.
- Un nouvel import du même projet remet ces catégories en équipe uniquement et replace dans sa catégorie Lyro un article que votre équipe a mis dans une catégorie Pour les clients.
Les articles réservés à l'équipe ne sont visibles que par votre équipe dans le tableau de bord : dans le Centre d'aide, choisissez « Tidio Lyro knowledge » et Équipe uniquement. Les clients, le widget de chat et Fynn, le bot IA, ne les voient jamais, et Copilot utilise ceux qui sont publiés quand il répond à votre équipe. Pour en savoir plus, consultez Articles pour les clients et articles réservés à l'équipe.
Avant de commencer
- Vérifiez votre forfait Tidio : Tidio documente son API pour les forfaits Plus et Premium. Si Tidio n'autorise pas l'accès à l'API pour votre projet, Deskwoot vous le signale au lancement de l'import.
- Dans Tidio, ouvrez Settings > Developer > Tidio APIs en tant que propriétaire du projet ou administrateur.
- Cliquez sur Generate API key et copiez le Client ID et le Client secret. Tidio n'affiche le secret qu'une seule fois.
- Invitez les membres de votre équipe dans Deskwoot avec la même adresse e-mail que dans Tidio. 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 Tidio.
- Collez le Client ID (il commence par
ci_) et le Client secret (il commence parcs_). - 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 (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. Cela concerne vos tickets Tidio : les chats en direct ne reçoivent pas de boîte de réception. Seules les boîtes de réception e-mail, Telegram, WhatsApp et SMS sont proposées. Si votre espace de travail a exactement une boîte de réception e-mail, WhatsApp ou SMS, elle est déjà choisie pour ce type.
- Cliquez sur Lancer l'import. Deskwoot vérifie d'abord le Client ID et le Client secret auprès de Tidio. Si Tidio 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 Tidio autorise et combien l'import en utilise au maximum.
- Tidio limite les appels API de chaque projet par minute (sa documentation indique 60 sur Plus et 120 sur Premium). L'import utilise au maximum 85 % de cette limite, 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 Tidio ne répond plus ou refuse une liste, 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.
Les conversations et les réponses de vos agents
Un ticket attribué à un agent Tidio, et un chat en direct auquel un agent a répondu en premier, vont au membre de l'équipe qui a la même adresse e-mail, et les réponses de l'agent l'affichent comme expéditeur. Avec les tickets activés, le ticket Deskwoot va aussi à ce membre de l'équipe. Si cette personne n'a pas encore de compte Deskwoot, la conversation arrive non attribuée et ses réponses affichent son nom avec (importé). Les agents que vous avez retirés de Tidio gardent leur nom sur leurs réponses de la même façon.
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 qu'une personne 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 à nouveau ou qu'un membre 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 délai 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 un nouveau message du client. Résoudre ou rouvrir une conversation à la main ne déclenche aucun webhook ni aucune règle d'automatisation. À partir du premier nouveau message, la conversation fonctionne comme les autres, 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 de la même façon.
Boîtes de réception pour les tickets importés
- Tidio note d'où vient chaque ticket, par exemple d'un e-mail ou d'un formulaire de contact. L'import place la conversation de chaque ticket dans la boîte de réception que vous avez choisie pour son type, pour que votre équipe puisse y répondre. Les chats en direct ne reçoivent pas de boîte de réception.
- Tidio ne fournit l'origine d'un ticket que le lendemain (voir « Après l'import »). Un ticket du jour arrive donc sans boîte de réception, et l'import dans l'Historique des imports le compte sous Conversations sans canal enregistré. Une exécution le lendemain le place dans la boîte de réception que vous avez choisie.
- 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 un membre de votre équipe a écrit, reste où elle est. L'import suivant reprend les boîtes de réception du dernier.
- L'import dans 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
- Relancez l'import le lendemain. Tidio remplit son API Analytics, d'où viennent les chats en direct, les notes de satisfaction et les notes sur les contacts, une fois par jour : les données de chaque jour arrivent le lendemain vers 10:00 UTC. Les tickets et leurs messages arrivent tout de suite, mais pour la journée en cours, la première exécution ne peut pas encore tout reprendre : les chats en direct (seuls les chats des contacts créés par Tidio depuis sa dernière mise à jour quotidienne arrivent tout de suite), leurs notes de satisfaction, les nouvelles notes sur les contacts, ainsi que les tags, les valeurs des champs et la boîte de réception des tickets du jour. Une exécution après 10:00 UTC le lendemain ajoute ce qui manquait et ne crée aucun doublon.
- Une conversation sans boîte de réception (parce que vous n'en avez choisi aucune pour son type, que Deskwoot ne peut pas y joindre le client ou que c'est un chat en direct) 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. Si vous avez choisi des boîtes de réception, l'import dans l'Historique des imports compte sous Reste à faire les tickets restés sans boîte de réception.
- Ajoutez les membres de votre équipe aux équipes issues de vos départements.
Questions fréquentes
De quel forfait Tidio ai-je besoin ?
Tidio documente son API pour les forfaits Plus et Premium. Quand vous cliquez sur Lancer l'import, Deskwoot interroge d'abord Tidio sur votre projet. Si Tidio n'autorise pas l'accès à l'API pour ce projet, le panneau l'indique et rien n'est importé : vérifiez votre forfait Tidio, puis relancez l'import.
Certains chats du jour manquent. Pourquoi ?
Tidio fournit les chats en direct, les notes de satisfaction, les notes sur les contacts et certaines informations des tickets via son API Analytics, que Tidio remplit une fois par jour : les données de chaque jour arrivent le lendemain vers 10:00 UTC. Relancez l'import après cette heure. Il ajoute ce qui manquait, par exemple les chats du jour, leurs notes de satisfaction et la boîte de réception des tickets du jour, et ne crée aucun doublon.
Puis-je relancer l'import ?
Oui, sans aucun 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 créés en double. Elle reprend ce qui est nouveau ou manquait, par exemple après une exécution terminée avec Importé en partie. Un ticket ou un chat modifié dans Tidio reprend son nouveau statut, tant que personne de votre équipe n'y a écrit. Un nouveau message dans un ticket déjà importé arrive tout de suite si autre chose a aussi changé dans le ticket (son statut, sa priorité, son agent, son département ou son objet), sinon avec une exécution le lendemain.
Les réponses Lyro que votre équipe a modifiées dans Deskwoot gardent leur nouveau texte. Une réponse désactivée dans Tidio entre-temps passe en brouillon, mais seulement si votre équipe ne l'a pas modifiée.
Attention : les conversations, contacts et notes que vous avez supprimés ou effacés dans Deskwoot depuis le dernier import reviennent si Tidio les a toujours, tout comme les contacts que vous avez fusionnés.
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 (vos tickets et chats en direct), Contacts, Base de connaissances (vos connaissances Lyro) 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. Les notes de satisfaction ne sont reprises qu'avec les conversations qu'elles évaluent, donc cette option est grisée sans les conversations. Les équipes, agents et champs sont toujours repris, et les étiquettes arrivent avec les conversations. Si vous laissez de côté les contacts, chaque conversation importée apporte quand même son propre contact, sans les notes.
Quand vous ouvrez un import dans l'Historique des imports, Votre choix indique 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 reprend 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 : d'abord par l'ID Tidio, puis par l'adresse 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. Pour une correspondance par ID, donnez à chaque contact son ID Tidio quand vous l'ajoutez ou le mettez à jour via l'API, dans le champ externalId : tidio:, l'ID de votre projet Tidio (l'API de Tidio l'appelle project_id), deux-points et l'ID du contact dans l'API de Tidio, par exemple tidio:1234567:5f1c2b9e-8a7d-4c3b-9e21-0d4f6a7b8c9d. Si tous vos contacts sont déjà dans Deskwoot, vous pouvez désactiver Contacts : chaque conversation va quand même à son contact, et un contact que Deskwoot n'a pas encore arrive avec la conversation.
Comment annuler un import ?
Dans l'Historique des imports, cliquez sur Supprimer à côté de l'import 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 depuis reste avec ces nouveaux messages, sans les messages importés, et un contact qui a encore une conversation reste aussi. Les équipes, agents, étiquettes, champs, les connaissances Lyro et autres paramètres restent en place. La suppression continue après un redémarrage, et vous pouvez lancer un nouvel import une fois qu'elle est terminée. Pendant qu'un autre import tourne, aucun import ne peut être supprimé. Si vous avez importé depuis Tidio plusieurs fois, supprimez les imports du plus récent au plus ancien : tant qu'un import Tidio plus récent existe, Deskwoot vous demande de supprimer celui-là d'abord.
Ce guide vous a-t-il aidé ?
Continuer la lecture
- 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
- Équipes : répartir les conversations par service, langue ou compétenceRegroupez vos agents en équipes pour que les conversations arrivent aux bonnes personnes : comment les conversations arrivent dans une équipe, qui les reçoit dans l'équipe, les dossiers de l'équipe, ce que voient les membres et les rapports par équipe.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.