--- title: "Konektor Gorgias" description: "Kompletní průvodce integrací Gorgias pro synchronizaci tiketů helpdesku, zákaznických dat a událostí podpory s Brevo přes Tajo." url: https://tajo.io/cz/docs/connectors/support/gorgias/ markdown: https://tajo.io/cz/docs/connectors/support/gorgias.md lang: cs-CZ robots: noindex --- Požádejte o přednostní přístup Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo. # Konektor Gorgias Stav konektoru: Plánováno Zatím nevytvořeno. Tajo tento konektor dnes neprovozuje. | Zdrojové pole | Cílové pole | Ukázková hodnota | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | 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 | Vlastnost | Hodnota | | --- | --- | | **Platforma** | Gorgias | | **Kategorie** | Podpora | | **Složitost nastavení** | Snadná | | **Oficiální integrace** | Ne | | **Synchronizovaná data** | Zákazníci, Tikety, Události | | **Typ API** | REST API | | **Ověření** | API klíč + E-mail (Basic Auth) | | **Základní URL** | `https://{domain}.gorgias.com/api/` | ## 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/` ```bash # Basic Auth: e-mail jako uživatelské jméno, API klíč jako heslo curl -X GET "https://vasobchod.gorgias.com/api/customers" \ -u "admin@vasobchod.com:$GORGIAS_API_KEY" \ -H "Content-Type: application/json" ``` Oprávnění API klíče API klíče Gorgias mají plný přístup k datům vašeho účtu. Neexistuje žádný model oprávnění na základě rozsahu. Chraňte svůj API klíč a pravidelně jej rotujte. ### Připojení k Tajo ```bash tajo connectors install gorgias \ --domain vasobchod.gorgias.com \ --email admin@vasobchod.com \ --api-key $GORGIAS_API_KEY ``` ## Konfigurace ### Základní nastavení ```yaml 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: ```yaml 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í ```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 ``` ## Koncové body API Tajo se integruje s následujícími koncovými body REST API Gorgias: | Koncový bod | Metoda | Účel | | --- | --- | --- | | `/api/customers` | GET | Výpis zákazníků | | `/api/customers/{id}` | GET | Načtení zákazníka | | `/api/customers` | POST | Vytvoření zákazníka | | `/api/customers/{id}` | PUT | Aktualizace zákazníka | | `/api/tickets` | GET | Výpis tiketů | | `/api/tickets/{id}` | GET | Načtení tiketu | | `/api/tickets/{id}/messages` | GET | Výpis zpráv tiketu | | `/api/tags` | GET | Výpis štítků | | `/api/satisfaction-surveys` | GET | Výpis průzkumů CSAT | | `/api/satisfaction-surveys/{id}` | GET | Načtení průzkumu | | `/api/users` | GET | Výpis agentů | | `/api/integrations` | GET | Výpis integrací | | `/api/events` | GET | Výpis událostí | | `/api/customers/{id}/custom-fields` | GET | Získání hodnot vlastních polí | ## Příklady kódu ### Inicializace konektoru ```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: 'vasobchod.gorgias.com', email: 'admin@vasobchod.com', apiKey: process.env.GORGIAS_API_KEY }); ``` ### Synchronizace zákazníků do 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 // } ``` ### Zpracování událostí tiketů přes HTTP integraci ```javascript // 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 ```javascript // 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 ```javascript // 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: | Typ limitu | Hodnota | | --- | --- | | **Limit rychlosti API** | 2 požadavky za sekundu | | **Burst tolerance** | Až 5 požadavků v krátkých dávkách | | **Stránkování** | 30 položek na stránku (výchozí), max. 100 | Strategie stránkování Gorgias používá stránkování na základě kurzoru s parametry `cursor` a `limit`. Tajo to zpracovává automaticky a požaduje až 100 položek na stránku pro maximální efektivitu. Gorgias vrací `429 Too Many Requests` při překročení limitů rychlosti. ## Řešení problémů ### Časté problémy | Problém | Příčina | Řešení | | --- | --- | --- | | 401 Unauthorized | Neplatný e-mail nebo API klíč | Ověřte přihlašovací údaje v Gorgias Nastavení > REST API | | 404 Not Found | Neplatný koncový bod nebo ID zdroje | Zkontrolujte, zda základní URL API obsahuje vaši subdoménu | | Chybějící zákazníci | Žádný e-mail v záznamu | Gorgias vyžaduje e-mail pro párování zákazníků | | Štítky se nesynchronizují | Štítky nepřiřazeny zákazníkům | Ověřte, že štítky jsou na objektech zákazníků, nikoli jen na tiketech | | Pomalá synchronizace | Nízký limit rychlosti | Gorgias omezuje na 2 požadavky/s; úplné synchronizace trvají déle | ### Režim ladění ```yaml connectors: gorgias: debug: true log_level: verbose log_api_calls: true ``` ### Test připojení ```bash 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](https://tajo.io/cz/docs/connectors/custom/twilio-flex) - [Konektor Jira](https://tajo.io/cz/docs/connectors/custom/jira) - [Konektor Shopify](https://tajo.io/cz/docs/connectors/ecommerce/shopify) - [API kontaktů Brevo](https://tajo.io/cz/docs/contact-management)