Gorgias Connector

เชื่อมต่อ Gorgias helpdesk ของคุณกับ Brevo สำหรับ customer engagement ที่ขับเคลื่อนด้วย support post-ticket marketing flows และ customer experience analytics ที่รวมกันผ่าน Tajo

ภาพรวม

ฟีเจอร์

• การซิงค์เหตุการณ์ Ticket - ส่งต่อเหตุการณ์การสร้าง การแก้ไข และ CSAT ของ ticket ไปยัง Brevo timelines
• การเสริมโปรไฟล์ลูกค้า - ซิงค์ข้อมูลลูกค้า Gorgias รวมถึง tags และ custom fields ไปยัง Brevo
• แคมเปญหลัง support - Trigger Brevo workflows หลังจากการแก้ไข ticket สำหรับการติดตามหรือ upsell
• การติดตามความพึงพอใจ - ซิงค์ผลการสำรวจ CSAT เป็น Brevo contact attributes
• การแบ่ง segment ตาม tag - จำลอง Gorgias customer tags เป็นสมาชิก Brevo list
• เหตุการณ์ Macro และ rule - ติดตามการดำเนินการอัตโนมัติสำหรับ operational analytics

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

1. บัญชี Gorgias ที่มีสิทธิ์ admin
2. Gorgias subdomain ของคุณ (เช่น yourstore.gorgias.com)
3. API key และที่อยู่อีเมลที่เกี่ยวข้อง
4. บัญชี Brevo ที่มีสิทธิ์เข้าถึง API
5. บัญชี Tajo ที่มีการสมัครสมาชิกที่ใช้งานอยู่

การยืนยันตัวตน

Gorgias ใช้ HTTP Basic Authentication ด้วยอีเมลบัญชีและ API key ของคุณ

การสร้าง API Key

1. เข้าสู่ระบบ Gorgias dashboard ของคุณ
2. ไปที่ Settings > REST API
3. คลิก Create API Key (หรือคัดลอก key ที่มีอยู่)
4. จดบันทึก API base URL ของคุณ: 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"

การเชื่อมต่อกับ Tajo

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

การกำหนดค่า

การตั้งค่าพื้นฐาน

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

การแมปฟิลด์

แมปฟิลด์ลูกค้าและ ticket ของ Gorgias กับแอตทริบิวต์ผู้ติดต่อ 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

การแมปเหตุการณ์

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 ผสานรวมกับ Gorgias REST API endpoints ต่อไปนี้:

ตัวอย่างโค้ด

เริ่มต้น Connector

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

ซิงค์ลูกค้าไปยัง 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
// }

จัดการเหตุการณ์ Ticket ผ่าน HTTP Integration

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

แคมเปญหลังการแก้ไขปัญหา

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

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

ขีดจำกัดอัตรา

Gorgias บังคับใช้ rate limits ต่อบัญชี:

Gorgias ส่งคืน 429 Too Many Requests เมื่อเกิน rate limits

การแก้ไขปัญหา

ปัญหาทั่วไป

โหมด Debug

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

ทดสอบการเชื่อมต่อ

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

แนวทางปฏิบัติที่ดีที่สุด

1. ใช้ HTTP integrations สำหรับ real-time - กำหนดค่า Gorgias Rules เพื่อส่ง HTTP requests ไปยัง Tajo บนเหตุการณ์ ticket
2. ซิงค์ข้อมูล CSAT เป็นประจำ - ใช้คะแนนความพึงพอใจเพื่อขับเคลื่อนแคมเปญ re-engagement
3. แมป tags ไปยัง segments - แปลง Gorgias customer tags เป็นสมาชิก Brevo list
4. จัดการ pagination อย่างระมัดระวัง - ด้วยขีดจำกัด 2 req/s วางแผนสำหรับเวลาซิงค์ที่นานขึ้นสำหรับชุดข้อมูลขนาดใหญ่
5. เชื่อมกับข้อมูล e-commerce - รวมข้อมูล support Gorgias กับข้อมูลคำสั่งซื้อ Shopify ใน Brevo
6. หมุนเวียน API keys - เนื่องจาก Gorgias keys มีการเข้าถึงแบบเต็มรูปแบบ หมุนเวียนเป็นระยะ

ความปลอดภัย

• Basic Auth - อีเมลและ API key ผ่าน HTTPS
• HTTPS เท่านั้น - การสื่อสาร API ทั้งหมดเข้ารหัสผ่าน TLS 1.2+
• Full Access Keys - ไม่มี granular scoping (ปกป้อง keys อย่างระมัดระวัง)
• IP Allowlisting - มีให้สำหรับแผน Gorgias ที่สูงกว่า
• การจัดเก็บที่เข้ารหัส - ข้อมูลประจำตัว API เข้ารหัสที่เก็บใน Tajo
• SOC 2 Compliance - Gorgias platform ได้รับการรับรอง SOC 2 Type II

แหล่งข้อมูลที่เกี่ยวข้อง

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