Gorgias-kobling

Koble Gorgias-helpdesken din til Brevo for supportdrevet kundeengasjement, markedsføringsflyter etter saker og enhetlig kundeopplevelsesanalyse gjennom Tajo.

Oversikt

Funksjoner

• Synkronisering av sakshendelser - Videresend hendelser for saksopprettelse, løsning og CSAT til Brevo-tidslinjer
• Berikelse av kundeprofiler - Synkroniser Gorgias-kundedata, inkludert tagger og egendefinerte felt, til Brevo
• Kampanjer etter support - Utløs Brevo-arbeidsflyter etter saksløsning for oppfølging eller mersalg
• Tilfredshetssporing - Synkroniser CSAT-undersøkelsesresultater som Brevo-kontaktattributter
• Tag-basert segmentering - Speil Gorgias-kundetagger som Brevo-listemedlemskap
• Makro- og regel-hendelser - Spor automatiserte handlinger for operasjonell analyse

Forutsetninger

Før du begynner, sørg for at du har:

1. En Gorgias-konto med administratortilgang
2. Ditt Gorgias-subdomene (f.eks. yourstore.gorgias.com)
3. En API-nøkkel og tilhørende e-postadresse
4. En Brevo-konto med API-tilgang
5. En Tajo-konto med aktivt abonnement

Autentisering

Gorgias bruker HTTP Basic Authentication med kontoens e-post og API-nøkkel.

Opprette en API-nøkkel

1. Logg inn på Gorgias-dashbordet ditt
2. Gå til Settings > REST API
3. Klikk Create API Key (eller kopier eksisterende nøkkel)
4. Noter API-basis-URL: https://{domain}.gorgias.com/api/

# Basic Auth: e-post som brukernavn, API-nøkkel som passord
curl -X GET "https://yourstore.gorgias.com/api/customers" \
  -u "[email protected]:$GORGIAS_API_KEY" \
  -H "Content-Type: application/json"

Koble til Tajo

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

Konfigurasjon

Grunnleggende oppsett

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

Feltmapping

Mapp Gorgias-kunde- og saksfelt til Brevo-kontaktattributter:

field_mapping:
  # Kundefelt
  id: GORGIAS_ID
  email: email
  name: FIRSTNAME
  phone: SMS

  # Supportmålinger
  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

  # Egendefinerte felt
  customer_type: CUSTOMER_TYPE
  vip_status: VIP_STATUS

Hendelsesmapping

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

Tajo integrerer med følgende Gorgias REST API-endepunkter:

Kodeeksempler

Initialiser kobling

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
});

Synkroniser kunder til Brevo

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

Håndter sakshendelser via HTTP-integrasjon

// Gorgias kan sende HTTP-forespørsler via Rules eller HTTP-integrasjoner
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');
});

Kampanje etter løsning

// Utløs en oppfølgings-e-post etter at en supportsak er løst
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
      }
    });
  }
});

Synkroniser CSAT-data

// Synkroniser tilfredshetsundersøkelsesresultater til Brevo-attributter
await tajo.connectors.sync('gorgias', {
  type: 'incremental',
  resources: ['satisfaction_surveys'],
  since: '2024-01-01'
});

Ratebegrensninger

Gorgias håndhever ratebegrensninger per konto:

Gorgias returnerer 429 Too Many Requests når ratebegrensninger overskrides.

Feilsøking

Vanlige problemer

Feilsøkingsmodus

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

Test tilkobling

tajo connectors test gorgias
# ✓ API-autentisering vellykket
# ✓ Kundeliste tilgjengelig
# ✓ Saksdata lesbare
# ✓ CSAT-undersøkelser tilgjengelige
# ✓ Tagger listbare

Beste praksis

1. Bruk HTTP-integrasjoner for sanntid - Konfigurer Gorgias Rules til å sende HTTP-forespørsler til Tajo ved sakshendelser
2. Synkroniser CSAT-data regelmessig - Bruk tilfredshetsscore for å drive re-engasjementskampanjer
3. Mapp tagger til segmenter - Oversett Gorgias-kundetagger til Brevo-listemedlemskap
4. Håndter paginering nøye - Med 2 forespørsler/s-grensen, planlegg for lengre synkroniseringstider på store datasett
5. Koble til e-handelsdata - Kombiner Gorgias-supportdata med Shopify-ordredata i Brevo
6. Roter API-nøkler - Siden Gorgias-nøkler har full tilgang, roter dem regelmessig

Sikkerhet

• Basic Auth - E-post og API-nøkkel over HTTPS
• Kun HTTPS - All API-kommunikasjon kryptert via TLS 1.2+
• Full Access-nøkler - Ingen granulær scoping (beskytt nøkler nøye)
• IP-hviteliste - Tilgjengelig på høyere Gorgias-planer
• Kryptert lagring - API-påloggingsdetaljer kryptert i hvilemodus i Tajo
• SOC 2-samsvar - Gorgias-plattformen er SOC 2 Type II-sertifisert

Relaterte ressurser

• Twilio Flex-kobling
• Jira-kobling
• Shopify-kobling
• Brevo Contacts API