Σύνδεσμος Gorgias

Συνδέστε το helpdesk Gorgias με το Brevo για αφοσίωση πελατών βάσει υποστήριξης, ροές marketing μετά-εισιτηρίου και ενοποιημένα αναλυτικά εμπειρίας πελάτη μέσω Tajo.

Επισκόπηση

Χαρακτηριστικά

• Συγχρονισμός εκδηλώσεων εισιτηρίων - Προώθηση εκδηλώσεων δημιουργίας, επίλυσης και CSAT στα χρονολόγια Brevo
• Εμπλουτισμός προφίλ πελάτη - Συγχρονισμός δεδομένων πελάτη Gorgias συμπεριλαμβανομένων ετικετών και προσαρμοσμένων πεδίων στο Brevo
• Καμπάνιες μετά-υποστήριξης - Trigger ροών εργασίας Brevo μετά την επίλυση εισιτηρίου για follow-up ή upsell
• Παρακολούθηση ικανοποίησης - Συγχρονισμός αποτελεσμάτων έρευνας CSAT ως χαρακτηριστικά επαφών Brevo
• Τμηματοποίηση βάσει ετικετών - Αντικατοπτρισμός ετικετών πελάτη Gorgias ως συμμετοχές λίστας Brevo
• Εκδηλώσεις macro και rule - Παρακολούθηση αυτοματοποιημένων ενεργειών για λειτουργικά αναλυτικά

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Gorgias με πρόσβαση διαχειριστή
2. Το υποτομέα Gorgias σας (π.χ. yourstore.gorgias.com)
3. Κλειδί API και συσχετισμένη διεύθυνση email
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με ενεργή συνδρομή

Πιστοποίηση

Το Gorgias χρησιμοποιεί HTTP Basic Authentication με το email λογαριασμού και κλειδί API.

Δημιουργία Κλειδιού API

1. Συνδεθείτε στο dashboard Gorgias
2. Μεταβείτε στις Settings > REST API
3. Κάντε κλικ Create API Key (ή αντιγράψτε υπάρχον κλειδί)
4. Σημειώστε το βασικό URL API: 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

Αντιστοίχιση Πεδίων

Αντιστοίχηση πεδίων πελάτη και εισιτηρίου 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

Endpoints API

Το Tajo ενσωματώνεται με τα ακόλουθα endpoints REST API του Gorgias:

Παραδείγματα Κώδικα

Αρχικοποίηση Συνδέσμου

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

Χειρισμός Εκδηλώσεων Εισιτηρίου μέσω 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 επιβάλλει όρια ρυθμού ανά λογαριασμό:

Το Gorgias επιστρέφει 429 Too Many Requests όταν υπερβαίνονται τα όρια ρυθμού.

Αντιμετώπιση Προβλημάτων

Συνήθη Προβλήματα

Λειτουργία Εντοπισμού Σφαλμάτων

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 για πραγματικό χρόνο - Ρυθμίστε Κανόνες Gorgias για αποστολή HTTP αιτημάτων στο Tajo σε εκδηλώσεις εισιτηρίων
2. Συγχρονίστε δεδομένα CSAT τακτικά - Χρησιμοποιήστε βαθμολογίες ικανοποίησης για καμπάνιες επανεμπλοκής
3. Αντιστοιχίστε ετικέτες σε τμήματα - Μεταφράστε ετικέτες πελάτη Gorgias σε συμμετοχές λίστας Brevo
4. Χειριστείτε τη σελιδοποίηση προσεκτικά - Με όρια 2 αιτ./δευτ., σχεδιάστε για μεγαλύτερους χρόνους συγχρονισμού σε μεγάλα σύνολα δεδομένων
5. Συνδέστε με δεδομένα e-commerce - Συνδυάστε δεδομένα υποστήριξης Gorgias με δεδομένα παραγγελιών Shopify στο Brevo
6. Εναλλάσσετε κλειδιά API - Δεδομένου ότι τα κλειδιά Gorgias έχουν πλήρη πρόσβαση, εναλλάσσετε τα περιοδικά

Ασφάλεια

• Basic Auth - Email και κλειδί API μέσω HTTPS
• Μόνο HTTPS - Όλη η επικοινωνία API κρυπτογραφείται μέσω TLS 1.2+
• Κλειδιά Πλήρους Πρόσβασης - Χωρίς λεπτομερή εύρη (προστατέψτε προσεκτικά τα κλειδιά)
• Λίστα Επιτρεπόμενων IP - Διαθέσιμο σε υψηλότερα πλάνα Gorgias
• Κρυπτογραφημένη Αποθήκευση - Διαπιστευτήρια API κρυπτογραφούνται σε ηρεμία στο Tajo
• Συμμόρφωση SOC 2 - Η πλατφόρμα Gorgias είναι πιστοποιημένη SOC 2 Type II

Σχετικοί Πόροι

• Σύνδεσμος Twilio Flex
• Σύνδεσμος Jira
• Σύνδεσμος Shopify
• API Επαφών Brevo