--- title: "Trình Kết Nối Gorgias" description: "Hướng dẫn tích hợp Gorgias đầy đủ để đồng bộ helpdesk tickets, customer data và support events với Brevo qua Tajo." url: https://tajo.io/vi/docs/connectors/support/gorgias/ markdown: https://tajo.io/vi/docs/connectors/support/gorgias.md lang: vi-VN robots: noindex --- Đăng ký quyền truy cập sớm Nhập tên và địa chỉ email công việc của bạn. Chúng tôi sẽ gửi liên kết để xác nhận yêu cầu truy cập Tajo. # Trình Kết Nối Gorgias Trạng thái trình kết nối: Dự kiến Chưa được xây dựng. Hiện Tajo chưa chạy trình kết nối này. | Trường nguồn | Trường đích | Giá trị mẫu | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Kết nối helpdesk Gorgias của bạn với Brevo để engagement khách hàng dựa trên support, post-ticket marketing flows và unified customer experience analytics qua Tajo. ## Tổng Quan | Thuộc Tính | Giá Trị | | --- | --- | | **Nền Tảng** | Gorgias | | **Danh Mục** | Support | | **Độ Phức Tạp Thiết Lập** | Dễ | | **Tích Hợp Chính Thức** | Không | | **Dữ Liệu Đồng Bộ** | Customers, Tickets, Events | | **Loại API** | REST API | | **Xác Thực** | API Key + Email (Basic Auth) | | **URL Cơ Sở** | `https://{domain}.gorgias.com/api/` | ## Tính Năng - **Đồng bộ ticket event** - Forward ticket creation, resolution và CSAT events sang Brevo timelines - **Làm giàu customer profile** - Đồng bộ dữ liệu khách hàng Gorgias bao gồm tags và custom fields sang Brevo - **Post-support campaigns** - Kích hoạt Brevo workflows sau khi ticket được giải quyết để follow-up hoặc upsell - **Theo dõi satisfaction** - Đồng bộ kết quả CSAT survey như thuộc tính liên hệ Brevo - **Phân đoạn dựa trên tag** - Ánh xá Gorgias customer tags thành Brevo list memberships - **Macro và rule events** - Theo dõi các hành động tự động cho operational analytics ## Yêu Cầu Trước khi bắt đầu, hãy đảm bảo bạn có: 1. Tài khoản Gorgias với quyền admin 2. Subdomain Gorgias của bạn (ví dụ: `yourstore.gorgias.com`) 3. API key và địa chỉ email liên kết 4. Tài khoản Brevo với quyền truy cập API 5. Tài khoản Tajo với subscription đang hoạt động ## Xác Thực Gorgias sử dụng HTTP Basic Authentication với email tài khoản và API key của bạn. ### Tạo API Key 1. Đăng nhập vào Gorgias dashboard của bạn 2. Điều hướng đến **Settings** > **REST API** 3. Nhấp **Create API Key** (hoặc sao chép key hiện có) 4. Ghi chú API base URL của bạn: `https://{domain}.gorgias.com/api/` ```bash # Basic Auth: email làm username, API key làm password curl -X GET "https://yourstore.gorgias.com/api/customers" \ -u "admin@yourstore.com:$GORGIAS_API_KEY" \ -H "Content-Type: application/json" ``` Quyền API Key Gorgias API keys có toàn quyền truy cập dữ liệu tài khoản của bạn. Không có mô hình quyền dựa trên phạm vi. Bảo vệ API key và thay đổi định kỳ. ### Kết Nối Với Tajo ```bash tajo connectors install gorgias \ --domain yourstore.gorgias.com \ --email admin@yourstore.com \ --api-key $GORGIAS_API_KEY ``` ## Cấu Hình ### Thiết Lập Cơ Bản ```yaml 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 ``` ### Ánh Xạ Trường Ánh xạ trường customer và ticket Gorgias sang thuộc tính liên hệ Brevo: ```yaml field_mapping: # Trường customer id: GORGIAS_ID email: email name: FIRSTNAME phone: SMS # Số liệu support nb_tickets: TICKET_COUNT last_ticket_date: LAST_SUPPORT_DATE last_ticket_channel: LAST_SUPPORT_CHANNEL avg_response_time: AVG_RESPONSE_TIME # Dữ liệu CSAT last_satisfaction_score: CSAT_SCORE satisfaction_count: CSAT_RESPONSES # Custom fields customer_type: CUSTOMER_TYPE vip_status: VIP_STATUS ``` ### Ánh Xạ Sự Kiện ```yaml 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 tích hợp với các Gorgias REST API endpoints sau: | Endpoint | Phương Thức | Mục Đích | | --- | --- | --- | | `/api/customers` | GET | Liệt kê customers | | `/api/customers/{id}` | GET | Lấy một customer | | `/api/customers` | POST | Tạo customer | | `/api/customers/{id}` | PUT | Cập nhật customer | | `/api/tickets` | GET | Liệt kê tickets | | `/api/tickets/{id}` | GET | Lấy một ticket | | `/api/tickets/{id}/messages` | GET | Liệt kê ticket messages | | `/api/tags` | GET | Liệt kê tags | | `/api/satisfaction-surveys` | GET | Liệt kê CSAT surveys | | `/api/satisfaction-surveys/{id}` | GET | Lấy một survey | | `/api/users` | GET | Liệt kê agents | | `/api/integrations` | GET | Liệt kê integrations | | `/api/events` | GET | Liệt kê events | | `/api/customers/{id}/custom-fields` | GET | Lấy giá trị custom field | ## Ví Dụ Code ### Khởi Tạo Trình Kết Nối ```javascript 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: 'admin@yourstore.com', apiKey: process.env.GORGIAS_API_KEY }); ``` ### Đồng Bộ Customers Sang Brevo ```javascript 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 // } ``` ### Xử Lý Ticket Events qua HTTP Integration ```javascript // Gorgias có thể gửi HTTP requests qua Rules hoặc 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'); }); ``` ### Campaign Sau Khi Giải Quyết ```javascript // Kích hoạt email follow-up sau khi support ticket được giải quyết 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 } }); } }); ``` ### Đồng Bộ Dữ Liệu CSAT ```javascript // Đồng bộ kết quả satisfaction survey sang thuộc tính Brevo await tajo.connectors.sync('gorgias', { type: 'incremental', resources: ['satisfaction_surveys'], since: '2024-01-01' }); ``` ## Giới Hạn Tốc Độ Gorgias áp dụng giới hạn tốc độ theo tài khoản: | Loại Giới Hạn | Giá Trị | | --- | --- | | **Giới hạn tốc độ API** | 2 yêu cầu mỗi giây | | **Cho phép burst** | Tới 5 yêu cầu trong khoảng ngắn | | **Phân trang** | 30 items mỗi trang (mặc định), tối đa 100 | Chiến Lược Phân Trang Gorgias sử dụng cursor-based pagination với tham số `cursor` và `limit`. Tajo xử lý tự động, yêu cầu tới 100 items mỗi trang để tối đa hiệu quả. Gorgias trả về `429 Too Many Requests` khi vượt giới hạn tốc độ. ## Khắc Phục Sự Cố ### Sự Cố Phổ Biến | Sự Cố | Nguyên Nhân | Giải Pháp | | --- | --- | --- | | 401 Unauthorized | Email hoặc API key không hợp lệ | Xác minh credentials trong Gorgias Settings > REST API | | 404 Not Found | Endpoint không hợp lệ hoặc resource ID sai | Kiểm tra API base URL bao gồm subdomain của bạn | | Customers thiếu | Không có email trên record | Gorgias yêu cầu email để khớp customer | | Tags không đồng bộ | Tags không được gán cho customers | Xác minh tags nằm trên customer objects, không chỉ tickets | | Đồng bộ chậm | Giới hạn tốc độ thấp | Gorgias giới hạn 2 req/s; full syncs mất nhiều thời gian hơn | ### Chế Độ Debug ```yaml connectors: gorgias: debug: true log_level: verbose log_api_calls: true ``` ### Kiểm Tra Kết Nối ```bash tajo connectors test gorgias # ✓ API authentication successful # ✓ Customer list accessible # ✓ Ticket data readable # ✓ CSAT surveys available # ✓ Tags listable ``` ## Thực Hành Tốt Nhất 1. **Dùng HTTP integrations cho real-time** - Cấu hình Gorgias Rules để gửi HTTP requests đến Tajo trên ticket events 2. **Đồng bộ dữ liệu CSAT thường xuyên** - Dùng satisfaction scores để thúc đẩy re-engagement campaigns 3. **Ánh xạ tags sang segments** - Chuyển đổi Gorgias customer tags thành Brevo list memberships 4. **Xử lý phân trang cẩn thận** - Với giới hạn 2 req/s, lên kế hoạch cho thời gian đồng bộ dài hơn trên datasets lớn 5. **Kết hợp với dữ liệu e-commerce** - Kết hợp dữ liệu support Gorgias với dữ liệu order Shopify trong Brevo 6. **Thay đổi API keys** - Vì Gorgias keys có toàn quyền truy cập, thay đổi chúng định kỳ ## Bảo Mật - **Basic Auth** - Email và API key qua HTTPS - **Chỉ HTTPS** - Tất cả giao tiếp API được mã hóa qua TLS 1.2+ - **Keys Truy Cập Đầy Đủ** - Không có scoping chi tiết (bảo vệ keys cẩn thận) - **IP Allowlisting** - Có sẵn trên các gói Gorgias cao hơn - **Lưu Trữ Mã Hóa** - API credentials được mã hóa khi lưu trữ trong Tajo - **Tuân Thủ SOC 2** - Nền tảng Gorgias được chứng nhận SOC 2 Type II ## Tài Nguyên Liên Quan - [Trình Kết Nối Twilio Flex](https://tajo.io/vi/docs/connectors/custom/twilio-flex) - [Trình Kết Nối Jira](https://tajo.io/vi/docs/connectors/custom/jira) - [Trình Kết Nối Shopify](https://tajo.io/vi/docs/connectors/ecommerce/shopify) - [Brevo Contacts API](https://tajo.io/vi/docs/contact-management)