Connecteur Gorgias

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

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/

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

Connexion à Tajo

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

Configuration

Configuration de base

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 :

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

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 :

Exemples de code

Initialiser le connecteur

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

Synchroniser les clients vers 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
// }

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

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

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

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

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

Dépannage

Problèmes courants

Mode debug

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

Tester la connexion

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