--- title: "Connettore Gorgias" description: "Guida completa all'integrazione di Gorgias per sincronizzare ticket helpdesk, dati cliente ed eventi di supporto con Brevo tramite Tajo." url: https://tajo.io/it/docs/connectors/support/gorgias/ markdown: https://tajo.io/it/docs/connectors/support/gorgias.md lang: it-IT robots: noindex --- Richiedi l’accesso anticipato Inserisci il tuo nome e indirizzo email aziendale. Ti invieremo un link per confermare la richiesta di accesso a Tajo. # Connettore Gorgias Stato del connettore: Pianificato Non ancora realizzato. Oggi Tajo non esegue questo connettore. | Campo di origine | Campo di destinazione | Valore di esempio | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Collega il tuo helpdesk Gorgias a Brevo per un engagement cliente guidato dal supporto, flussi marketing post-ticket e analytics dell’esperienza cliente unificate tramite Tajo. ## Panoramica | Proprietà | Valore | | --- | --- | | **Piattaforma** | Gorgias | | **Categoria** | Supporto | | **Complessità di setup** | Facile | | **Integrazione ufficiale** | No | | **Dati sincronizzati** | Clienti, Ticket, Eventi | | **Tipo API** | REST API | | **Autenticazione** | Chiave API + Email (Basic Auth) | | **Base URL** | `https://{domain}.gorgias.com/api/` | ## Funzionalità - **Sync eventi ticket** - Inoltra eventi di creazione, risoluzione e CSAT ticket alle timeline Brevo - **Arricchimento profilo cliente** - Sincronizza i dati cliente Gorgias inclusi tag e campi personalizzati a Brevo - **Campagne post-supporto** - Attiva workflow Brevo dopo la risoluzione ticket per follow-up o upsell - **Tracciamento soddisfazione** - Sincronizza i risultati dei sondaggi CSAT come attributi di contatto Brevo - **Segmentazione basata su tag** - Replica i tag clienti Gorgias come appartenenze a liste Brevo - **Eventi macro e regole** - Traccia azioni automatizzate per analytics operative ## Prerequisiti Prima di iniziare, assicurati di avere: 1. Un account Gorgias con accesso admin 2. Il tuo subdomain Gorgias (es. `yourstore.gorgias.com`) 3. Una chiave API e l’indirizzo email associato 4. Un account Brevo con accesso API 5. Un account Tajo con un abbonamento attivo ## Autenticazione Gorgias utilizza HTTP Basic Authentication con l’email del tuo account e la chiave API. ### Creazione di una chiave API 1. Accedi alla tua dashboard Gorgias 2. Vai in **Settings** > **REST API** 3. Clicca su **Create API Key** (o copia la chiave esistente) 4. Annota l’URL base API: `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" ``` Permessi della chiave API Le chiavi API Gorgias hanno accesso completo ai dati del tuo account. Non esiste un modello di permessi basato su scope. Proteggi la tua chiave API e ruotala regolarmente. ### Connessione a Tajo ```bash tajo connectors install gorgias \ --domain yourstore.gorgias.com \ --email admin@yourstore.com \ --api-key $GORGIAS_API_KEY ``` ## Configurazione ### Setup di base ```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 ``` ### Mappatura dei campi Mappa i campi cliente e ticket Gorgias agli attributi di contatto Brevo: ```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 ``` ### Mappatura degli eventi ```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 ``` ## Endpoint API Tajo si integra con i seguenti endpoint REST API Gorgias: | Endpoint | Metodo | Scopo | | --- | --- | --- | | `/api/customers` | GET | Elenca i clienti | | `/api/customers/{id}` | GET | Recupera un cliente | | `/api/customers` | POST | Crea un cliente | | `/api/customers/{id}` | PUT | Aggiorna un cliente | | `/api/tickets` | GET | Elenca i ticket | | `/api/tickets/{id}` | GET | Recupera un ticket | | `/api/tickets/{id}/messages` | GET | Elenca i messaggi del ticket | | `/api/tags` | GET | Elenca i tag | | `/api/satisfaction-surveys` | GET | Elenca i sondaggi CSAT | | `/api/satisfaction-surveys/{id}` | GET | Recupera un sondaggio | | `/api/users` | GET | Elenca gli agent | | `/api/integrations` | GET | Elenca le integrazioni | | `/api/events` | GET | Elenca gli eventi | | `/api/customers/{id}/custom-fields` | GET | Ottieni i valori dei campi personalizzati | ## Esempi di codice ### Inizializza il connettore ```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 }); ``` ### Sincronizza i clienti su 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 // } ``` ### Gestisci eventi ticket via integrazione HTTP ```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'); }); ``` ### Campagna post-risoluzione ```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 } }); } }); ``` ### Sincronizza i dati CSAT ```javascript // Sync satisfaction survey results to Brevo attributes await tajo.connectors.sync('gorgias', { type: 'incremental', resources: ['satisfaction_surveys'], since: '2024-01-01' }); ``` ## Limiti di velocità Gorgias applica limiti di velocità per account: | Tipo di limite | Valore | | --- | --- | | **Limite di velocità API** | 2 richieste al secondo | | **Burst allowance** | Fino a 5 richieste in burst brevi | | **Paginazione** | 30 elementi per pagina (default), max 100 | Strategia di paginazione Gorgias usa la paginazione cursor-based con i parametri `cursor` e `limit`. Tajo gestisce questo automaticamente, richiedendo fino a 100 elementi per pagina per la massima efficienza. Gorgias restituisce `429 Too Many Requests` quando i limiti di velocità vengono superati. ## Risoluzione dei problemi ### Problemi comuni | Problema | Causa | Soluzione | | --- | --- | --- | | 401 Unauthorized | Email o chiave API non validi | Verifica le credenziali in Gorgias Settings > REST API | | 404 Not Found | Endpoint o ID risorsa non valido | Controlla che l’URL base API includa il tuo subdomain | | Clienti mancanti | Nessuna email registrata | Gorgias richiede l’email per il matching dei clienti | | Tag non sincronizzati | Tag non assegnati ai clienti | Verifica che i tag siano sugli oggetti cliente, non solo sui ticket | | Sync lenta | Limite di velocità basso | Gorgias limita a 2 req/s; le sync complete richiedono più tempo | ### Modalità debug ```yaml connectors: gorgias: debug: true log_level: verbose log_api_calls: true ``` ### Testa la connessione ```bash tajo connectors test gorgias # ✓ API authentication successful # ✓ Customer list accessible # ✓ Ticket data readable # ✓ CSAT surveys available # ✓ Tags listable ``` ## Best practice 1. **Usa le integrazioni HTTP per il tempo reale** - Configura le Rules Gorgias per inviare richieste HTTP a Tajo su eventi ticket 2. **Sincronizza i dati CSAT regolarmente** - Usa i punteggi di soddisfazione per guidare campagne di re-engagement 3. **Mappa i tag ai segmenti** - Traduci i tag clienti Gorgias in appartenenze a liste Brevo 4. **Gestisci con attenzione la paginazione** - Con limiti di 2 req/s, pianifica tempi di sync più lunghi su dataset grandi 5. **Collega i dati e-commerce** - Combina i dati di supporto Gorgias con i dati ordine Shopify in Brevo 6. **Ruota le chiavi API** - Poiché le chiavi Gorgias hanno accesso completo, ruotale periodicamente ## Sicurezza - **Basic Auth** - Email e chiave API su HTTPS - **Solo HTTPS** - Tutte le comunicazioni API cifrate via TLS 1.2+ - **Chiavi ad accesso completo** - Nessuno scoping granulare (proteggi le chiavi con cura) - **IP Allowlisting** - Disponibile sui piani Gorgias superiori - **Storage cifrato** - Credenziali API cifrate a riposo in Tajo - **Conformità SOC 2** - La piattaforma Gorgias è certificata SOC 2 Type II ## Risorse correlate - [Connettore Twilio Flex](https://tajo.io/it/docs/connectors/custom/twilio-flex) - [Connettore Jira](https://tajo.io/it/docs/connectors/custom/jira) - [Connettore Shopify](https://tajo.io/it/docs/connectors/ecommerce/shopify) - [API Contatti Brevo](https://tajo.io/it/docs/contact-management)