---
title: "Gorgias-connector"
description: "Volledige Gorgias-integratiegids voor het synchroniseren van helpdesktickets, klantdata en support-events met Brevo via Tajo."
url: https://tajo.io/nl/docs/connectors/support/gorgias/
markdown: https://tajo.io/nl/docs/connectors/support/gorgias.md
lang: nl-NL
robots: noindex
---

Vraag vroegtijdige toegang aan

Vul je voornaam en je zakelijke e-mailadres in. We sturen je een link om je aanvraag voor toegang tot Tajo te bevestigen.

# Gorgias-connector

Connectorstatus: Gepland Nog niet gebouwd. Tajo draait deze connector vandaag niet.

| Bronveld | Doelveld | Voorbeeldwaarde |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Verbind je Gorgias-helpdesk met Brevo voor supportgedreven klantbetrokkenheid, post-ticket-marketingflows en uniforme customer experience-analytics via Tajo.

## Overzicht

| Eigenschap | Waarde |
| --- | --- |
| **Platform** | Gorgias |
| **Categorie** | Support |
| **Setupcomplexiteit** | Eenvoudig |
| **Officiële integratie** | Nee |
| **Gesynchroniseerde data** | Klanten, Tickets, Events |
| **API-type** | REST API |
| **Authenticatie** | API-sleutel + e-mail (Basic Auth) |
| **Base URL** | `https://{domain}.gorgias.com/api/` |

## Functies

- **Ticket-event-sync** - Stuur events voor ticket-aanmaak, -oplossing en CSAT door naar Brevo-timelines
- **Verrijking van klantprofielen** - Synchroniseer Gorgias-klantdata inclusief tags en custom velden naar Brevo
- **Post-support-campagnes** - Trigger Brevo-workflows na ticketoplossing voor opvolging of upsell
- **Tevredenheidstracking** - Synchroniseer CSAT-surveyresultaten als Brevo-contactattributen
- **Tag-gebaseerde segmentatie** - Spiegel Gorgias-klanttags naar Brevo-lijstlidmaatschappen
- **Macro- en regel-events** - Track geautomatiseerde acties voor operationele analytics

## Vereisten

Voordat je begint, zorg dat je beschikt over:

1. Een Gorgias-account met admin-toegang
2. Je Gorgias-subdomein (bijv. `yourstore.gorgias.com`)
3. Een API-sleutel en bijbehorend e-mailadres
4. Een Brevo-account met API-toegang
5. Een Tajo-account met een actief abonnement

## Authenticatie

Gorgias gebruikt HTTP Basic Authentication met je account-e-mail en API-sleutel.

### Een API-sleutel aanmaken

1. Log in op je Gorgias-dashboard
2. Ga naar **Settings** > **REST API**
3. Klik op **Create API Key** (of kopieer een bestaande sleutel)
4. Noteer je API base 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"
```

Rechten van API-sleutels

Gorgias-API-sleutels hebben volledige toegang tot je accountdata. Er is geen scope-gebaseerd rechtenmodel. Bescherm je API-sleutel en rouleer hem regelmatig.

### Verbinden met Tajo

```bash
tajo connectors install gorgias \
  --domain yourstore.gorgias.com \
  --email admin@yourstore.com \
  --api-key $GORGIAS_API_KEY
```

## Configuratie

### Basisopzet

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

### Veldmapping

Koppel Gorgias-klant- en ticketvelden aan Brevo-contactattributen:

```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-mapping

```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 integreert met de volgende Gorgias REST API-endpoints:

| Endpoint | Methode | Doel |
| --- | --- | --- |
| `/api/customers` | GET | Klanten opvragen |
| `/api/customers/{id}` | GET | Klant ophalen |
| `/api/customers` | POST | Klant aanmaken |
| `/api/customers/{id}` | PUT | Klant bijwerken |
| `/api/tickets` | GET | Tickets opvragen |
| `/api/tickets/{id}` | GET | Ticket ophalen |
| `/api/tickets/{id}/messages` | GET | Ticketberichten opvragen |
| `/api/tags` | GET | Tags opvragen |
| `/api/satisfaction-surveys` | GET | CSAT-surveys opvragen |
| `/api/satisfaction-surveys/{id}` | GET | Survey ophalen |
| `/api/users` | GET | Agents opvragen |
| `/api/integrations` | GET | Integraties opvragen |
| `/api/events` | GET | Events opvragen |
| `/api/customers/{id}/custom-fields` | GET | Custom field-waarden ophalen |

## Codevoorbeelden

### Connector initialiseren

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

### Klanten naar Brevo synchroniseren

```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 afhandelen via HTTP-integratie

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

### Post-oplossing-campagne

```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-data synchroniseren

```javascript
// Sync satisfaction survey results to Brevo attributes
await tajo.connectors.sync('gorgias', {
  type: 'incremental',
  resources: ['satisfaction_surveys'],
  since: '2024-01-01'
});
```

## Ratelimits

Gorgias hanteert ratelimits per account:

| Limiettype | Waarde |
| --- | --- |
| **API-ratelimit** | 2 requests per seconde |
| **Burst-toegestaan** | Tot 5 requests in korte bursts |
| **Paginatie** | 30 items per pagina (standaard), max 100 |

Paginatiestrategie

Gorgias gebruikt cursor-gebaseerde paginatie met `cursor`- en `limit`-parameters. Tajo regelt dit automatisch en vraagt tot 100 items per pagina op voor maximale efficiëntie.

Gorgias geeft `429 Too Many Requests` terug wanneer ratelimits worden overschreden.

## Probleemoplossing

### Veelvoorkomende problemen

| Probleem | Oorzaak | Oplossing |
| --- | --- | --- |
| 401 Unauthorized | Ongeldig e-mailadres of API-sleutel | Verifieer inloggegevens in Gorgias Settings > REST API |
| 404 Not Found | Ongeldig endpoint of resource-ID | Controleer of de API base URL je subdomein bevat |
| Klanten ontbreken | Geen e-mail in record | Gorgias vereist e-mail voor klantmatching |
| Tags synchroniseren niet | Tags niet toegewezen aan klanten | Verifieer dat tags op klantobjecten staan, niet alleen op tickets |
| Trage sync | Lage ratelimit | Gorgias beperkt tot 2 req/s; volledige syncs duren langer |

### Debugmodus

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

### Verbinding testen

```bash
tajo connectors test gorgias
# ✓ API authentication successful
# ✓ Customer list accessible
# ✓ Ticket data readable
# ✓ CSAT surveys available
# ✓ Tags listable
```

## Best practices

1. **Gebruik HTTP-integraties voor realtime** - Configureer Gorgias Rules om HTTP-requests naar Tajo te sturen bij ticket-events
2. **Synchroniseer CSAT-data regelmatig** - Gebruik satisfactionscores om re-engagementcampagnes aan te sturen
3. **Koppel tags aan segmenten** - Vertaal Gorgias-klanttags naar Brevo-lijstlidmaatschappen
4. **Ga zorgvuldig om met paginatie** - Met 2 req/s-limieten moet je rekening houden met langere sync-tijden voor grote datasets
5. **Koppel aan e-commercedata** - Combineer Gorgias-supportdata met Shopify-orderdata in Brevo
6. **Rouleer API-sleutels** - Omdat Gorgias-sleutels volledige toegang hebben, rouleer je ze periodiek

## Beveiliging

- **Basic Auth** - E-mail en API-sleutel over HTTPS
- **Alleen HTTPS** - Alle API-communicatie versleuteld via TLS 1.2+
- **Sleutels met volledige toegang** - Geen granulaire scoping (bescherm sleutels zorgvuldig)
- **IP-allowlisting** - Beschikbaar op hogere Gorgias-plannen
- **Versleutelde opslag** - API-inloggegevens versleuteld opgeslagen in Tajo
- **SOC 2-compliance** - Het Gorgias-platform is SOC 2 Type II-gecertificeerd

## Gerelateerde resources

- [Twilio Flex-connector](https://tajo.io/nl/docs/connectors/custom/twilio-flex)
- [Jira-connector](https://tajo.io/nl/docs/connectors/custom/jira)
- [Shopify-connector](https://tajo.io/nl/docs/connectors/ecommerce/shopify)
- [Brevo Contacts API](https://tajo.io/nl/docs/contact-management)