---
title: "Connecteur Gorgias"
description: "Guide complet d'intégration Gorgias pour synchroniser tickets helpdesk, données clients et événements de support avec Brevo via Tajo."
url: https://tajo.io/fr/docs/connectors/support/gorgias/
markdown: https://tajo.io/fr/docs/connectors/support/gorgias.md
lang: fr-FR
robots: noindex
---

Demandez un accès anticipé

Indiquez votre prénom et votre adresse e-mail professionnelle. Nous vous enverrons un lien pour confirmer votre demande d’accès à Tajo.

# Connecteur Gorgias

Statut du connecteur: Prévu Pas encore construit. Tajo n'exécute pas ce connecteur aujourd'hui.

| Champ source | Champ de destination | Valeur d’exemple |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Connectez votre helpdesk Gorgias à Brevo pour un engagement client guidé par le support, des flows marketing post-ticket, et des analytiques d’expérience client unifiées via Tajo.

## Vue d’ensemble

| Propriété | Valeur |
| --- | --- |
| **Plateforme** | Gorgias |
| **Catégorie** | Support |
| **Complexité de configuration** | Facile |
| **Intégration officielle** | Non |
| **Données synchronisées** | Clients, Tickets, Événements |
| **Type d’API** | API REST |
| **Authentification** | Clé API + Email (Basic Auth) |
| **URL de base** | `https://{domain}.gorgias.com/api/` |

## Fonctionnalités

- **Synchronisation des événements de tickets** - Transfert des événements de création, résolution et CSAT vers les timelines Brevo
- **Enrichissement de profil client** - Synchronisation des données clients Gorgias incluant tags et champs personnalisés vers Brevo
- **Campagnes post-support** - Déclenchement de workflows Brevo après la résolution de tickets pour le suivi ou l’upsell
- **Suivi de satisfaction** - Synchronisation des résultats d’enquêtes CSAT en tant qu’attributs de contact Brevo
- **Segmentation par tags** - Mise en miroir des tags clients Gorgias en tant qu’appartenances de listes Brevo
- **Événements de macros et règles** - Suivi des actions automatisées pour l’analytique opérationnelle

## Prérequis

Avant de commencer, assurez-vous d’avoir :

1. Un compte Gorgias avec accès admin
2. Votre sous-domaine Gorgias (ex. `yourstore.gorgias.com`)
3. Une clé API et l’adresse email associée
4. Un compte Brevo avec accès API
5. Un compte Tajo avec un abonnement actif

## Authentification

Gorgias utilise l’authentification HTTP Basic avec l’email de votre compte et la clé API.

### Création d’une clé API

1. Connectez-vous à votre tableau de bord Gorgias
2. Naviguez vers **Settings** > **REST API**
3. Cliquez sur **Create API Key** (ou copiez la clé existante)
4. Notez votre URL de base API : `https://{domain}.gorgias.com/api/`

```bash
# Basic Auth : email comme nom d'utilisateur, clé API comme mot de passe
curl -X GET "https://yourstore.gorgias.com/api/customers" \
  -u "admin@yourstore.com:$GORGIAS_API_KEY" \
  -H "Content-Type: application/json"
```

Permissions des clés API

Les clés API Gorgias ont un accès complet aux données de votre compte. Il n’y a pas de modèle de permissions par périmètre. Protégez votre clé API et faites-la tourner régulièrement.

### Connexion à Tajo

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

## Configuration

### Configuration de base

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

### Mappage de champs

Mappez les champs clients et tickets Gorgias aux attributs de contact Brevo :

```yaml
field_mapping:
  # Champs client
  id: GORGIAS_ID
  email: email
  name: FIRSTNAME
  phone: SMS

  # Métriques de support
  nb_tickets: TICKET_COUNT
  last_ticket_date: LAST_SUPPORT_DATE
  last_ticket_channel: LAST_SUPPORT_CHANNEL
  avg_response_time: AVG_RESPONSE_TIME

  # Données CSAT
  last_satisfaction_score: CSAT_SCORE
  satisfaction_count: CSAT_RESPONSES

  # Champs personnalisés
  customer_type: CUSTOMER_TYPE
  vip_status: VIP_STATUS
```

### Mappage des événements

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

## Endpoints API

Tajo s’intègre avec les endpoints API REST Gorgias suivants :

| Endpoint | Méthode | Objectif |
| --- | --- | --- |
| `/api/customers` | GET | Lister les clients |
| `/api/customers/{id}` | GET | Récupérer un client |
| `/api/customers` | POST | Créer un client |
| `/api/customers/{id}` | PUT | Mettre à jour un client |
| `/api/tickets` | GET | Lister les tickets |
| `/api/tickets/{id}` | GET | Récupérer un ticket |
| `/api/tickets/{id}/messages` | GET | Lister les messages d’un ticket |
| `/api/tags` | GET | Lister les tags |
| `/api/satisfaction-surveys` | GET | Lister les enquêtes CSAT |
| `/api/satisfaction-surveys/{id}` | GET | Récupérer une enquête |
| `/api/users` | GET | Lister les agents |
| `/api/integrations` | GET | Lister les intégrations |
| `/api/events` | GET | Lister les événements |
| `/api/customers/{id}/custom-fields` | GET | Obtenir les valeurs des champs personnalisés |

## Exemples de code

### Initialiser le connecteur

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

### Synchroniser les clients vers Brevo

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

### Gérer les événements de tickets via intégration HTTP

```javascript
// Gorgias peut envoyer des requêtes HTTP via des Rules ou intégrations HTTP
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');
});
```

### Campagne post-résolution

```javascript
// Déclencher un email de suivi après la résolution d'un ticket de support
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
      }
    });
  }
});
```

### Synchroniser les données CSAT

```javascript
// Synchroniser les résultats d'enquêtes de satisfaction vers les attributs Brevo
await tajo.connectors.sync('gorgias', {
  type: 'incremental',
  resources: ['satisfaction_surveys'],
  since: '2024-01-01'
});
```

## Limites de taux

Gorgias applique des limites de taux par compte :

| Type de limite | Valeur |
| --- | --- |
| **Limite de taux API** | 2 requêtes par seconde |
| **Allocation de rafale** | Jusqu’à 5 requêtes en courtes rafales |
| **Pagination** | 30 éléments par page (par défaut), max 100 |

Stratégie de pagination

Gorgias utilise la pagination par curseur avec les paramètres `cursor` et `limit`. Tajo gère cela automatiquement, demandant jusqu’à 100 éléments par page pour une efficacité maximale.

Gorgias retourne `429 Too Many Requests` lorsque les limites de taux sont dépassées.

## Dépannage

### Problèmes courants

| Problème | Cause | Solution |
| --- | --- | --- |
| 401 Unauthorized | Email ou clé API invalide | Vérifiez les identifiants dans Gorgias Settings > REST API |
| 404 Not Found | Endpoint ou ID de ressource invalide | Vérifiez que l’URL de base API inclut votre sous-domaine |
| Clients manquants | Pas d’email enregistré | Gorgias nécessite un email pour la correspondance client |
| Tags non synchronisés | Tags non assignés aux clients | Vérifiez que les tags sont sur les objets clients, pas uniquement sur les tickets |
| Synchronisation lente | Limite de taux basse | Gorgias limite à 2 req/s ; les synchronisations complètes prennent plus de temps |

### Mode debug

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

### Tester la connexion

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

## Bonnes pratiques

1. **Utilisez les intégrations HTTP pour le temps réel** - Configurez les Rules Gorgias pour envoyer des requêtes HTTP à Tajo sur les événements de tickets
2. **Synchronisez les données CSAT régulièrement** - Utilisez les scores de satisfaction pour piloter les campagnes de réengagement
3. **Mappez les tags aux segments** - Traduisez les tags clients Gorgias en appartenances de listes Brevo
4. **Gérez la pagination avec soin** - Avec des limites de 2 req/s, prévoyez des temps de synchronisation plus longs sur les gros datasets
5. **Liez aux données e-commerce** - Combinez les données de support Gorgias avec les données de commandes Shopify dans Brevo
6. **Faites tourner les clés API** - Puisque les clés Gorgias ont un accès complet, faites-les tourner périodiquement

## Sécurité

- **Basic Auth** - Email et clé API sur HTTPS
- **HTTPS uniquement** - Toutes les communications API chiffrées via TLS 1.2+
- **Clés à accès complet** - Pas de périmètre granulaire (protégez les clés avec soin)
- **Liste blanche d’IP** - Disponible sur les plans Gorgias supérieurs
- **Stockage chiffré** - Identifiants API chiffrés au repos dans Tajo
- **Conformité SOC 2** - La plateforme Gorgias est certifiée SOC 2 Type II

## Ressources liées

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