Import aus Tidio
Auf dieser Seite
Hol deine Tidio-Tickets, Livechats, Kontakte und dein Lyro-Wissen mit deinem Tidio-API-Schlüssel zu Deskwoot. Standardmäßig kommt alles mit, und du kannst auch weniger importieren. Der Import läuft im Hintergrund, läuft bei Updates von Deskwoot weiter und lässt sich gefahrlos erneut starten. In deinem Tidio-Projekt ändert sich nichts. Einen Teil der Daten eines Tages gibt Tidio erst am nächsten Tag heraus. Starte den Import deshalb am nächsten Tag noch einmal, um den Rest zu holen.
Was übernommen wird
- Tickets werden zu Konversationen mit jeder Nachricht, internen Notizen (als private Notizen), Anhängen, Betreff, Status und Priorität. Die Prioritäten Low, Normal und High von Tidio werden zu Niedrig, Mittel und Hoch. Die Abteilung wird zum Team und der Agent zur zugewiesenen Person (siehe unten). Ticket-Tags werden zu Labels, und benutzerdefinierte Ticketfelder werden zu benutzerdefinierten Attributen mit ihren Werten.
- Deskwoot-Tickets: Wenn dein Workspace Tickets nutzt (dein Plan enthält sie und sie sind unter Einstellungen > Tickets eingeschaltet), wird jedes Tidio-Ticket zusätzlich zu einem Deskwoot-Ticket neben seiner Konversation. Das Ticket übernimmt Status, Priorität, Betreff, Team und Agent. Seine Konversation behält jede Nachricht, wird bei der Übergabe auf Erledigt gesetzt und zeigt eine private Karte, die das Ticket nennt. Ohne Tickets behält die Konversation den Status aus Tidio.
- Livechats werden zu Konversationen, eine pro Chat, mit ihren Nachrichten und den Dateien, die darin geschickt wurden, auch die Chats von Besuchern, die nie eine E-Mail hinterlassen haben. Nachrichten der Bots von Tidio (Flows, Workflows und Lyro) kommen ohne Agent an. Der erste Agent, der geantwortet hat, wird zur zugewiesenen Person.
- Zufriedenheitsbewertungen von Tickets und Livechats werden mit dem Kommentar des Kunden zu CSAT-Bewertungen an der passenden Konversation.
- Kontakte mit Name, E-Mail, Telefon, Sprache, Land, Stadt und E-Mail-Einwilligung. Kontakteigenschaften werden zu benutzerdefinierten Attributen mit ihren Werten. Notizen, die deine Agenten zu einem Besucher geschrieben haben, werden zu Kontaktnotizen. Ein Besucher ohne Tidio-Kontakt bekommt einen eigenen Kontakt.
- Abteilungen werden zu Teams, außer „General“, die in Tidio alle Agenten enthält. Agenten werden per E-Mail deinen Teammitgliedern zugeordnet (siehe unten).
- Lyro-Wissen: Die Fragen und Antworten, aus denen Lyro, der KI-Agent von Tidio, antwortet, werden zu Artikeln in einem neuen Hilfecenter namens „Tidio Lyro knowledge“, nur für dein Team (siehe „Was intern bleibt“).
Dateien und Bilder
Der Import kopiert jede Datei, die bei Tidio liegt, zu Deskwoot: Anhänge von Tickets, Bilder und Dateien in Ticketnachrichten, Dateien, die in Livechats geschickt wurden, und die Bilder in den Antworten von Lyro. Nichts bleibt ein Link zu Tidio, deine Dateien funktionieren also weiter, auch wenn du Tidio verlässt. Ein Link in einer Lyro-Antwort, der in dein Tidio-Hilfecenter führt, behält nur seinen Text, weil diese Seite mit deinem Tidio-Konto verschwindet. Wenn dein Workspace den Virenscan gebucht hat, wird jede Datei geprüft, bevor sie gespeichert wird.
- Lässt sich eine Datei gerade nicht kopieren (Tidio antwortet auch nach mehreren Versuchen nicht, oder der Virenscanner oder der Speicher von Deskwoot ist nicht erreichbar), endet der Import mit Teilweise importiert. Starte den Import erneut, um sie zu kopieren. Kommen 3 Dateien von demselben Server hintereinander nicht an, überspringt der Lauf die Dateien dieses Servers 2 Minuten lang und versucht dann wieder eine davon. Kommt sie an, macht der Lauf mit den Dateien des Servers weiter. Wenn nicht, wartet er weitere 2 Minuten. So kann ein Server, der nicht antwortet, nicht den ganzen Import aufhalten, und der nächste Lauf versucht die übersprungenen Dateien erneut.
- Eine Datei, die kein Lauf kopieren kann, wird ausgelassen, und der Import wird trotzdem fertig. Dazu gehört auch eine Datei, die in 3 Läufen nicht erreichbar war, damit ein Server, der nie antwortet, deinen Import nicht dauerhaft auf Teilweise importiert hält. Es zählen nur Läufe, in denen die Datei nicht erreichbar war, keine Läufe, in denen der Virenscanner oder der Speicher ausgefallen war. Liegt der letzte dieser Läufe mehr als 7 Tage zurück, beginnt die Zählung neu, und wenn du einen beliebigen Import deines Workspace löschst, wird sie zurückgesetzt.
- Jeder Import im Importverlauf listet solche Dateien unter Nicht importierte Dateien mit dem Grund, zum Beispiel zu groß (über 25 MB), ein nicht erlaubter Dateityp, vom Virenscan abgelehnt oder bei Tidio nicht mehr verfügbar.
- Bilder, die eine Nachricht oder ein Artikel von einer anderen Website lädt, etwa von deiner eigenen, bleiben, wie sie sind.
Was nicht übernommen wird
- Textvorlagen (Tidio nennt sie Macros), Flows, Workflows und gespeicherte Ansichten. Tidio hat keine API dafür.
- Organisationen, weil Tidio keine Unternehmen kennt.
- Kundentags, Profilbilder von Kontakten und die Mitglieder jeder Abteilung. Keine API von Tidio liefert sie, füge deine Teammitglieder also in Deskwoot den Teams hinzu.
- Dein Tidio-Hilfecenter, weil Tidio keine API dafür hat. Ein Artikel, den du für Lyro oder Copilot eingeschaltet hast, kommt mit dem Lyro-Wissen, soweit Tidio ihn dort auflistet.
- Dateien, die du bei Lyro hochgeladen hast, etwa PDFs. Ihre Fragen und Antworten kommen mit, die Datei selbst nicht.
- Interne Notizen in Livechats, weil die APIs von Tidio sie nicht als Notizen kennzeichnen. Interne Notizen in Tickets kommen als private Notizen mit.
- CC und BCC von E-Mail-Tickets.
- Tickets im Spam-Ordner von Tidio und Tickets, die du gelöscht hast. Tidio löscht ein Ticket, das es mit einem anderen zusammenführt, und seine Nachrichten kommen mit diesem anderen Ticket.
- Die Seiten, die ein Kontakt angesehen hat, die Links in dein Tidio-Panel, der Kanal, über den ein Livechat kam, und ob eine Bewertung einem Agenten oder Lyro galt.
Was intern bleibt
Das Wissen von Lyro ist das, woraus der KI-Agent von Tidio antwortet, keine Seite für deine Kunden. Deshalb hält der Import es für dein Team:
- Jede Kategorie des Hilfecenters „Tidio Lyro knowledge“ ist Nur fürs Team: eine für jeden Lyro-Ordner, mit seinen Unterordnern darunter, und eine namens „Lyro Q&A“ für die Fragen außerhalb eines Ordners.
- Fragen und Antworten, die Lyro oder der Copilot von Tidio nutzt, kommen veröffentlicht an. Die in Tidio ausgeschalteten kommen als Entwürfe an.
- Ein neuer Import desselben Projekts macht diese Kategorien wieder zu Kategorien nur fürs Team und verschiebt einen Artikel, den dein Team in eine Kategorie Für Kunden gelegt hat, zurück in seine Lyro-Kategorie.
Artikel nur fürs Team sieht nur dein Team im Dashboard: Wähl im Hilfecenter „Tidio Lyro knowledge“ und Nur fürs Team. Kunden, das Chat-Widget und Fynn, der KI-Bot, sehen sie nie, und Copilot nutzt die veröffentlichten, wenn er deinem Team antwortet. Mehr dazu in Artikel für Kunden und Artikel nur fürs Team.
Bevor du startest
- Prüf deinen Tidio-Tarif: Tidio dokumentiert seine API für die Tarife Plus und Premium. Erlaubt Tidio für dein Projekt keinen API-Zugriff, sagt Deskwoot dir das beim Start des Imports.
- Öffne in Tidio als Projektinhaber oder Admin Settings > Developer > Tidio APIs.
- Klicke auf Generate API key und kopiere Client ID und Client secret. Tidio zeigt das Secret nur einmal.
- Lade deine Teammitglieder mit derselben E-Mail zu Deskwoot ein, die sie in Tidio nutzen. Das geht auch später.
- Damit importierte Tickets in einem Posteingang landen, leg vorher deine Posteingänge für E-Mail, Telegram, WhatsApp oder SMS an.
So importierst du
- Geh in Deskwoot zu Einstellungen > Import & Migration. Nur Admins können importieren.
- Wähl unter Woher kommen deine Daten? den Eintrag Tidio.
- Füge Client ID (beginnt mit
ci_) und Client secret (beginnt mitcs_) ein. - Wähl unter Was soll mitkommen?, was übernommen wird. Standardmäßig ist alles an. Willst du nur neuere Konversationen, wähl einen Tag unter Nur Konversationen, die ab diesem Tag erstellt wurden.
- Wähl unter In welchen Posteingang sollen die Konversationen? für jede Art einen Posteingang (E-Mail, Chat, Webformulare und Hilfecenter, Telefon, WhatsApp, SMS, Alles andere) oder lass Kein Posteingang stehen. Das gilt für deine Tidio-Tickets: Livechats bekommen keinen Posteingang. Angeboten werden nur Posteingänge für E-Mail, Telegram, WhatsApp und SMS. Hat dein Workspace genau einen Posteingang für E-Mail, WhatsApp oder SMS, ist er für diese Art schon ausgewählt.
- Klicke auf Import starten. Deskwoot prüft Client ID und Client secret zuerst bei Tidio. Lehnt Tidio sie ab, zeigt das Panel das an, und nichts startet.
Während der Import läuft
- Der Import läuft im Hintergrund, du kannst die Seite also schließen. Die Importseite zeigt, bei welchem Schritt er ist und wie viele Datensätze fertig sind. Nach ein paar Minuten Messung zeigt sie auch das Tempo. Unter Wie schnell der Import geht zeigt sie, wie viele API-Aufrufe pro Minute dein Tidio-Konto erlaubt und wie viele davon der Import höchstens nutzt.
- Tidio begrenzt die API-Aufrufe jedes Projekts pro Minute (seine Dokumentation nennt 60 bei Plus und 120 bei Premium). Der Import nutzt höchstens 85 % davon, damit deine anderen Apps weiterlaufen. Ist das Limit trotzdem erreicht, wartet der Import und macht dann weiter.
- Updates von Deskwoot und Serverneustarts halten ihn nicht auf. Er macht dort weiter, wo er stand. Stürzt ein Lauf 3 Mal hintereinander ab oder hängt er fest, ohne weiterzukommen, stoppt der Import und zeigt das an. Starte ihn erneut, um fortzufahren.
- Pro Workspace läuft immer nur ein Import. Starte den nächsten, wenn der aktuelle fertig ist.
- Um einen Import zu stoppen, klick auf der Importseite auf Import abbrechen und bestätige mit Abbrechen und löschen. Der Import stoppt, und was er bisher importiert hat, wird gelöscht. Eine Konversation, in der seitdem jemand geschrieben hat, behält diese neuen Nachrichten.
- Wenn Tidio nicht mehr antwortet oder eine Liste verweigert, behält der Import, was er schon gelesen hat, erledigt die übrigen Schritte und endet mit Teilweise importiert und den Schritten, die vorzeitig beendet wurden. Starte den Import erneut, um fortzufahren.
Konversationen und Antworten deiner Agenten
Ein Ticket, das einem Tidio-Agenten zugewiesen war, und ein Livechat, auf den ein Agent zuerst geantwortet hat, gehen an das Teammitglied mit derselben E-Mail, und die Antworten des Agenten zeigen es als Absender. Sind Tickets eingeschaltet, geht auch das Deskwoot-Ticket an dieses Teammitglied. Hat diese Person noch kein Deskwoot-Konto, kommt die Konversation ohne Zuweisung an und ihre Antworten zeigen ihren Namen mit (importiert). Agenten, die du aus Tidio entfernt hast, behalten ihren Namen an ihren Antworten genauso.
Tritt sie später mit derselben E-Mail deinem Workspace bei, übergibt Deskwoot ihr die Arbeit automatisch: Ihre nicht zugewiesenen importierten Konversationen werden ihr zugewiesen, und sie wird Absender ihrer Antworten. Für offene und wartende Konversationen und die mit Erinnerung gibt es eine Benachrichtigung für alle zusammen. Erledigte werden still zugewiesen. Kein Status ändert sich, und deine Kunden merken nichts. Eine Konversation, die schon jemand in Deskwoot hatte, bleibt, wie sie ist. Die Deskwoot-Tickets, die der Import angelegt hat, werden so nicht übergeben: Weise sie von Hand zu.
Importierte Konversationen bleiben still
Importierte Konversationen sind Verlauf. Deshalb bleiben sie still, bis der Kunde wieder schreibt oder jemand aus deinem Team in Deskwoot antwortet. Bis dahin schickt Deskwoot dem Kunden nichts daraus (keine Abschiedsnachricht, keine Zufriedenheitsumfrage), startet keine SLA-Uhr und setzt sie nicht automatisch auf Erledigt. Importierte Konversationen zählen nie zum monatlichen Konversationslimit deines Plans und werden nie durch das Limit gesperrt, auch nicht, wenn der Kunde wieder schreibt. Wenn du eine von Hand erledigst oder wieder öffnest, startet das keinen Webhook und keine Automatisierungsregel. Ab der ersten neuen Nachricht funktioniert die Konversation wie jede andere, nur antwortet Fynn, der KI-Bot, nie in einer importierten Konversation. Die Deskwoot-Tickets, die der Import angelegt hat, sind genauso Verlauf.
Posteingänge für importierte Tickets
- Tidio merkt sich, woher jedes Ticket kam, zum Beispiel aus einer E-Mail oder einem Kontaktformular. Der Import legt die Konversation jedes Tickets in den Posteingang, den du für seine Art gewählt hast, damit dein Team dort antworten kann. Livechats bekommen keinen Posteingang.
- Woher ein Ticket kam, gibt Tidio erst am nächsten Tag heraus (siehe „Nach dem Import“). Ein Ticket von heute kommt deshalb ohne Posteingang, und der Import im Importverlauf zählt es unter Konversationen ohne gespeicherten Kanal. Ein Lauf am nächsten Tag legt es in den Posteingang, den du gewählt hast.
- Eine Konversation kommt nur in einen Posteingang, über den Deskwoot den Kunden erreichen kann: Für einen E-Mail-Posteingang braucht es seine E-Mail-Adresse, für einen Telegram-Posteingang seinen Telegram-Chat und für einen WhatsApp- oder SMS-Posteingang seine Telefonnummer. Andere Konversationen kommen ohne Posteingang.
- Startest du den Import erneut, kommen auch früher importierte Konversationen in die gewählten Posteingänge, wenn sie noch keinen haben. Eine, die schon einen Posteingang hat oder in der jemand aus deinem Team geschrieben hat, bleibt, wo sie ist. Der nächste Import startet mit den Posteingängen des letzten.
- Der Import im Importverlauf zeigt die gewählten Posteingänge und wie viele Konversationen in einen Posteingang gekommen sind.
Nach dem Import
- Starte den Import am nächsten Tag noch einmal. Tidio füllt seine Analytics API, aus der die Livechats, die Bewertungen und die Notizen zu Kontakten kommen, einmal am Tag: Die Daten eines Tages kommen am nächsten Tag gegen 10:00 UTC an. Tickets und ihre Nachrichten kommen sofort, aber vom laufenden Tag kann der erste Lauf noch nicht alles holen: die Livechats (sofort kommen nur die Chats von Kontakten, die Tidio seit seiner letzten täglichen Aktualisierung angelegt hat), ihre Bewertungen, neue Notizen zu Kontakten sowie Tags, Feldwerte und Posteingang der Tickets von heute. Ein Lauf nach 10:00 UTC am nächsten Tag holt, was gefehlt hat, und legt nichts doppelt an.
- Eine Konversation ohne Posteingang (weil du für ihre Art keinen gewählt hast, Deskwoot den Kunden dort nicht erreicht oder sie ein Livechat ist) braucht einen, bevor du antwortest: Öffne sie und wähl im Hinweis Diese Konversation hat keinen Posteingang einen Posteingang. Hast du Posteingänge gewählt, zählt der Import im Importverlauf die Tickets, die ohne einen geblieben sind, unter Noch zu tun.
- Füge deine Teammitglieder den Teams hinzu, die aus deinen Abteilungen entstanden sind.
Häufige Fragen
Welchen Tidio-Tarif brauche ich?
Tidio dokumentiert seine API für die Tarife Plus und Premium. Wenn du auf Import starten klickst, fragt Deskwoot Tidio zuerst nach deinem Projekt. Erlaubt Tidio dafür keinen API-Zugriff, zeigt das Panel das an, und nichts wird importiert: Prüf deinen Tidio-Tarif und starte den Import dann erneut.
Einige Chats von heute fehlen. Warum?
Livechats, Bewertungen, Notizen zu Kontakten und einige Angaben zu Tickets gibt Tidio über seine Analytics API heraus, die Tidio einmal am Tag füllt: Die Daten eines Tages kommen am nächsten Tag gegen 10:00 UTC an. Starte den Import danach erneut. Er holt, was gefehlt hat, zum Beispiel die Chats von heute, ihre Bewertungen und den Posteingang der Tickets von heute, und legt nichts doppelt an.
Kann ich den Import erneut starten?
Ja, das ist sicher. Ein neuer Lauf findet, was schon in Deskwoot ist, und überspringt es. Konversationen, Kontakte und Artikel werden also nicht doppelt angelegt. Er holt, was neu ist oder gefehlt hat, zum Beispiel nach einem Lauf, der mit Teilweise importiert endete. Ein Ticket oder Chat, der sich in Tidio geändert hat, übernimmt seinen neuen Status, solange niemand aus deinem Team darin geschrieben hat. Eine neue Nachricht in einem schon importierten Ticket kommt sofort, wenn sich auch etwas anderes am Ticket geändert hat (Status, Priorität, Agent, Abteilung oder Betreff), sonst mit einem Lauf am nächsten Tag.
Lyro-Antworten, die dein Team in Deskwoot bearbeitet hat, behalten ihren neuen Text. Eine Antwort, die inzwischen in Tidio ausgeschaltet ist, wird zum Entwurf, aber nur, wenn dein Team sie nicht bearbeitet hat.
Denk daran: Konversationen, Kontakte und Notizen, die du seit dem letzten Import in Deskwoot gelöscht oder entfernt hast, kommen zurück, wenn Tidio sie noch hat. Das gilt auch für zusammengeführte Kontakte.
Kann ich nur einen Teil meiner Daten importieren?
Ja. Unter Was soll mitkommen? ist standardmäßig alles an, und du kannst Konversationen (deine Tickets und Livechats), Kontakte, Wissensdatenbank (dein Lyro-Wissen) und Zufriedenheitsbewertungen ausschalten. Wählst du unter Nur Konversationen, die ab diesem Tag erstellt wurden einen Tag, kommen nur Konversationen, die an diesem Tag oder später erstellt wurden. Bewertungen kommen nur mit den Konversationen, die sie bewerten, deshalb ist diese Option ohne die Konversationen ausgegraut. Teams, Agenten und Felder kommen immer mit, Labels mit den Konversationen. Lässt du die Kontakte weg, bringt jede importierte Konversation trotzdem ihren eigenen Kontakt mit, ohne die Notizen.
Öffnest du einen Import im Importverlauf, zeigt Deine Auswahl, was nicht ausgewählt war, und das Startdatum. Willst du den Rest später holen, starte einen Import, bei dem alles ausgewählt ist: Er überspringt, was schon in Deskwoot ist, und holt, was gefehlt hat.
Meine Kontakte sind schon in Deskwoot. Nutzt der Import sie?
Ja. Bevor der Import einen Kontakt anlegt, sucht er die Person in Deskwoot: zuerst über die Tidio-ID, dann über die E-Mail-Adresse, egal ob groß oder klein geschrieben. Die Konversationen dieser Person kommen dann zu dem Kontakt, den du schon hast, und Name, Angaben und Felder bleiben, wie sie sind. Damit die ID passt, gib jedem Kontakt seine Tidio-ID, wenn du ihn über die API anlegst oder änderst, im Feld externalId: tidio:, deine Tidio-Projekt-ID (die API von Tidio nennt sie project_id), ein Doppelpunkt und die ID des Kontakts in der API von Tidio, zum Beispiel tidio:1234567:5f1c2b9e-8a7d-4c3b-9e21-0d4f6a7b8c9d. Sind alle deine Kontakte schon in Deskwoot, kannst du Kontakte ausschalten: Jede Konversation kommt trotzdem zu ihrem Kontakt, und einen, den Deskwoot noch nicht hat, bringt die Konversation mit.
Wie mache ich einen Import rückgängig?
Klick im Importverlauf neben dem Import auf Löschen und gib dein Passwort ein. Das löscht die Konversationen, Tickets und Kontakte, die er angelegt hat, zusammen mit den Dateien, die er für sie kopiert hat. Eine Konversation, in der seitdem jemand geschrieben hat, bleibt mit diesen neuen Nachrichten erhalten, ohne die importierten, und ein Kontakt, der noch eine Konversation hat, bleibt auch. Teams, Agenten, Labels, Felder, das Lyro-Wissen und andere Einstellungen bleiben. Das Löschen läuft nach einem Neustart weiter, und sobald es fertig ist, kannst du einen neuen Import starten. Solange ein anderer Import läuft, lässt sich ein Import nicht löschen. Hast du mehrmals aus Tidio importiert, lösche die Importe vom neuesten zum ältesten: Solange es einen neueren Import aus Tidio gibt, bittet Deskwoot dich, zuerst diesen zu löschen.
War diese Anleitung hilfreich?
Weiterlesen
- Grok Bot mit Deskwoot verbindenVerbinde Grok Bot als KI-Mitarbeiter: der Satz für seinen Chat, die Zustimmungsseite, die Fragen zur Einrichtung, das Wecken bei neuer Arbeit und wohin deine Daten gehen.Anleitung lesen
- Tarife und Preise: was jeder Deskwoot-Tarif enthältPreise, Limits und Funktionen der Tarife Hacker, Startup, Business und Enterprise, wie KI-Konversationen gezählt werden und was passiert, wenn die Testphase endet oder du deinen Tarif wechselst.Anleitung lesen
- Teams: Konversationen nach Abteilung, Sprache oder Können verteilenTeams bündeln Agenten, damit Konversationen bei den richtigen Leuten landen: wie Konversationen in ein Team kommen, wer im Team sie bekommt, die Ordner des Teams, was Mitglieder sehen und Berichte nach Team.Anleitung lesen
Fynn zu dieser Anleitung fragen
Kurze Antwort aus dieser Anleitung und dem restlichen Hilfecenter.