Konektor Gorgias

Propojte svůj helpdesk Gorgias s Brevo pro zákaznické zapojení řízené podporou, marketingové toky po vyřešení tiketů a sjednocenou analytiku zákaznické zkušenosti přes Tajo.

Přehled

Funkce

• Synchronizace událostí tiketů – Přeposílejte události vytvoření tiketů, vyřešení a CSAT do časových os Brevo
• Obohacení zákaznického profilu – Synchronizujte zákaznická data Gorgias včetně štítků a vlastních polí do Brevo
• Kampaně po podpoře – Spouštějte pracovní toky Brevo po vyřešení tiketu pro následný kontakt nebo upsell
• Sledování spokojenosti – Synchronizujte výsledky průzkumů CSAT jako atributy kontaktů Brevo
• Segmentace na základě štítků – Zrcadlete štítky zákazníků Gorgias jako členství v seznamech Brevo
• Události maker a pravidel – Sledujte automatizované akce pro operační analytiku

Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Gorgias s přístupem správce
2. Vaši subdoménu Gorgias (např. vasobchod.gorgias.com)
3. API klíč a přidruženou e-mailovou adresu
4. Účet Brevo s přístupem k API
5. Účet Tajo s aktivním předplatným

Ověření

Gorgias používá HTTP Basic Authentication s e-mailem účtu a API klíčem.

Vytvoření API klíče

1. Přihlaste se do svého řídicího panelu Gorgias
2. Přejděte do Nastavení > REST API
3. Klikněte na Vytvořit API klíč (nebo zkopírujte existující klíč)
4. Poznamenejte si základní URL API: https://{domain}.gorgias.com/api/

# Basic Auth: e-mail jako uživatelské jméno, API klíč jako heslo
curl -X GET "https://vasobchod.gorgias.com/api/customers" \
  -u "[email protected]:$GORGIAS_API_KEY" \
  -H "Content-Type: application/json"

Připojení k Tajo

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

Konfigurace

Základní nastavení

connectors:
  gorgias:
    enabled: true
    domain: "vasobchod.gorgias.com"

    sync:
      customers: true
      tickets: true
      satisfaction_surveys: true
      tags: true

    lists:
      all_support_contacts: 35
      satisfied_customers: 36
      dissatisfied_customers: 37

Mapování polí

Mapujte pole zákazníků a tiketů Gorgias na atributy kontaktů Brevo:

field_mapping:
  # Pole zákazníka
  id: GORGIAS_ID
  email: email
  name: FIRSTNAME
  phone: SMS

  # Metriky podpory
  nb_tickets: TICKET_COUNT
  last_ticket_date: LAST_SUPPORT_DATE
  last_ticket_channel: LAST_SUPPORT_CHANNEL
  avg_response_time: AVG_RESPONSE_TIME

  # Data CSAT
  last_satisfaction_score: CSAT_SCORE
  satisfaction_count: CSAT_RESPONSES

  # Vlastní pole
  customer_type: CUSTOMER_TYPE
  vip_status: VIP_STATUS

Mapování událostí

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

Koncové body API

Tajo se integruje s následujícími koncovými body REST API Gorgias:

Příklady kódu

Inicializace konektoru

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: 'vasobchod.gorgias.com',
  email: '[email protected]',
  apiKey: process.env.GORGIAS_API_KEY
});

Synchronizace zákazníků do 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
// }

Zpracování událostí tiketů přes HTTP integraci

// Gorgias může odesílat HTTP požadavky přes Pravidla nebo HTTP integrace
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');
});

Kampaň po vyřešení tiketu

// Spuštění follow-up e-mailu po vyřešení tiketu podpory
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
      }
    });
  }
});

Synchronizace dat CSAT

// Synchronizace výsledků průzkumů spokojenosti na atributy Brevo
await tajo.connectors.sync('gorgias', {
  type: 'incremental',
  resources: ['satisfaction_surveys'],
  since: '2024-01-01'
});

Omezení rychlosti

Gorgias vynucuje limity rychlosti na účet:

Gorgias vrací 429 Too Many Requests při překročení limitů rychlosti.

Řešení problémů

Časté problémy

Režim ladění

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

Test připojení

tajo connectors test gorgias
# ✓ Ověření API úspěšné
# ✓ Seznam zákazníků přístupný
# ✓ Data tiketů čitelná
# ✓ Průzkumy CSAT dostupné
# ✓ Štítky vypsatelné

Osvědčené postupy

1. Používejte HTTP integrace pro reálný čas – Nakonfigurujte Pravidla Gorgias pro odesílání HTTP požadavků do Tajo při událostech tiketů
2. Pravidelně synchronizujte data CSAT – Používejte skóre spokojenosti pro řízení re-engagement kampaní
3. Mapujte štítky na segmenty – Přeložte štítky zákazníků Gorgias na členství v seznamech Brevo
4. Pečlivě zpracovávejte stránkování – S limity 2 požadavky/s plánujte delší časy synchronizace u velkých datových sad
5. Propojte s e-commerce daty – Kombinujte data podpory Gorgias s daty objednávek Shopify v Brevo
6. Rotujte API klíče – Protože klíče Gorgias mají plný přístup, pravidelně je rotujte

Zabezpečení

• Basic Auth – E-mail a API klíč přes HTTPS
• Pouze HTTPS – Veškerá komunikace API šifrovaná přes TLS 1.2+
• Klíče s plným přístupem – Žádné granulární vymezení (pečlivě chraňte klíče)
• Whitelisting IP – Dostupné na vyšších plánech Gorgias
• Šifrované úložiště – API přihlašovací údaje šifrované v klidu v Tajo
• Soulad se SOC 2 – Platforma Gorgias je certifikována podle SOC 2 Type II

Související zdroje

• Konektor Twilio Flex
• Konektor Jira
• Konektor Shopify
• API kontaktů Brevo