Gorgias Connector

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

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/

# Basic Auth: email as username, API key as password
curl -X GET "https://yourstore.gorgias.com/api/customers" \
  -u "[email protected]:$GORGIAS_API_KEY" \
  -H "Content-Type: application/json"

Verbindung zu Tajo herstellen

tajo connectors install gorgias \
  --domain yourstore.gorgias.com \
  --email [email protected] \
  --api-key $GORGIAS_API_KEY

Konfiguration

Grundeinrichtung

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:

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

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:

Code-Beispiele

Connector initialisieren

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: '[email protected]',
  apiKey: process.env.GORGIAS_API_KEY
});

Kund:innen mit Brevo synchronisieren

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

// 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

// 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

// 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:

Gorgias gibt 429 Too Many Requests zurück, wenn die Rate Limits überschritten werden.

Fehlerbehebung

Häufige Probleme

Debug-Modus

connectors:
  gorgias:
    debug: true
    log_level: verbose
    log_api_calls: true

Verbindung testen

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
• Jira Connector
• Shopify Connector
• Brevo Contacts API