--- title: "Gorgias Connector" description: "Vollständiger Leitfaden zur Gorgias-Integration zum Synchronisieren von Helpdesk-Tickets, Kund:innendaten und Support-Events mit Brevo über Tajo." url: https://tajo.io/de/docs/connectors/support/gorgias/ markdown: https://tajo.io/de/docs/connectors/support/gorgias.md lang: de-DE robots: noindex --- Beantrage frühzeitigen Zugang Gib deinen Vornamen und deine geschäftliche E-Mail-Adresse ein. Wir senden dir einen Link, mit dem du deine Anfrage für den Tajo-Zugang bestätigst. # Gorgias Connector Connector-Status: Geplant Noch nicht gebaut. Tajo betreibt diesen Connector heute nicht. | Quellfeld | Zielfeld | Beispielwert | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Verbinde deinen Gorgias-Helpdesk über Tajo mit Brevo für support-getriebenes Kund:innen-Engagement, Marketing-Flows nach Ticket-Abschluss und eine einheitliche Customer-Experience-Analyse. ## Überblick | Eigenschaft | Wert | | --- | --- | | **Plattform** | Gorgias | | **Kategorie** | Support | | **Einrichtungsaufwand** | Einfach | | **Offizielle Integration** | Nein | | **Synchronisierte Daten** | Kund:innen, Tickets, Events | | **API-Typ** | REST API | | **Authentifizierung** | API-Schlüssel + E-Mail (Basic Auth) | | **Basis-URL** | `https://{domain}.gorgias.com/api/` | ## Funktionen - **Ticket-Event-Synchronisierung** - Leite Events zur Ticket-Erstellung, -Lösung und CSAT-Events an Brevo-Timelines weiter - **Anreicherung von Kund:innen-Profilen** - Synchronisiere Gorgias-Kund:innendaten inklusive Tags und benutzerdefinierter Felder mit Brevo - **Post-Support-Kampagnen** - Löse Brevo-Workflows nach Ticket-Lösung für Follow-up oder Upsell aus - **Zufriedenheitsbewertung** - Synchronisiere CSAT-Umfrageergebnisse als Brevo-Kontaktattribute - **Tag-basierte Segmentierung** - Spiegle Gorgias-Kund:innen-Tags als Brevo-Listenmitgliedschaften - **Macro- und Rule-Events** - Verfolge automatisierte Aktionen für operative Analysen ## Voraussetzungen Bevor du beginnst, stelle sicher, dass du Folgendes hast: 1. Ein Gorgias-Konto mit Admin-Zugriff 2. Deine Gorgias-Subdomain (z. B. `yourstore.gorgias.com`) 3. Einen API-Schlüssel und die zugehörige E-Mail-Adresse 4. Ein Brevo-Konto mit API-Zugriff 5. Ein Tajo-Konto mit aktivem Abonnement ## Authentifizierung Gorgias nutzt HTTP Basic Authentication mit deiner Konto-E-Mail und dem API-Schlüssel. ### API-Schlüssel erstellen 1. Melde dich im Gorgias-Dashboard an 2. Navigiere zu **Settings** > **REST API** 3. Klicke auf **Create API Key** (oder kopiere den bestehenden Schlüssel) 4. Notiere deine API-Basis-URL: `https://{domain}.gorgias.com/api/` ```bash # Basic Auth: email as username, API key as password curl -X GET "https://yourstore.gorgias.com/api/customers" \ -u "admin@yourstore.com:$GORGIAS_API_KEY" \ -H "Content-Type: application/json" ``` Berechtigungen des API-Schlüssels Gorgias-API-Schlüssel haben vollen Zugriff auf deine Kontodaten. Es gibt kein scope-basiertes Berechtigungsmodell. Schütze deinen API-Schlüssel und rotiere ihn regelmäßig. ### Verbindung zu Tajo herstellen ```bash tajo connectors install gorgias \ --domain yourstore.gorgias.com \ --email admin@yourstore.com \ --api-key $GORGIAS_API_KEY ``` ## Konfiguration ### Grundeinrichtung ```yaml connectors: gorgias: enabled: true domain: "yourstore.gorgias.com" sync: customers: true tickets: true satisfaction_surveys: true tags: true lists: all_support_contacts: 35 satisfied_customers: 36 dissatisfied_customers: 37 ``` ### Feldzuordnung Ordne Gorgias-Kund:innen- und Ticket-Felder den Brevo-Kontaktattributen zu: ```yaml field_mapping: # Customer fields id: GORGIAS_ID email: email name: FIRSTNAME phone: SMS # Support metrics nb_tickets: TICKET_COUNT last_ticket_date: LAST_SUPPORT_DATE last_ticket_channel: LAST_SUPPORT_CHANNEL avg_response_time: AVG_RESPONSE_TIME # CSAT data last_satisfaction_score: CSAT_SCORE satisfaction_count: CSAT_RESPONSES # Custom fields customer_type: CUSTOMER_TYPE vip_status: VIP_STATUS ``` ### Event-Zuordnung ```yaml event_mapping: ticket.created: SUPPORT_TICKET_OPENED ticket.closed: SUPPORT_TICKET_RESOLVED ticket.reopened: SUPPORT_TICKET_REOPENED satisfaction_survey.created: CSAT_SURVEY_SENT satisfaction_survey.responded: CSAT_SUBMITTED customer.created: SUPPORT_CUSTOMER_CREATED ``` ## API-Endpoints Tajo integriert sich mit den folgenden Gorgias-REST-API-Endpoints: | Endpoint | Methode | Zweck | | --- | --- | --- | | `/api/customers` | GET | Kund:innen auflisten | | `/api/customers/{id}` | GET | Kund:in abrufen | | `/api/customers` | POST | Kund:in erstellen | | `/api/customers/{id}` | PUT | Kund:in aktualisieren | | `/api/tickets` | GET | Tickets auflisten | | `/api/tickets/{id}` | GET | Ticket abrufen | | `/api/tickets/{id}/messages` | GET | Ticket-Nachrichten auflisten | | `/api/tags` | GET | Tags auflisten | | `/api/satisfaction-surveys` | GET | CSAT-Umfragen auflisten | | `/api/satisfaction-surveys/{id}` | GET | Umfrage abrufen | | `/api/users` | GET | Agent:innen auflisten | | `/api/integrations` | GET | Integrationen auflisten | | `/api/events` | GET | Events auflisten | | `/api/customers/{id}/custom-fields` | GET | Werte benutzerdefinierter Felder abrufen | ## Code-Beispiele ### Connector initialisieren ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); await tajo.connectors.connect('gorgias', { domain: 'yourstore.gorgias.com', email: 'admin@yourstore.com', apiKey: process.env.GORGIAS_API_KEY }); ``` ### Kund:innen mit Brevo synchronisieren ```javascript await tajo.connectors.sync('gorgias', { type: 'incremental', resources: ['customers'], since: '2024-01-01', batchSize: 30 }); const status = await tajo.connectors.status('gorgias'); console.log(status); // { // connected: true, // lastSync: '2024-03-15T17:00:00Z', // customersCount: 14200, // ticketsTracked: 28600, // csatResponses: 3400 // } ``` ### Ticket-Events über HTTP-Integration verarbeiten ```javascript // Gorgias can send HTTP requests via Rules or HTTP integrations app.post('/webhooks/gorgias', async (req, res) => { const event = req.body; await tajo.connectors.handleEvent('gorgias', { type: 'ticket.updated', payload: { ticketId: event.ticket_id, status: event.status, customerEmail: event.customer?.email, channel: event.channel, tags: event.tags, satisfaction: event.satisfaction } }); res.status(200).send('OK'); }); ``` ### Kampagne nach Ticket-Lösung ```javascript // Trigger a follow-up email after a support ticket is resolved tajo.connectors.on('gorgias', 'ticket.closed', async (event) => { if (event.satisfaction_score >= 4) { await tajo.campaigns.trigger('post-support-upsell', { email: event.customer.email, params: { agent_name: event.assignee.name, ticket_subject: event.subject, resolution_time: event.resolution_time } }); } }); ``` ### CSAT-Daten synchronisieren ```javascript // Sync satisfaction survey results to Brevo attributes await tajo.connectors.sync('gorgias', { type: 'incremental', resources: ['satisfaction_surveys'], since: '2024-01-01' }); ``` ## Rate Limits Gorgias setzt Rate Limits pro Konto durch: | Limit-Typ | Wert | | --- | --- | | **API Rate Limit** | 2 Anfragen pro Sekunde | | **Burst-Spielraum** | Bis zu 5 Anfragen in kurzen Bursts | | **Pagination** | 30 Einträge pro Seite (Standard), max. 100 | Paginierungsstrategie Gorgias verwendet cursor-basierte Pagination mit den Parametern `cursor` und `limit`. Tajo übernimmt dies automatisch und fordert bis zu 100 Einträge pro Seite für maximale Effizienz an. Gorgias gibt `429 Too Many Requests` zurück, wenn die Rate Limits überschritten werden. ## Fehlerbehebung ### Häufige Probleme | Problem | Ursache | Lösung | | --- | --- | --- | | 401 Unauthorized | Ungültige E-Mail oder ungültiger API-Schlüssel | Anmeldedaten in Gorgias Settings > REST API überprüfen | | 404 Not Found | Ungültiger Endpoint oder Ressourcen-ID | Prüfen, ob die API-Basis-URL deine Subdomain enthält | | Kund:innen fehlen | Keine E-Mail hinterlegt | Gorgias benötigt eine E-Mail zur Zuordnung von Kund:innen | | Tags werden nicht synchronisiert | Tags sind nicht Kund:innen zugewiesen | Prüfe, ob Tags am Kund:innen-Objekt und nicht nur am Ticket hängen | | Langsamer Sync | Niedriges Rate Limit | Gorgias begrenzt auf 2 req/s; vollständige Syncs dauern länger | ### Debug-Modus ```yaml connectors: gorgias: debug: true log_level: verbose log_api_calls: true ``` ### Verbindung testen ```bash tajo connectors test gorgias # ✓ API authentication successful # ✓ Customer list accessible # ✓ Ticket data readable # ✓ CSAT surveys available # ✓ Tags listable ``` ## Best Practices 1. **Nutze HTTP-Integrationen für Echtzeit** - Konfiguriere Gorgias-Rules, um bei Ticket-Events HTTP-Anfragen an Tajo zu senden 2. **Synchronisiere CSAT-Daten regelmäßig** - Nutze Zufriedenheitswerte, um Re-Engagement-Kampagnen zu steuern 3. **Ordne Tags Segmenten zu** - Übersetze Gorgias-Kund:innen-Tags in Brevo-Listenmitgliedschaften 4. **Paginierung sorgfältig handhaben** - Bei 2 req/s musst du bei großen Datenmengen längere Sync-Zeiten einplanen 5. **Mit E-Commerce-Daten verknüpfen** - Kombiniere Gorgias-Supportdaten mit Shopify-Bestelldaten in Brevo 6. **API-Schlüssel rotieren** - Da Gorgias-Schlüssel vollen Zugriff haben, rotiere sie regelmäßig ## Sicherheit - **Basic Auth** - E-Mail und API-Schlüssel über HTTPS - **Nur HTTPS** - Die gesamte API-Kommunikation ist per TLS 1.2+ verschlüsselt - **Vollzugriffsschlüssel** - Kein granulares Scoping (Schlüssel sorgfältig schützen) - **IP-Allowlisting** - In höheren Gorgias-Plänen verfügbar - **Verschlüsselte Speicherung** - API-Anmeldedaten werden in Tajo im Ruhezustand verschlüsselt - **SOC-2-Konformität** - Die Gorgias-Plattform ist SOC 2 Type II zertifiziert ## Verwandte Ressourcen - [Twilio Flex Connector](https://tajo.io/de/docs/connectors/custom/twilio-flex) - [Jira Connector](https://tajo.io/de/docs/connectors/custom/jira) - [Shopify Connector](https://tajo.io/de/docs/connectors/ecommerce/shopify) - [Brevo Contacts API](https://tajo.io/de/docs/contact-management)