Konektor Gorgias

Hubungkan helpdesk Gorgias Anda ke Brevo untuk customer engagement berbasis support, alur marketing pasca tiket, dan analitik pengalaman pelanggan yang terpadu melalui Tajo.

Ikhtisar

Fitur

• Sinkronisasi event tiket - Teruskan event pembuatan tiket, penyelesaian, dan CSAT ke timeline Brevo
• Pengayaan profil pelanggan - Sinkronkan data pelanggan Gorgias termasuk tag dan custom field ke Brevo
• Kampanye pasca support - Picu alur kerja Brevo setelah tiket selesai untuk follow-up atau upsell
• Pelacakan kepuasan - Sinkronkan hasil survei CSAT sebagai atribut kontak Brevo
• Segmentasi berbasis tag - Cerminkan tag pelanggan Gorgias sebagai keanggotaan daftar Brevo
• Event macro dan rule - Lacak aksi otomatis untuk analitik operasional

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Akun Gorgias dengan akses admin
2. Subdomain Gorgias Anda (misalnya, yourstore.gorgias.com)
3. Sebuah API key dan alamat email yang terkait
4. Akun Brevo dengan akses API
5. Akun Tajo dengan langganan aktif

Autentikasi

Gorgias menggunakan HTTP Basic Authentication dengan email akun dan API key Anda.

Membuat API key

1. Masuk ke dasbor Gorgias Anda
2. Buka Settings > REST API
3. Klik Create API Key (atau salin key yang sudah ada)
4. Catat base URL API Anda: 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"

Menghubungkan ke Tajo

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

Konfigurasi

Setup dasar

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

Pemetaan field

Petakan field pelanggan dan tiket Gorgias ke atribut kontak Brevo:

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

Pemetaan event

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

Endpoint API

Tajo terintegrasi dengan endpoint REST API Gorgias berikut:

Contoh kode

Inisialisasi konektor

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

Menyinkronkan pelanggan ke 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
// }

Menangani event tiket lewat integrasi HTTP

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

Kampanye pasca penyelesaian

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

Menyinkronkan data CSAT

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

Batas rate

Gorgias menerapkan batas rate per akun:

Gorgias mengembalikan 429 Too Many Requests ketika batas rate terlampaui.

Pemecahan masalah

Masalah umum

Mode debug

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

Menguji koneksi

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

Praktik terbaik

1. Gunakan integrasi HTTP untuk real-time - Konfigurasikan Gorgias Rules agar mengirim permintaan HTTP ke Tajo pada event tiket
2. Sinkronkan data CSAT secara rutin - Gunakan skor kepuasan untuk menggerakkan kampanye re-engagement
3. Petakan tag ke segmen - Terjemahkan tag pelanggan Gorgias menjadi keanggotaan daftar Brevo
4. Tangani paginasi dengan cermat - Dengan batas 2 req/detik, siapkan waktu sinkronisasi lebih lama untuk dataset besar
5. Hubungkan dengan data e-commerce - Gabungkan data support Gorgias dengan data pesanan Shopify di Brevo
6. Rotasikan API key - Karena key Gorgias memiliki akses penuh, rotasikan secara berkala

Keamanan

• Basic Auth - Email dan API key melalui HTTPS
• HTTPS saja - Semua komunikasi API dienkripsi lewat TLS 1.2+
• Key akses penuh - Tidak ada scoping granular (lindungi key dengan cermat)
• IP allowlisting - Tersedia pada paket Gorgias yang lebih tinggi
• Penyimpanan terenkripsi - Kredensial API dienkripsi saat disimpan di Tajo
• Kepatuhan SOC 2 - Platform Gorgias bersertifikat SOC 2 Type II

Sumber daya terkait

• Konektor Twilio Flex
• Konektor Jira
• Konektor Shopify
• Brevo Contacts API