---
title: "Conector de Gorgias"
description: "Guía completa de integración con Gorgias para sincronizar tickets de helpdesk, datos de clientes y eventos de soporte con Brevo a través de Tajo."
url: https://tajo.io/es/docs/connectors/support/gorgias/
markdown: https://tajo.io/es/docs/connectors/support/gorgias.md
lang: es-ES
robots: noindex
---

Solicita acceso anticipado

Escribe tu nombre y dirección de correo de trabajo. Te enviaremos un enlace para confirmar tu solicitud de acceso a Tajo.

# Conector de Gorgias

Estado del conector: Planificado Aún no está construido. Tajo no ejecuta este conector hoy.

| Campo de origen | Campo de destino | Valor de ejemplo |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Conecta tu helpdesk de Gorgias con Brevo para impulsar la interacción con el cliente basada en soporte, flujos de marketing posventa y análisis unificados de la experiencia del cliente a través de Tajo.

## Resumen

| Propiedad | Valor |
| --- | --- |
| **Plataforma** | Gorgias |
| **Categoría** | Soporte |
| **Complejidad de configuración** | Fácil |
| **Integración oficial** | No |
| **Datos sincronizados** | Clientes, Tickets, Eventos |
| **Tipo de API** | REST API |
| **Autenticación** | Clave API + Email (Basic Auth) |
| **URL base** | `https://{domain}.gorgias.com/api/` |

## Funcionalidades

- **Sincronización de eventos de tickets** - Reenvía la creación, resolución y eventos CSAT de tickets a las líneas de tiempo de Brevo
- **Enriquecimiento de perfiles de cliente** - Sincroniza los datos de cliente de Gorgias, incluyendo etiquetas y campos personalizados, con Brevo
- **Campañas posventa** - Activa flujos de Brevo tras la resolución de un ticket para seguimiento o upsell
- **Seguimiento de satisfacción** - Sincroniza los resultados de las encuestas CSAT como atributos de contacto en Brevo
- **Segmentación por etiquetas** - Refleja las etiquetas de cliente de Gorgias como pertenencias a listas de Brevo
- **Eventos de macros y reglas** - Registra las acciones automatizadas para la analítica operativa

## Requisitos previos

Antes de empezar, asegúrate de tener:

1. Una cuenta de Gorgias con acceso de administrador
2. Tu subdominio de Gorgias (por ejemplo, `yourstore.gorgias.com`)
3. Una clave API y la dirección de email asociada
4. Una cuenta de Brevo con acceso a la API
5. Una cuenta de Tajo con suscripción activa

## Autenticación

Gorgias usa autenticación HTTP Basic con el email de tu cuenta y tu clave API.

### Crear una clave API

1. Inicia sesión en tu panel de Gorgias
2. Ve a **Settings** > **REST API**
3. Haz clic en **Create API Key** (o copia la clave existente)
4. Anota tu URL base de la 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"
```

Permisos de la clave API

Las claves API de Gorgias tienen acceso completo a los datos de tu cuenta. No existe un modelo de permisos basado en scopes. Protege tu clave API y rótala con frecuencia.

### Conectar con Tajo

```bash
tajo connectors install gorgias \
  --domain yourstore.gorgias.com \
  --email admin@yourstore.com \
  --api-key $GORGIAS_API_KEY
```

## Configuración

### Configuración básica

```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
```

### Asignación de campos

Asocia los campos de cliente y ticket de Gorgias con atributos de contacto de 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
```

### Asignación de eventos

```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
```

## Endpoints de la API

Tajo se integra con los siguientes endpoints de la REST API de Gorgias:

| Endpoint | Método | Propósito |
| --- | --- | --- |
| `/api/customers` | GET | Listar clientes |
| `/api/customers/{id}` | GET | Obtener un cliente |
| `/api/customers` | POST | Crear un cliente |
| `/api/customers/{id}` | PUT | Actualizar un cliente |
| `/api/tickets` | GET | Listar tickets |
| `/api/tickets/{id}` | GET | Obtener un ticket |
| `/api/tickets/{id}/messages` | GET | Listar mensajes de un ticket |
| `/api/tags` | GET | Listar etiquetas |
| `/api/satisfaction-surveys` | GET | Listar encuestas CSAT |
| `/api/satisfaction-surveys/{id}` | GET | Obtener una encuesta |
| `/api/users` | GET | Listar agentes |
| `/api/integrations` | GET | Listar integraciones |
| `/api/events` | GET | Listar eventos |
| `/api/customers/{id}/custom-fields` | GET | Obtener valores de campos personalizados |

## Ejemplos de código

### Inicializar el conector

```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
});
```

### Sincronizar clientes con 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
// }
```

### Gestionar eventos de tickets mediante integración 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');
});
```

### Campaña posterior a la resolución

```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
      }
    });
  }
});
```

### Sincronizar datos CSAT

```javascript
// Sync satisfaction survey results to Brevo attributes
await tajo.connectors.sync('gorgias', {
  type: 'incremental',
  resources: ['satisfaction_surveys'],
  since: '2024-01-01'
});
```

## Límites de velocidad

Gorgias aplica límites de velocidad por cuenta:

| Tipo de límite | Valor |
| --- | --- |
| **Límite de velocidad de la API** | 2 peticiones por segundo |
| **Tolerancia de ráfaga** | Hasta 5 peticiones en ráfagas cortas |
| **Paginación** | 30 elementos por página (predeterminado), máx. 100 |

Estrategia de paginación

Gorgias usa paginación basada en cursor con los parámetros `cursor` y `limit`. Tajo lo gestiona automáticamente, solicitando hasta 100 elementos por página para una eficiencia máxima.

Gorgias devuelve `429 Too Many Requests` cuando se superan los límites de velocidad.

## Resolución de problemas

### Problemas habituales

| Problema | Causa | Solución |
| --- | --- | --- |
| 401 Unauthorized | Email o clave API no válidos | Verifica las credenciales en Gorgias Settings > REST API |
| 404 Not Found | Endpoint o ID de recurso no válido | Comprueba que la URL base de la API incluye tu subdominio |
| Clientes ausentes | Sin email registrado | Gorgias requiere email para emparejar clientes |
| Las etiquetas no se sincronizan | Etiquetas no asignadas a los clientes | Verifica que las etiquetas están en los objetos de cliente, no solo en los tickets |
| Sincronización lenta | Límite de velocidad bajo | Gorgias limita a 2 req/s; las sincronizaciones completas tardan más |

### Modo depuración

```yaml
connectors:
  gorgias:
    debug: true
    log_level: verbose
    log_api_calls: true
```

### Probar la conexión

```bash
tajo connectors test gorgias
# ✓ API authentication successful
# ✓ Customer list accessible
# ✓ Ticket data readable
# ✓ CSAT surveys available
# ✓ Tags listable
```

## Buenas prácticas

1. **Usa integraciones HTTP para tiempo real** - Configura las reglas de Gorgias para enviar peticiones HTTP a Tajo en los eventos de tickets
2. **Sincroniza los datos CSAT con regularidad** - Usa las puntuaciones de satisfacción para impulsar campañas de reenganche
3. **Asocia etiquetas a segmentos** - Traduce las etiquetas de cliente de Gorgias en pertenencias a listas de Brevo
4. **Gestiona la paginación con cuidado** - Con el límite de 2 req/s, planifica tiempos más largos de sincronización en conjuntos grandes
5. **Vincula con datos de e-commerce** - Combina los datos de soporte de Gorgias con los datos de pedidos de Shopify en Brevo
6. **Rota las claves API** - Dado que las claves de Gorgias tienen acceso completo, rótalas periódicamente

## Seguridad

- **Basic Auth** - Email y clave API sobre HTTPS
- **Solo HTTPS** - Toda la comunicación con la API se cifra vía TLS 1.2+
- **Claves con acceso total** - Sin scopes granulares (protege las claves con cuidado)
- **Lista blanca de IP** - Disponible en los planes superiores de Gorgias
- **Almacenamiento cifrado** - Credenciales de API cifradas en reposo en Tajo
- **Cumplimiento SOC 2** - La plataforma Gorgias está certificada SOC 2 Type II

## Recursos relacionados

- [Conector de Twilio Flex](https://tajo.io/es/docs/connectors/custom/twilio-flex)
- [Conector de Jira](https://tajo.io/es/docs/connectors/custom/jira)
- [Conector de Shopify](https://tajo.io/es/docs/connectors/ecommerce/shopify)
- [API de contactos de Brevo](https://tajo.io/es/docs/contact-management)