ComposioHQ/Gorgias-Automation

Gorgias Automation

Automatisieren Sie Ihren Gorgias-Helpdesk direkt über Claude Code. Erstellen, aktualisieren und priorisieren Sie Support-Tickets, verwalten Sie Kunden und organisieren Sie Ihr Support-Team – alles ohne die Befehlszeile zu verlassen.

Toolkit-Dokumentation: composio.dev/toolkits/gorgias

---

Einrichtung

1. Fügen Sie den Rube MCP-Server zu Ihrer Claude Code-Konfiguration hinzu, mit URL: https://rube.app/mcp
2. Authentifizieren Sie Ihr Gorgias-Konto über den bereitgestellten Verbindungslink, wenn Sie dazu aufgefordert werden
3. Beginnen Sie, Ihre Support-Workflows mit natürlicher Sprache zu automatisieren

---

Kern-Workflows

1. Tickets auflisten und filtern

Rufen Sie Tickets mit Filtern nach Status, Kanal, Bearbeiter, Datumsbereich und mehr ab.

Tool: GORGIAS_LIST_TICKETS

Liste alle offenen Tickets vom E-Mail-Kanal auf, die in den letzten 7 Tagen erstellt wurden

Wichtige Parameter:

• status – Filter nach Ticketstatus (z. B. "open", "closed")
• channel – Filter nach Kanal (z. B. "email", "chat")
• assignee_user_id / assignee_team_id – Filter nach zugewiesenem Agenten oder Team
• created_from / created_to – ISO-Datumsbereichsfilter
• limit (max. 100) / offset – Paginierungssteuerung
• order_by / order_dir – Sortieroptionen

2. Tickets erstellen und aktualisieren

Erstellen Sie neue Tickets oder aktualisieren Sie bestehende mit Zuweisung, Priorität und Statusänderungen.

Tools: GORGIAS_CREATE_TICKET, GORGIAS_UPDATE_TICKET, GORGIAS_GET_TICKET

Erstelle ein Ticket mit hoher Priorität für Kunde 12345 wegen einer fehlenden Bestellung mit Betreff "Bestellung #9876 nicht zugestellt"

• GORGIAS_CREATE_TICKET erfordert customer_id; akzeptiert subject, status, priority, channel, messages, tags
• GORGIAS_UPDATE_TICKET erfordert ticket_id; alle anderen Felder sind optionale Teilaktualisierungen
• GORGIAS_GET_TICKET ruft vollständige Ticketdetails anhand der ticket_id ab

3. Ticket-Tags verwalten

Fügen Sie Tickets Tags zur Kategorisierung, Weiterleitung und Berichterstellung hinzu.

Tools: GORGIAS_ADD_TICKET_TAGS, GORGIAS_LIST_TICKET_TAGS

Füge die Tags 101 und 202 zu Ticket 5678 hinzu und zeige mir dann alle Tags auf diesem Ticket

• GORGIAS_ADD_TICKET_TAGS erfordert ticket_id und tag_ids (Array von Ganzzahlen)
• GORGIAS_LIST_TICKET_TAGS erfordert ticket_id, um aktuelle Tags abzurufen

4. Kundenverwaltung

Erstellen Sie neue Kunden oder führen Sie doppelte Kundendatensätze zusammen.

Tools: GORGIAS_CREATE_CUSTOMER, GORGIAS_MERGE_CUSTOMERS, GORGIAS_LIST_CUSTOMERS

Erstelle einen neuen Kunden namens "Max Mustermann" mit E-Mail [email protected] und Telefon-Kanal

• GORGIAS_CREATE_CUSTOMER erfordert name; akzeptiert email, channels (Array mit type und value), external_id, address, data
• GORGIAS_MERGE_CUSTOMERS erfordert source_customer_id und target_customer_id – die Quelle wird in das Ziel zusammengeführt
• GORGIAS_LIST_CUSTOMERS ruft Kunden mit Filteroptionen ab

5. Team- und Kontooperationen

Listen Sie Teams auf, rufen Sie Kontoinformationen ab und überprüfen Sie benutzerdefinierte Ticketfelder.

Tools: GORGIAS_LIST_TEAMS, GORGIAS_GET_TEAM, GORGIAS_GET_ACCOUNT, GORGIAS_LIST_TICKET_FIELD_VALUES

Zeige mir alle Support-Teams in unserem Gorgias-Konto an

• GORGIAS_GET_ACCOUNT gibt Kontometriken und Konfiguration auf Kontoebene zurück
• GORGIAS_LIST_TEAMS / GORGIAS_GET_TEAM verwalten die Teamsuche
• GORGIAS_LIST_TICKET_FIELD_VALUES gibt benutzerdefinierte Feldwerte für ein bestimmtes Ticket zurück

6. Aktivitäts- und Ereignisverfolgung

Überwachen Sie Ticketaktivitäten und den Kundenereignisverlauf.

Tools: GORGIAS_LIST_EVENTS

Liste die letzten Ereignisse auf, um zu sehen, welche Aktivitäten in unserer Support-Warteschlange stattgefunden haben

• GORGIAS_LIST_EVENTS bietet eine Aktivitätszeitleiste mit Filteroptionen

---

Bekannte Fallstricke

• Paginierung erforderlich: GORGIAS_LIST_TICKETS verwendet limit/offset-Paginierung. Das Fehlen einer Schleife durch die Seiten führt dazu, dass ältere Tickets übersehen werden und unvollständige Daten entstehen.
• Filterspezifität: Fehlende oder zu breite Filter bei GORGIAS_LIST_TICKETS können den Export überlasten oder das gewünschte Berichtszeitfenster auslassen. Setzen Sie immer created_from/created_to für zeitgebundene Abfragen.
• Benutzerdefinierte Felder sind separat: Wichtige Geschäfts-KPIs können nur in benutzerdefinierten Feldern existieren. Sie müssen GORGIAS_LIST_TICKET_FIELD_VALUES explizit abfragen, um sie einzuschließen.
• Ratenbegrenzungen: Hochvolumige Exporte über GORGIAS_LIST_TICKETS und verwandte Endpunkte können auf Gorgias-Ratenbegrenzungen stoßen. Fügen Sie Backoff hinzu und setzen Sie ab dem letzten Offset fort.
• Authentifizierungsfehler: 401/403-Antworten bei jedem Gorgias-Tool deuten auf Token- oder Berechtigungsprobleme hin. Behandeln Sie Teil Daten nicht als vollständigen Datensatz.

---

Kurzreferenz

Tool Slug	Beschreibung
GORGIAS_LIST_TICKETS	Tickets mit Filtern auflisten (Status, Kanal, Datum, Bearbeiter)
GORGIAS_GET_TICKET	Ein bestimmtes Ticket anhand der ID abrufen
GORGIAS_CREATE_TICKET	Ein neues Ticket erstellen (erfordert customer_id)
GORGIAS_UPDATE_TICKET	Ticketfelder aktualisieren (erfordert ticket_id)
GORGIAS_ADD_TICKET_TAGS	Tags zu einem Ticket hinzufügen
GORGIAS_LIST_TICKET_TAGS	Alle Tags auf einem Ticket auflisten
GORGIAS_LIST_TICKET_FIELD_VALUES	Benutzerdefinierte Feldwerte für ein Ticket auflisten
GORGIAS_CREATE_CUSTOMER	Einen neuen Kunden erstellen (erfordert name)
GORGIAS_MERGE_CUSTOMERS	Zwei Kundendatensätze zusammenführen
GORGIAS_LIST_CUSTOMERS	Kunden mit Filtern auflisten
GORGIAS_LIST_TEAMS	Alle Teams auflisten
GORGIAS_GET_TEAM	Ein bestimmtes Team abrufen
GORGIAS_GET_ACCOUNT	Kontoinformationen abrufen
GORGIAS_LIST_EVENTS	Aktivitätsereignisse mit Filtern auflisten

---

Powered by Composio