--- title: "Gorgias-kobling" description: "Fullstendig Gorgias-integrasjonsveiledning for synkronisering av helpdesk-saker, kundedata og supporthendelser med Brevo via Tajo." url: https://tajo.io/no/docs/connectors/support/gorgias/ markdown: https://tajo.io/no/docs/connectors/support/gorgias.md lang: no-NO robots: noindex --- Be om tidlig tilgang Skriv inn fornavn og e-postadresse på jobb. Vi sender deg en lenke for å bekrefte forespørselen om tilgang til Tajo. # Gorgias-kobling Koblingsstatus: Planlagt Ikke bygget ennå. Tajo kjører ikke denne koblingen i dag. | Kildefelt | Målfelt | Eksempelverdi | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Koble Gorgias-helpdesken din til Brevo for supportdrevet kundeengasjement, markedsføringsflyter etter saker og enhetlig kundeopplevelsesanalyse gjennom Tajo. ## Oversikt | Egenskap | Verdi | | --- | --- | | **Plattform** | Gorgias | | **Kategori** | Support | | **Oppsettskompleksitet** | Enkel | | **Offisiell integrasjon** | Nei | | **Synkroniserte data** | Kunder, saker, hendelser | | **API-type** | REST API | | **Autentisering** | API-nøkkel + e-post (Basic Auth) | | **Base URL** | `https://{domain}.gorgias.com/api/` | ## Funksjoner - **Synkronisering av sakshendelser** - Videresend hendelser for saksopprettelse, løsning og CSAT til Brevo-tidslinjer - **Berikelse av kundeprofiler** - Synkroniser Gorgias-kundedata, inkludert tagger og egendefinerte felt, til Brevo - **Kampanjer etter support** - Utløs Brevo-arbeidsflyter etter saksløsning for oppfølging eller mersalg - **Tilfredshetssporing** - Synkroniser CSAT-undersøkelsesresultater som Brevo-kontaktattributter - **Tag-basert segmentering** - Speil Gorgias-kundetagger som Brevo-listemedlemskap - **Makro- og regel-hendelser** - Spor automatiserte handlinger for operasjonell analyse ## Forutsetninger Før du begynner, sørg for at du har: 1. En Gorgias-konto med administratortilgang 2. Ditt Gorgias-subdomene (f.eks. `yourstore.gorgias.com`) 3. En API-nøkkel og tilhørende e-postadresse 4. En Brevo-konto med API-tilgang 5. En Tajo-konto med aktivt abonnement ## Autentisering Gorgias bruker HTTP Basic Authentication med kontoens e-post og API-nøkkel. ### Opprette en API-nøkkel 1. Logg inn på Gorgias-dashbordet ditt 2. Gå til **Settings** > **REST API** 3. Klikk **Create API Key** (eller kopier eksisterende nøkkel) 4. Noter API-basis-URL: `https://{domain}.gorgias.com/api/` ```bash # Basic Auth: e-post som brukernavn, API-nøkkel som passord curl -X GET "https://yourstore.gorgias.com/api/customers" \ -u "admin@yourstore.com:$GORGIAS_API_KEY" \ -H "Content-Type: application/json" ``` Rettigheter for API-nøkkel Gorgias API-nøkler har full tilgang til kontoens data. Det finnes ingen scope-basert rettighetsmodell. Beskytt API-nøkkelen din og roter den regelmessig. ### Koble til Tajo ```bash tajo connectors install gorgias \ --domain yourstore.gorgias.com \ --email admin@yourstore.com \ --api-key $GORGIAS_API_KEY ``` ## Konfigurasjon ### Grunnleggende oppsett ```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 Mapp Gorgias-kunde- og saksfelt til Brevo-kontaktattributter: ```yaml field_mapping: # Kundefelt id: GORGIAS_ID email: email name: FIRSTNAME phone: SMS # Supportmålinger 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 # Egendefinerte felt customer_type: CUSTOMER_TYPE vip_status: VIP_STATUS ``` ### Hendelsesmapping ```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-endepunkter Tajo integrerer med følgende Gorgias REST API-endepunkter: | Endepunkt | Metode | Formål | | --- | --- | --- | | `/api/customers` | GET | List kunder | | `/api/customers/{id}` | GET | Hent en kunde | | `/api/customers` | POST | Opprett en kunde | | `/api/customers/{id}` | PUT | Oppdater en kunde | | `/api/tickets` | GET | List saker | | `/api/tickets/{id}` | GET | Hent en sak | | `/api/tickets/{id}/messages` | GET | List saksmeldinger | | `/api/tags` | GET | List tagger | | `/api/satisfaction-surveys` | GET | List CSAT-undersøkelser | | `/api/satisfaction-surveys/{id}` | GET | Hent en undersøkelse | | `/api/users` | GET | List agenter | | `/api/integrations` | GET | List integrasjoner | | `/api/events` | GET | List hendelser | | `/api/customers/{id}/custom-fields` | GET | Hent verdier for egendefinerte felt | ## Kodeeksempler ### Initialiser kobling ```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 }); ``` ### Synkroniser 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åndter sakshendelser via HTTP-integrasjon ```javascript // Gorgias kan sende HTTP-forespørsler via Rules eller HTTP-integrasjoner 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'); }); ``` ### Kampanje etter løsning ```javascript // Utløs en oppfølgings-e-post etter at en supportsak er løst 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 } }); } }); ``` ### Synkroniser CSAT-data ```javascript // Synkroniser tilfredshetsundersøkelsesresultater til Brevo-attributter await tajo.connectors.sync('gorgias', { type: 'incremental', resources: ['satisfaction_surveys'], since: '2024-01-01' }); ``` ## Ratebegrensninger Gorgias håndhever ratebegrensninger per konto: | Begrensningstype | Verdi | | --- | --- | | **API-ratebegrensning** | 2 forespørsler per sekund | | **Burst-tillatelse** | Opptil 5 forespørsler i korte bursts | | **Paginering** | 30 elementer per side (standard), maks 100 | Pagineringsstrategi Gorgias bruker markørbasert paginering med `cursor`- og `limit`-parametere. Tajo håndterer dette automatisk, og ber om opptil 100 elementer per side for maksimal effektivitet. Gorgias returnerer `429 Too Many Requests` når ratebegrensninger overskrides. ## Feilsøking ### Vanlige problemer | Problem | Årsak | Løsning | | --- | --- | --- | | 401 Unauthorized | Ugyldig e-post eller API-nøkkel | Verifiser påloggingsdetaljer i Gorgias Settings > REST API | | 404 Not Found | Ugyldig endepunkt eller ressurs-ID | Sjekk at API-basis-URL inneholder subdomenet ditt | | Kunder mangler | Ingen e-post registrert | Gorgias krever e-post for kundematching | | Tagger synkroniseres ikke | Tagger ikke tildelt kunder | Verifiser at tagger er på kundeobjekter, ikke bare saker | | Treg synkronisering | Lav ratebegrensning | Gorgias begrenser til 2 forespørsler/s; full synkronisering tar lengre tid | ### Feilsøkingsmodus ```yaml connectors: gorgias: debug: true log_level: verbose log_api_calls: true ``` ### Test tilkobling ```bash tajo connectors test gorgias # ✓ API-autentisering vellykket # ✓ Kundeliste tilgjengelig # ✓ Saksdata lesbare # ✓ CSAT-undersøkelser tilgjengelige # ✓ Tagger listbare ``` ## Beste praksis 1. **Bruk HTTP-integrasjoner for sanntid** - Konfigurer Gorgias Rules til å sende HTTP-forespørsler til Tajo ved sakshendelser 2. **Synkroniser CSAT-data regelmessig** - Bruk tilfredshetsscore for å drive re-engasjementskampanjer 3. **Mapp tagger til segmenter** - Oversett Gorgias-kundetagger til Brevo-listemedlemskap 4. **Håndter paginering nøye** - Med 2 forespørsler/s-grensen, planlegg for lengre synkroniseringstider på store datasett 5. **Koble til e-handelsdata** - Kombiner Gorgias-supportdata med Shopify-ordredata i Brevo 6. **Roter API-nøkler** - Siden Gorgias-nøkler har full tilgang, roter dem regelmessig ## Sikkerhet - **Basic Auth** - E-post og API-nøkkel over HTTPS - **Kun HTTPS** - All API-kommunikasjon kryptert via TLS 1.2+ - **Full Access-nøkler** - Ingen granulær scoping (beskytt nøkler nøye) - **IP-hviteliste** - Tilgjengelig på høyere Gorgias-planer - **Kryptert lagring** - API-påloggingsdetaljer kryptert i hvilemodus i Tajo - **SOC 2-samsvar** - Gorgias-plattformen er SOC 2 Type II-sertifisert ## Relaterte ressurser - [Twilio Flex-kobling](https://tajo.io/no/docs/connectors/custom/twilio-flex) - [Jira-kobling](https://tajo.io/no/docs/connectors/custom/jira) - [Shopify-kobling](https://tajo.io/no/docs/connectors/ecommerce/shopify) - [Brevo Contacts API](https://tajo.io/no/docs/contact-management)