Import aus Gorgias
Auf dieser Seite
Hol deine Gorgias-Tickets, Kunden, Makros, Tags, Felder, Regeln und Ansichten mit deiner Gorgias-Subdomain, deiner E-Mail und einem API-Schlüssel zu Deskwoot. Der Import liest jedes Ticket mit allen Nachrichten und Dateien. Standardmäßig kommt alles mit, und du kannst auch weniger importieren. Er läuft im Hintergrund, läuft bei Updates von Deskwoot weiter und lässt sich gefahrlos erneut starten. In deinem Gorgias-Konto ändert sich nichts.
Was übernommen wird
- Tickets werden zu Konversationen mit jeder Nachricht, internen Notizen (als private Notizen), Anhängen, Status, Priorität, Team, Agent, Tags und den Werten deiner Ticketfelder. Jedes behält seine ursprünglichen Daten und den Kanal, über den es kam (E-Mail, Chat, Telefon und so weiter). Eine E-Mail kommt so, wie Gorgias sie zum Lesen aufbewahrt: ohne Signatur und ohne die früheren Antworten, die sie zitiert. Nachrichten, die eine Gorgias-Regel oder ein Bot geschickt hat, erscheinen als Nachrichten deines Teams, ohne Agent.
- Deskwoot-Tickets: Nutzt dein Workspace Tickets (sie gehören zum Enterprise-Plan und zur kostenlosen Testphase, und ein Admin kann sie unter Einstellungen > Tickets ausschalten), wird jedes Gorgias-Ticket zusätzlich zu einem Deskwoot-Ticket neben seiner Konversation. Das Ticket übernimmt Status, Priorität, Betreff, Team, Agent und Labels und hält ab dann die Arbeit. Seine Konversation wird als Übergabe erledigt und zeigt eine private Karte, die das Ticket als aus Gorgias importiert nennt. Ohne Tickets behält die Konversation den Gorgias-Status.
- Tags werden zu Labels mit ihrer Farbe und Beschreibung. Gelöschte Tags bleiben draußen.
- Zufriedenheitsbewertungen werden zu CSAT-Bewertungen mit Punktzahl und Kommentar an der passenden Konversation. Umfragen, die der Kunde nie beantwortet hat, bleiben draußen.
- Kunden werden zu Kontakten mit jeder E-Mail-Adresse und Telefonnummer (auch WhatsApp-Nummern), ihrem X-Handle, Sprache, Zeitzone, Notiz (als Kontaktnotiz), den Werten deiner Kundenfelder und den zusätzlichen Daten, die in Gorgias zu ihnen gespeichert sind. Ihre anderen Kanäle, etwa Instagram oder Facebook, werden ebenfalls am Kontakt gespeichert.
- Teams kommen mit ihrer Beschreibung und mit den Mitgliedern, die schon in deinem Workspace sind. Benutzer (deine Gorgias-Agenten) werden per E-Mail deinen Teammitgliedern zugeordnet (siehe unten).
- Makros, die nicht archiviert sind, werden zu Textvorlagen mit ihrem Antworttext, ihren Bildern und Anhängen. Gorgias-Variablen, die Deskwoot auch kennt, werden zu denen von Deskwoot, zum Beispiel wird
{{ticket.customer.firstname}}zu{{contact.first_name}}. Das Kürzel entsteht aus dem Namen des Makros. Gibt es in Deskwoot schon eine Textvorlage mit demselben Kürzel, wird die importierte ausgelassen, und der Import im Importverlauf zeigt, wie viele das waren. Was ein Makro neben seiner Antwort tut (Tags setzen, Status oder Priorität ändern, einen Agenten oder ein Team zuweisen, eine interne Notiz anlegen), wird zu einem Deskwoot-Makro mit demselben Namen für dein ganzes Team. Ein Makro mit diesem Namen, das schon in Deskwoot ist, bleibt, wie es ist. - Ticketfelder und Kundenfelder werden zu benutzerdefinierten Attributen mit ihrem Typ und den Auswahlwerten eines Dropdowns. Archivierte Felder kommen auch mit, damit ihre alten Werte übernommen werden.
- Regeln, die in Gorgias aktiv sind, werden zu Automatisierungsregeln und kommen ausgeschaltet an. Gorgias schreibt eine Regel als Code, den Deskwoot nicht ausführt: Jede importierte Regel behält diesen Code und listet die Aktionen auf, die sie ausgeführt hat, damit du sie mit den Bedingungen und Aktionen von Deskwoot nachbauen kannst. So, wie sie ankommt, greift sie nie.
- Ticketansichten, die aktiv sind und die dein Team angelegt hat, werden zu gespeicherten Filtern des Admins, der den Import gestartet hat. Alles, wonach Deskwoot filtern kann, kommt mit (Status, Erinnerung, Agent, Team, Tags, Priorität, Feldwerte, Suchwörter und Sortierung). Der Rest wird ausgelassen, ein Filter kann also mehr Konversationen zeigen als die Ansicht, aber nie weniger. Eine Ansicht, deren Filter Deskwoot gar nicht lesen kann, etwa einer nur auf den KI-Feldern von Gorgias, wird ausgelassen, weil sie jede Konversation zeigen würde.
Dateien und Bilder
Der Import kopiert jede Datei, die bei Gorgias liegt, zu Deskwoot: die Anhänge und Bilder jeder Nachricht, die Bilder in deinen Makros und die Dateien, die deine Makros anhängen. Die Textvorlagen bieten sie als Dateien an, die der Kunde öffnen kann. Nichts bleibt ein Link zu Gorgias, deine Dateien funktionieren also weiter, auch wenn du Gorgias verlässt. Wenn dein Workspace den Virenscan gebucht hat, wird jede Datei geprüft, bevor sie gespeichert wird.
- Lässt sich eine Datei gerade nicht kopieren (Gorgias 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 an der Quelle nicht mehr verfügbar.
- Bilder, die eine Nachricht oder ein Makro von einer anderen Website lädt, etwa von deiner eigenen, bleiben, wie sie sind.
Was nicht übernommen wird
- Dein Gorgias-Hilfecenter. Gorgias hat dafür keine API, und seine eigene Hilfe sagt, dass sich Artikel nicht exportieren lassen.
- Organisationen, weil Gorgias keine Unternehmen kennt, und Profilbilder, weil Gorgias-Kunden keine haben. Deine Teammitglieder behalten ihr Deskwoot-Profil.
- Archivierte Makros und die Teile eines Makros, für die ein Deskwoot-Makro keine Aktion hat: ein Ticketfeld setzen, HTTP-Aktionen und Shop-Aktionen.
- Regeln und Ansichten, die ausgeschaltet sind, die eigenen Systemansichten von Gorgias (die eingebauten Ordner des Posteingangs von Deskwoot decken sie ab) und Kundenansichten.
- Die KI-Felder von Gorgias und die Vermutungen seiner KI zu Nachrichten (Intents). Der Kontaktgrund kommt als Feldwert mit.
- Die Shopdaten eines Kunden aus Shopify und anderen Apps. Die eigenen Integrationen von Deskwoot lesen sie direkt aus deinem Shop.
- Der Ereignisverlauf eines Tickets. Gorgias gibt ihn nur für ein Ticket auf einmal heraus und nur für die letzten 12 Monate.
- Gesprächsaufnahmen und Anrufdetails. Ein Telefonticket kommt mit seinen Nachrichten.
- CC und BCC von E-Mails.
- Tickets im Spam oder im Papierkorb und gelöschte Nachrichten. Ein Ticket, das Gorgias mit einem anderen zusammengeführt hat, ist schon Teil davon.
- Dass Gorgias eine Antwort nicht senden konnte: Eine solche Antwort kommt als gesendet an.
Was intern bleibt
Deskwoot hält privat, was in Gorgias nur dein Team gesehen hat:
- Interne Notizen kommen als private Notizen an, und die Notiz zu einem Kunden wird zu einer Kontaktnotiz. Nur dein Team sieht sie.
- Die Karte in einer Konversation, die ihr Deskwoot-Ticket nennt, ist ebenfalls privat.
- Gespeicherte Filter aus Gorgias-Ansichten gehören dem Admin, der den Import gestartet hat.
Bevor du startest
- Öffne in Gorgias als Admin Settings > REST API. Klick auf Create API Key oder kopiere den Schlüssel, der schon da ist. Dieselbe Seite zeigt deinen Username, das ist deine E-Mail. Nur ein Admin oder der Kontoinhaber kann einen Schlüssel anlegen, und ein Schlüssel liest mit den Rechten der Person, die ihn angelegt hat. Nimm also den Schlüssel eines Admins, dann kann der Import jeden Teil deines Helpdesks lesen.
- Notier dir deine Gorgias-Subdomain:
deine-firmaausdeine-firma.gorgias.com. - Gorgias bietet seine REST API in allen seinen Helpdesk-Tarifen an. Für den Import brauchst du also keinen bestimmten Gorgias-Tarif.
- Lade deine Teammitglieder mit derselben E-Mail zu Deskwoot ein, die sie in Gorgias 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? Gorgias.
- Gib die Subdomain, die E-Mail (den Username, den Gorgias bei deinem Schlüssel zeigt) und den API-Schlüssel ein.
- Wähl unter Was soll mitkommen?, was übernommen wird. Standardmäßig ist alles an. Willst du nur neuere Tickets, wähl einen Tag unter Nur Tickets, die ab diesem Tag erstellt wurden.
- Wähl unter In welchen Posteingang sollen die Tickets? für jede Art von Ticket einen Posteingang (E-Mail, Chat, Webformulare und Hilfecenter, Telefon, WhatsApp, SMS, Alles andere) oder lass Kein Posteingang stehen. Angeboten werden nur Posteingänge für E-Mail, Telegram, WhatsApp und SMS. Bei deinem ersten Gorgias-Import ist ein Posteingang für E-Mail, WhatsApp oder SMS schon ausgewählt, wenn er der einzige seiner Art in deinem Workspace ist.
- Klick auf Import starten. Deskwoot prüft zuerst Subdomain, E-Mail und Schlüssel bei Gorgias. Lehnt Gorgias 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 Gorgias-Konto erlaubt und wie viele davon der Import höchstens nutzt.
- Gorgias erlaubt einem API-Schlüssel 40 Aufrufe alle 20 Sekunden (alle 10 Sekunden im Enterprise-Tarif). 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 Gorgias nicht mehr antwortet, 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. Nimmt Gorgias den Schlüssel nicht mehr an, etwa weil ihn jemand gelöscht hat, stoppt der Lauf: Starte einen neuen Import mit einem gültigen Schlüssel, er überspringt, was schon in Deskwoot ist.
Tickets und Antworten deiner Agenten
Ein Ticket, das einem Gorgias-Agenten zugewiesen war, geht an das Teammitglied mit derselben E-Mail, und seine Antworten zeigen es als Absender. Sind Tickets eingeschaltet, geht auch das Deskwoot-Ticket an dieses Teammitglied. Hat diese Person noch kein Deskwoot-Konto, kommt das Ticket ohne Zuweisung an und ihre Antworten zeigen ihren Namen mit (importiert).
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
- Gorgias merkt sich den Kanal jedes Tickets. Der Import legt jedes Ticket in den Posteingang, den du für seine Art gewählt hast, damit dein Team dort antworten kann. Chat ist der Livechat auf deiner Website und in deiner App, Webformulare und Hilfecenter umfasst Kontaktformulare und dein Gorgias-Hilfecenter, Telefon umfasst Anrufe und Sprachnachrichten, und Alles andere umfasst Facebook, Instagram, X, über die API angelegte Tickets und jeden anderen Kanal.
- Ein Ticket 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 Tickets kommen ohne Posteingang.
- Sind Tickets eingeschaltet, bekommt die Konversation den Posteingang, und eine Antwort aus dem Deskwoot-Ticket erreicht den Kunden darüber (siehe Dem Kunden aus einem Ticket antworten).
- Startest du den Import erneut, kommen auch Tickets, die du früher aus diesem Gorgias-Konto importiert hast, in die gewählten Posteingänge, wenn sie noch keinen haben. Ein Ticket, das schon einen Posteingang hat oder in dem jemand aus deinem Team geschrieben hat, bleibt, wo es ist. Der nächste Import startet mit den Posteingängen des letzten.
- Jeder Import im Importverlauf zeigt die gewählten Posteingänge und wie viele Tickets in einen Posteingang gekommen sind.
Nach dem Import
- Ein Ticket ohne Posteingang (weil du für seine Art keinen gewählt hast oder Deskwoot den Kunden dort nicht erreicht) braucht einen, bevor du antwortest: Öffne es und wähl im Hinweis Diese Konversation hat keinen Posteingang einen Posteingang. Bei einem Posteingang für E-Mail, WhatsApp oder SMS kannst du auch beim Kontakt die fehlende E-Mail-Adresse oder Telefonnummer ergänzen und den Import erneut starten.
- Bau die Regeln nach, die du brauchst. Öffne den Import im Importverlauf: Unter Noch zu tun führt dich Regeln prüfen und einschalten zu ihnen. Gib jeder Regel Bedingungen und Aktionen von Deskwoot und schalte sie dann ein.
- Prüf die gespeicherten Filter und die Makros: Eine Gorgias-Ansicht kann nach mehr filtern, als Deskwoot liest, und eine Makro-Aktion ohne Gegenstück in Deskwoot wurde ausgelassen.
Häufige Fragen
Kann ich den Import erneut starten?
Ja, das ist sicher. Ein neuer Lauf findet, was schon in Deskwoot ist, und überspringt es. Tickets, Kontakte, Labels und Textvorlagen 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, das sich in Gorgias seitdem geändert hat, bekommt seine neuen Nachrichten, und solange niemand aus deinem Team in Deskwoot daran gearbeitet hat, übernimmt es auch den neuen Status, Betreff, Priorität, Team und Agent (bei seinem Deskwoot-Ticket, wenn es eins hat). Ein Kontakt, den der Import angelegt hat, bekommt, was ihm noch fehlt, und nichts, was dein Team eingetragen hat, wird überschrieben.
Textvorlagen und Makros, die dein Team in Deskwoot geändert hat, bleiben, wie du sie gelassen hast. Eine Regel, die du nachgebaut hast, bleibt auch, aber der neue Lauf findet das Original nicht mehr und holt die Gorgias-Fassung erneut, ausgeschaltet: Lösch diese Kopie, wenn du sie nicht brauchst.
Denk daran: Konversationen, Kontakte und Notizen, die du seit dem letzten Import in Deskwoot gelöscht oder entfernt hast, kommen zurück, wenn Gorgias sie noch hat. Das gilt auch für zusammengeführte Kontakte.
Der Import endete mit „Teilweise importiert“. Was nun?
Gorgias hat bei einem oder mehreren Schritten nicht mehr geantwortet, zum Beispiel weil sein API-Limit lange ausgeschöpft war. Alles bisher Gelesene ist in Deskwoot. Starte den Import erneut: Er überspringt, was da ist, und macht weiter.
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 Gorgias-ID, dann über die E-Mail-Adresse, egal ob groß oder klein geschrieben. Die Tickets 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 Gorgias-ID, wenn du ihn über die API anlegst oder änderst, im Feld externalId: gorgias:, deine Gorgias-Subdomain in Kleinbuchstaben, ein Doppelpunkt und die ID des Kunden in Gorgias, zum Beispiel gorgias:acme:4711 für den Kunden 4711 bei acme.gorgias.com. Sind alle deine Kontakte schon in Deskwoot, kannst du Kontakte ausschalten: Jedes Ticket kommt trotzdem zu seinem Kontakt, und einen, den Deskwoot noch nicht hat, bringt das Ticket mit.
Kann ich nur einen Teil meiner Daten importieren?
Ja. Unter Was soll mitkommen? ist standardmäßig alles an, und du kannst Tickets, Kontakte, Textvorlagen (deine Makros, mit den Deskwoot-Makros daraus) und Zufriedenheitsbewertungen ausschalten. Wählst du unter Nur Tickets, die ab diesem Tag erstellt wurden einen Tag, kommen nur Tickets, die an diesem Tag oder später erstellt wurden. Bewertungen kommen nur mit den Tickets, die sie bewerten, deshalb ist diese Option ohne die Tickets ausgegraut. Teams, Agenten, Tags, Felder, Regeln und Ansichten kommen immer mit. Lässt du die Kontakte weg, bringt jedes importierte Ticket trotzdem seinen eigenen Kontakt mit.
Jeder Import im Importverlauf zeigt unter 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.
Wie mache ich einen Import rückgängig?
Klick im Importverlauf neben dem Import auf Löschen, bestätige und gib dein Passwort ein. Das löscht die Konversationen, Deskwoot-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, Textvorlagen, Makros, Labels, benutzerdefinierte Attribute, Automatisierungsregeln, gespeicherte Filter 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 Gorgias importiert, lösche die Importe vom neuesten zum ältesten: Solange es einen neueren Import aus Gorgias gibt, bittet Deskwoot dich, zuerst diesen zu löschen.
Speichert Deskwoot meinen API-Schlüssel?
Nur solange der Import läuft, verschlüsselt, damit er nach einem Neustart weitermachen kann. Wenn der Import endet, wird er gelöscht.
War diese Anleitung hilfreich?
Weiterlesen
- KI-Mitarbeiter: So arbeiten KI-Agenten in deinem TeamVerbinde Claude, ChatGPT, Grok Bot oder Cursor als KI-Mitarbeiter: Rollen, was sie lesen, Autonomie und zurückgehaltene Themen, Freigaben, Pausieren, Stoppen und Abrechnung.Anleitung lesen
- 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
Fynn zu dieser Anleitung fragen
Kurze Antwort aus dieser Anleitung und dem restlichen Hilfecenter.