--- title: "Gorgias Connector" description: "Komplet guide til Gorgias-integration til synkronisering af helpdesk-sager, kundedata og supporthændelser med Brevo via Tajo." url: https://tajo.io/dk/docs/connectors/support/gorgias/ markdown: https://tajo.io/dk/docs/connectors/support/gorgias.md lang: da-DK robots: noindex --- Bed om tidlig adgang til Tajo Indtast dit fornavn og din arbejds-e-mailadresse. Vi sender dig et link til at bekræfte din anmodning om adgang til Tajo. # Gorgias Connector Connectorstatus: Planlagt Ikke bygget endnu. Tajo kører ikke denne connector i dag. | Kildefelt | Destinationsfelt | Eksempelværdi | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Forbind din Gorgias-helpdesk til Brevo for supportdrevet kundeengagement, marketing-flows efter sag og forenet kundeoplevelsesanalyse via Tajo. ## Oversigt | Egenskab | Værdi | | --- | --- | | **Platform** | Gorgias | | **Kategori** | Support | | **Opsætningskompleksitet** | Let | | **Officiel integration** | Nej | | **Synkroniserede data** | Kunder, sager, hændelser | | **API-type** | REST API | | **Autentifikation** | API-nøgle + e-mail (Basic Auth) | | **Base-URL** | `https://{domain}.gorgias.com/api/` | ## Funktioner - **Synkronisering af sagshændelser** - Videresend sagsoprettelse, -løsning og CSAT-hændelser til Brevo-tidslinjer - **Berigelse af kundeprofiler** - Synkronisér Gorgias-kundedata inklusive tags og brugerdefinerede felter til Brevo - **Kampagner efter support** - Udløs Brevo-workflows efter sagsløsning til opfølgning eller upsell - **Tilfredshedssporing** - Synkronisér CSAT-undersøgelsesresultater som Brevo-kontaktattributter - **Tagbaseret segmentering** - Spejl Gorgias-kundetags som Brevo-listemedlemskaber - **Makro- og regelhændelser** - Spor automatiserede handlinger til operationel analyse ## Forudsætninger Før du begynder, skal du sikre dig, at du har: 1. En Gorgias-konto med administratoradgang 2. Dit Gorgias-underdomæne (f.eks. `yourstore.gorgias.com`) 3. En API-nøgle og tilknyttet e-mailadresse 4. En Brevo-konto med API-adgang 5. En Tajo-konto med et aktivt abonnement ## Autentifikation Gorgias bruger HTTP Basic-autentifikation med din konto-e-mail og API-nøgle. ### Oprettelse af en API-nøgle 1. Log ind på dit Gorgias-dashboard 2. Navigér til **Settings** > **REST API** 3. Klik **Create API Key** (eller kopiér eksisterende nøgle) 4. Notér din API-base-URL: `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-nøglerettigheder Gorgias API-nøgler har fuld adgang til dine kontodata. Der er ingen scope-baseret rettighedsmodel. Beskyt din API-nøgle, og rotér den regelmæssigt. ### Forbind til Tajo ```bash tajo connectors install gorgias \ --domain yourstore.gorgias.com \ --email admin@yourstore.com \ --api-key $GORGIAS_API_KEY ``` ## Konfiguration ### Grundlæggende opsætning ```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 ``` ### Feltmapping Knyt Gorgias-kunde- og sagsfelter til Brevo-kontaktattributter: ```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 ``` ### Hændelsesmapping ```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 integrerer med følgende Gorgias REST API-endpoints: | Endpoint | Metode | Formål | | --- | --- | --- | | `/api/customers` | GET | Vis kunder | | `/api/customers/{id}` | GET | Hent en kunde | | `/api/customers` | POST | Opret en kunde | | `/api/customers/{id}` | PUT | Opdatér en kunde | | `/api/tickets` | GET | Vis sager | | `/api/tickets/{id}` | GET | Hent en sag | | `/api/tickets/{id}/messages` | GET | Vis sagsbeskeder | | `/api/tags` | GET | Vis tags | | `/api/satisfaction-surveys` | GET | Vis CSAT-undersøgelser | | `/api/satisfaction-surveys/{id}` | GET | Hent en undersøgelse | | `/api/users` | GET | Vis agenter | | `/api/integrations` | GET | Vis integrationer | | `/api/events` | GET | Vis hændelser | | `/api/customers/{id}/custom-fields` | GET | Hent brugerdefinerede feltværdier | ## Kodeeksempler ### Initialisér konnektor ```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 }); ``` ### Synkronisér kunder til 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 // } ``` ### Håndtér sagshændelser via HTTP-integration ```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'); }); ``` ### Kampagne efter løsning ```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 } }); } }); ``` ### Synkronisér CSAT-data ```javascript // Sync satisfaction survey results to Brevo attributes await tajo.connectors.sync('gorgias', { type: 'incremental', resources: ['satisfaction_surveys'], since: '2024-01-01' }); ``` ## Ratebegrænsninger Gorgias håndhæver ratebegrænsninger per konto: | Grænsetype | Værdi | | --- | --- | | **API-ratebegrænsning** | 2 forespørgsler per sekund | | **Burst-tilladelse** | Op til 5 forespørgsler i korte bursts | | **Paginering** | 30 elementer per side (standard), maks. 100 | Pagineringsstrategi Gorgias bruger cursor-baseret paginering med `cursor`- og `limit`-parametre. Tajo håndterer dette automatisk og anmoder om op til 100 elementer per side for maksimal effektivitet. Gorgias returnerer `429 Too Many Requests`, når ratebegrænsninger overskrides. ## Fejlfinding ### Almindelige problemer | Problem | Årsag | Løsning | | --- | --- | --- | | 401 Unauthorized | Ugyldig e-mail eller API-nøgle | Verificér legitimationsoplysninger i Gorgias Settings > REST API | | 404 Not Found | Ugyldigt endpoint eller ressource-id | Tjek, at API-base-URL inkluderer dit underdomæne | | Kunder mangler | Ingen e-mail på post | Gorgias kræver e-mail til kundematch | | Tags synkroniseres ikke | Tags ikke tildelt kunder | Verificér, at tags er på kundeobjekter, ikke kun sager | | Langsom synkronisering | Lav ratebegrænsning | Gorgias begrænser til 2 req/s; fulde synkroniseringer tager længere | ### Fejlfindingstilstand ```yaml connectors: gorgias: debug: true log_level: verbose log_api_calls: true ``` ### Test forbindelse ```bash tajo connectors test gorgias # ✓ API authentication successful # ✓ Customer list accessible # ✓ Ticket data readable # ✓ CSAT surveys available # ✓ Tags listable ``` ## Best practices 1. **Brug HTTP-integrationer til realtid** - Konfigurér Gorgias Rules til at sende HTTP-forespørgsler til Tajo ved sagshændelser 2. **Synkronisér CSAT-data regelmæssigt** - Brug tilfredshedsscores til at drive genengagementkampagner 3. **Map tags til segmenter** - Oversæt Gorgias-kundetags til Brevo-listemedlemskaber 4. **Håndtér paginering omhyggeligt** - Med grænser på 2 req/s skal du planlægge længere synkroniseringstider for store datasæt 5. **Forbind til e-handelsdata** - Kombinér Gorgias-supportdata med Shopify-ordredata i Brevo 6. **Rotér API-nøgler** - Da Gorgias-nøgler har fuld adgang, bør du rotere dem regelmæssigt ## Sikkerhed - **Basic Auth** - E-mail og API-nøgle over HTTPS - **Kun HTTPS** - Al API-kommunikation krypteret via TLS 1.2+ - **Nøgler med fuld adgang** - Ingen granulær scoping (beskyt nøgler omhyggeligt) - **IP-allowlisting** - Tilgængelig på højere Gorgias-planer - **Krypteret lagring** - API-legitimationsoplysninger krypteres i hvile i Tajo - **SOC 2-overholdelse** - Gorgias-platformen er SOC 2 Type II-certificeret ## Relaterede ressourcer - [Twilio Flex Connector](https://tajo.io/dk/docs/connectors/custom/twilio-flex) - [Jira Connector](https://tajo.io/dk/docs/connectors/custom/jira) - [Shopify Connector](https://tajo.io/dk/docs/connectors/ecommerce/shopify) - [Brevo Contacts API](https://tajo.io/dk/docs/contact-management)