--- title: "Gorgias-koppling" description: "Komplett integrationsguide för Gorgias för att synkronisera helpdesk-ärenden, kunddata och supporthändelser med Brevo via Tajo." url: https://tajo.io/se/docs/connectors/support/gorgias/ markdown: https://tajo.io/se/docs/connectors/support/gorgias.md lang: sv-SE robots: noindex --- Ansök om tidig åtkomst Ange ditt förnamn och din e-postadress på jobbet. Vi skickar en länk för att bekräfta din begäran om åtkomst till Tajo. # Gorgias-koppling Kopplingens status: Planerad Inte byggd än. Tajo kör inte den här kopplingen i dag. | Källfält | Målfält | Exempelvärde | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Anslut din Gorgias-helpdesk till Brevo för supportdrivet kundengagemang, marknadsföringsflöden efter ärende och enhetlig kundupplevelseanalys via Tajo. ## Översikt | Egenskap | Värde | | --- | --- | | **Plattform** | Gorgias | | **Kategori** | Support | | **Installationskomplexitet** | Enkel | | **Officiell integration** | Nej | | **Data som synkas** | Kunder, ärenden, händelser | | **API-typ** | REST API | | **Autentisering** | API-nyckel + e-post (Basic Auth) | | **Bas-URL** | `https://{domain}.gorgias.com/api/` | ## Funktioner - **Synk av ärendehändelser** - Vidarebefordra händelser för ärendeskapande, lösning och CSAT till Brevo-tidslinjer - **Berikning av kundprofil** - Synka Gorgias-kunddata inklusive taggar och anpassade fält till Brevo - **Kampanjer efter support** - Utlös Brevo-arbetsflöden efter ärendelösning för uppföljning eller merförsäljning - **Nöjdhetsspårning** - Synka resultat från CSAT-enkäter som Brevo-kontaktattribut - **Taggbaserad segmentering** - Spegla Gorgias kundtaggar som Brevo-listmedlemskap - **Makro- och regelhändelser** - Spåra automatiserade åtgärder för operativ analys ## Förutsättningar Innan du börjar, se till att du har: 1. Ett Gorgias-konto med adminåtkomst 2. Din Gorgias-subdomän (t.ex. `yourstore.gorgias.com`) 3. En API-nyckel och tillhörande e-postadress 4. Ett Brevo-konto med API-åtkomst 5. Ett Tajo-konto med en aktiv prenumeration ## Autentisering Gorgias använder HTTP Basic Authentication med din konto-e-post och API-nyckel. ### Skapa en API-nyckel 1. Logga in på din Gorgias-instrumentpanel 2. Navigera till **Settings** > **REST API** 3. Klicka på **Create API Key** (eller kopiera befintlig nyckel) 4. Notera din API-bas-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-nyckelbehörigheter Gorgias API-nycklar har full åtkomst till dina kontodata. Det finns ingen scope-baserad behörighetsmodell. Skydda din API-nyckel och rotera den regelbundet. ### Anslutning till Tajo ```bash tajo connectors install gorgias \ --domain yourstore.gorgias.com \ --email admin@yourstore.com \ --api-key $GORGIAS_API_KEY ``` ## Konfiguration ### Grundinställning ```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 ``` ### Fältmappning Mappa Gorgias kund- och ärendefält till Brevo-kontaktattribut: ```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ändelsemappning ```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 integrerar med följande Gorgias REST API-endpoints: | Endpoint | Metod | Syfte | | --- | --- | --- | | `/api/customers` | GET | Lista kunder | | `/api/customers/{id}` | GET | Hämta en kund | | `/api/customers` | POST | Skapa en kund | | `/api/customers/{id}` | PUT | Uppdatera en kund | | `/api/tickets` | GET | Lista ärenden | | `/api/tickets/{id}` | GET | Hämta ett ärende | | `/api/tickets/{id}/messages` | GET | Lista ärendemeddelanden | | `/api/tags` | GET | Lista taggar | | `/api/satisfaction-surveys` | GET | Lista CSAT-enkäter | | `/api/satisfaction-surveys/{id}` | GET | Hämta en enkät | | `/api/users` | GET | Lista agenter | | `/api/integrations` | GET | Lista integrationer | | `/api/events` | GET | Lista händelser | | `/api/customers/{id}/custom-fields` | GET | Hämta värden för anpassade fält | ## Kodexempel ### Initiera kopplingen ```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 }); ``` ### Synka kunder till 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 // } ``` ### Hantera ärendehä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'); }); ``` ### Kampanj 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 } }); } }); ``` ### Synka CSAT-data ```javascript // Sync satisfaction survey results to Brevo attributes await tajo.connectors.sync('gorgias', { type: 'incremental', resources: ['satisfaction_surveys'], since: '2024-01-01' }); ``` ## Hastighetsbegränsningar Gorgias tillämpar hastighetsbegränsningar per konto: | Gränstyp | Värde | | --- | --- | | **API-hastighetsbegränsning** | 2 förfrågningar per sekund | | **Burst-tillåtelse** | Upp till 5 förfrågningar i korta toppar | | **Sidindelning** | 30 objekt per sida (standard), max 100 | Strategi för sidindelning Gorgias använder markörbaserad sidindelning med parametrarna `cursor` och `limit`. Tajo hanterar detta automatiskt och begär upp till 100 objekt per sida för maximal effektivitet. Gorgias returnerar `429 Too Many Requests` när hastighetsbegränsningar överskrids. ## Felsökning ### Vanliga problem | Problem | Orsak | Lösning | | --- | --- | --- | | 401 Unauthorized | Ogiltig e-post eller API-nyckel | Verifiera uppgifter i Gorgias Settings > REST API | | 404 Not Found | Ogiltig endpoint eller resurs-ID | Kontrollera att API-bas-URL inkluderar din subdomän | | Kunder saknas | Ingen e-post i posten | Gorgias kräver e-post för kundmatchning | | Taggar synkas inte | Taggar ej tilldelade kunder | Verifiera att taggar finns på kundobjekt, inte bara på ärenden | | Långsam synk | Låg hastighetsbegränsning | Gorgias begränsar till 2 förf/sek; fullsynkar tar längre | ### Felsökningsläge ```yaml connectors: gorgias: debug: true log_level: verbose log_api_calls: true ``` ### Testa anslutning ```bash tajo connectors test gorgias # ✓ API authentication successful # ✓ Customer list accessible # ✓ Ticket data readable # ✓ CSAT surveys available # ✓ Tags listable ``` ## Bästa praxis 1. **Använd HTTP-integrationer för realtid** - Konfigurera Gorgias Rules att skicka HTTP-förfrågningar till Tajo vid ärendehändelser 2. **Synka CSAT-data regelbundet** - Använd nöjdhetspoäng för att driva återengagemangskampanjer 3. **Mappa taggar till segment** - Översätt Gorgias kundtaggar till Brevo-listmedlemskap 4. **Hantera sidindelning noggrant** - Med 2 förf/sek-gränser, planera för längre synktider på stora dataset 5. **Länka till e-handelsdata** - Kombinera Gorgias supportdata med Shopify-orderdata i Brevo 6. **Rotera API-nycklar** - Eftersom Gorgias-nycklar har full åtkomst, rotera dem regelbundet ## Säkerhet - **Basic Auth** - E-post och API-nyckel över HTTPS - **Endast HTTPS** - All API-kommunikation krypterad via TLS 1.2+ - **Nycklar med full åtkomst** - Ingen granulär scoping (skydda nycklar noggrant) - **IP-allowlisting** - Tillgängligt på högre Gorgias-planer - **Krypterad lagring** - API-uppgifter krypterade i vila i Tajo - **SOC 2-efterlevnad** - Gorgias-plattformen är SOC 2 Type II-certifierad ## Relaterade resurser - [Twilio Flex-koppling](https://tajo.io/se/docs/connectors/custom/twilio-flex) - [Jira-koppling](https://tajo.io/se/docs/connectors/custom/jira) - [Shopify-koppling](https://tajo.io/se/docs/connectors/ecommerce/shopify) - [Brevo Contacts API](https://tajo.io/se/docs/contact-management)