--- title: "Gorgias konnektor" description: "Teljes Gorgias integrációs útmutató ügyfélszolgálati jegyek, ügyféladatok és támogatási események Brevóval való szinkronizációjához a Tajo segítségével." url: https://tajo.io/hu/docs/connectors/support/gorgias/ markdown: https://tajo.io/hu/docs/connectors/support/gorgias.md lang: hu-HU robots: noindex --- Kérj korai hozzáférést Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét. # Gorgias konnektor Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort. | Forrásmező | Célmező | Mintaérték | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Csatlakoztasd a Gorgias helpdeskedet a Brevóhoz támogatás-vezérelt ügyfél-elköteleződéshez, jegy utáni marketing folyamatokhoz és egységesített ügyfélélmény-analitikához a Tajo segítségével. ## Áttekintés | Tulajdonság | Érték | | --- | --- | | **Platform** | Gorgias | | **Kategória** | Ügyfélszolgálat | | **Telepítés bonyolultsága** | Könnyű | | **Hivatalos integráció** | Nem | | **Szinkronizált adatok** | Ügyfelek, Jegyek, Események | | **API típus** | REST API | | **Hitelesítés** | API kulcs + E-mail (Basic Auth) | | **Alap URL** | `https://{domain}.gorgias.com/api/` | ## Funkciók - **Jegy esemény szinkronizáció** – Jegy létrehozási, megoldási és CSAT események továbbítása Brevo idővonalakra - **Ügyfélprofil gazdagítás** – Gorgias ügyféladatok, beleértve a címkéket és egyéni mezőket, szinkronizálása a Brevóba - **Támogatás utáni kampányok** – Brevo munkafolyamatok indítása a jegy megoldása után utánkövetéshez vagy upsellhez - **Elégedettség-követés** – CSAT felmérési eredmények szinkronizálása Brevo kapcsolat-attribútumokként - **Címke alapú szegmentálás** – Gorgias ügyfélcímkék tükrözése Brevo lista-tagságokként - **Makró és szabály események** – Automatizált műveletek követése operatív analitikához ## Előfeltételek Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel: 1. Egy Gorgias fiókkal adminisztrátori hozzáféréssel 2. A Gorgias aldomaineddel (pl. `boltodat.gorgias.com`) 3. Egy API kulccsal és a hozzá tartozó e-mail címmel 4. Egy Brevo fiókkal API-hozzáféréssel 5. Egy Tajo fiókkal aktív előfizetéssel ## Hitelesítés A Gorgias HTTP Basic Authentication-t használ a fiók e-mail-jével és az API kulccsal. ### API kulcs létrehozása 1. Jelentkezz be a Gorgias dashboardba 2. Menj a **Beállítások** > **REST API** menübe 3. Kattints az **API kulcs létrehozása** gombra (vagy másold a meglévő kulcsot) 4. Jegyezd fel az API alap URL-t: `https://{domain}.gorgias.com/api/` ```bash # Basic Auth: email as username, API key as password curl -X GET "https://yourstore.gorgias.com/api/customers" \ -u "admin@yourstore.com:$GORGIAS_API_KEY" \ -H "Content-Type: application/json" ``` API kulcs jogosultságok A Gorgias API kulcsok teljes hozzáférést biztosítanak a fiókodhoz. Nincs hatókör alapú jogosultsági modell. Védd az API kulcsodat, és rendszeresen forgasd. ### Csatlakozás a Tajóhoz ```bash tajo connectors install gorgias \ --domain yourstore.gorgias.com \ --email admin@yourstore.com \ --api-key $GORGIAS_API_KEY ``` ## Konfiguráció ### Alapbeállítás ```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 ``` ### Mezőleképezés Képezd le a Gorgias ügyfél- és jegymezőket Brevo kapcsolat-attribútumokhoz: ```yaml 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 ``` ### Esemény-leképezés ```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 végpontok A Tajo az alábbi Gorgias REST API végpontokkal integrálódik: | Végpont | Módszer | Cél | | --- | --- | --- | | `/api/customers` | GET | Ügyfelek listázása | | `/api/customers/{id}` | GET | Ügyfél lekérése | | `/api/customers` | POST | Ügyfél létrehozása | | `/api/customers/{id}` | PUT | Ügyfél frissítése | | `/api/tickets` | GET | Jegyek listázása | | `/api/tickets/{id}` | GET | Jegy lekérése | | `/api/tickets/{id}/messages` | GET | Jegy üzenetek listázása | | `/api/tags` | GET | Címkék listázása | | `/api/satisfaction-surveys` | GET | CSAT felmérések listázása | | `/api/satisfaction-surveys/{id}` | GET | Felmérés lekérése | | `/api/users` | GET | Ügynökök listázása | | `/api/integrations` | GET | Integrációk listázása | | `/api/events` | GET | Események listázása | | `/api/customers/{id}/custom-fields` | GET | Egyéni mező értékek lekérése | ## Kódpéldák ### A konnektor inicializálása ```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 }); ``` ### Ügyfelek szinkronizálása a Brevóba ```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 // } ``` ### Jegy események kezelése HTTP integráción keresztül ```javascript // 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'); }); ``` ### Támogatás utáni kampány ```javascript // 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 adatok szinkronizálása ```javascript // Sync satisfaction survey results to Brevo attributes await tajo.connectors.sync('gorgias', { type: 'incremental', resources: ['satisfaction_surveys'], since: '2024-01-01' }); ``` ## Ráta-korlátok A Gorgias fiókonként alkalmaz ráta-korlátokat: | Korlát típusa | Érték | | --- | --- | | **API ráta-korlát** | 2 kérés/másodperc | | **Burst engedmény** | Legfeljebb 5 kérés rövid ideig | | **Lapozás** | 30 elem/oldal (alapértelmezett), max. 100 | Lapozási stratégia A Gorgias kurzor alapú lapozást használ `cursor` és `limit` paraméterekkel. A Tajo ezt automatikusan kezeli, kérésenként legfeljebb 100 elemet kér a maximális hatékonyságért. A Gorgias `429 Too Many Requests` hibát ad vissza, ha a ráta-korlátokat túllépik. ## Hibaelhárítás ### Gyakori problémák | Probléma | Ok | Megoldás | | --- | --- | --- | | 401 Unauthorized | Érvénytelen e-mail vagy API kulcs | Ellenőrizd a hitelesítő adatokat a Gorgias Beállítások > REST API menüben | | 404 Not Found | Érvénytelen végpont vagy erőforrás azonosító | Ellenőrizd, hogy az API alap URL tartalmazza az aldomaint | | Hiányzó ügyfelek | Nincs e-mail a rekordban | A Gorgias e-mailt igényel az ügyfélegyezéshez | | Nem szinkronizálódnak a címkék | Címkék nincsenek ügyfelekhez rendelve | Ellenőrizd, hogy a címkék ügyfél objektumokon vannak, nem csak jegyeken | | Lassú szinkronizálás | Alacsony ráta-korlát | A Gorgias 2 kérés/mp-re korlátoz; a teljes szinkronizálások hosszabb ideig tartanak | ### Hibakeresési mód ```yaml connectors: gorgias: debug: true log_level: verbose log_api_calls: true ``` ### Kapcsolat tesztelése ```bash tajo connectors test gorgias # ✓ API authentication successful # ✓ Customer list accessible # ✓ Ticket data readable # ✓ CSAT surveys available # ✓ Tags listable ``` ## Legjobb gyakorlatok 1. **Használj HTTP integrációkat valós időhöz** – Konfiguráld a Gorgias szabályokat HTTP kérések küldéséhez a Tajóba jegy eseményeknél 2. **Szinkronizálj rendszeresen CSAT adatokat** – Használj elégedettségi pontszámokat az újra-elköteleződési kampányok vezérléséhez 3. **Képezd le a címkéket szegmensekre** – Fordítsd le a Gorgias ügyfélcímkéket Brevo lista-tagságokká 4. **Kezeld gondosan a lapozást** – 2 kérés/mp korláttal tervezz hosszabb szinkronizálási időkre nagy adathalmazoknál 5. **Kapcsold össze az e-kereskedelmi adatokkal** – Kombináld a Gorgias támogatási adatokat a Shopify rendelési adatokkal a Brevóban 6. **Forgasd az API kulcsokat** – Mivel a Gorgias kulcsok teljes hozzáférést biztosítanak, forgasd őket rendszeresen ## Biztonság - **Basic Auth** – E-mail és API kulcs HTTPS-en keresztül - **Csak HTTPS** – Minden API kommunikáció TLS 1.2+-on keresztül titkosítva - **Teljes hozzáférésű kulcsok** – Nincs részletes hatókör-kezelés (óvd gondosan a kulcsokat) - **IP engedélyezési lista** – Magasabb Gorgias csomagokon elérhető - **Titkosított tárolás** – API hitelesítő adatok titkosítva tárolódnak a Tajóban - **SOC 2 megfelelőség** – A Gorgias platform SOC 2 Type II minősítéssel rendelkezik ## Kapcsolódó források - [Twilio Flex konnektor](https://tajo.io/hu/docs/connectors/custom/twilio-flex) - [Jira konnektor](https://tajo.io/hu/docs/connectors/custom/jira) - [Shopify konnektor](https://tajo.io/hu/docs/connectors/ecommerce/shopify) - [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)