---
title: "Коннектор Gorgias"
description: "Полное руководство по интеграции Gorgias для синхронизации тикетов хелпдеска, данных клиентов и событий поддержки с Brevo через Tajo."
url: https://tajo.io/ru/docs/connectors/support/gorgias/
markdown: https://tajo.io/ru/docs/connectors/support/gorgias.md
lang: ru-RU
robots: noindex
---

Подайте заявку на ранний доступ

Укажите имя и рабочий адрес электронной почты. Мы отправим ссылку для подтверждения запроса на доступ к Tajo.

# Коннектор Gorgias

Статус коннектора: Запланирован Ещё не создан. Сегодня Tajo не запускает этот коннектор.

| Поле источника | Поле назначения | Пример значения |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Подключите хелпдеск Gorgias к Brevo для вовлечения клиентов на основе поддержки, маркетинговых потоков после закрытия тикетов и единой аналитики клиентского опыта через Tajo.

## Обзор

| Свойство | Значение |
| --- | --- |
| **Платформа** | Gorgias |
| **Категория** | Support |
| **Сложность настройки** | Простая |
| **Официальная интеграция** | Нет |
| **Синхронизируемые данные** | Клиенты, тикеты, события |
| **Тип API** | REST API |
| **Аутентификация** | API Key + Email (Basic Auth) |
| **Базовый URL** | `https://{domain}.gorgias.com/api/` |

## Возможности

- **Синхронизация событий тикетов**, пересылка событий создания, решения тикетов и CSAT в таймлайны Brevo
- **Обогащение профилей клиентов**, синхронизация данных клиентов Gorgias, включая теги и пользовательские поля, в Brevo
- **Постпокупочные кампании**, запуск рабочих процессов Brevo после закрытия тикета для follow-up или апселла
- **Отслеживание удовлетворённости**, синхронизация результатов CSAT-опросов как атрибутов контактов Brevo
- **Сегментация по тегам**, зеркалирование тегов клиентов Gorgias как членства в списках Brevo
- **События макросов и правил**, трекинг автоматизированных действий для операционной аналитики

## Предварительные требования

Прежде чем начать, убедитесь, что у вас есть:

1. Аккаунт Gorgias с правами администратора
2. Поддомен Gorgias (например, `yourstore.gorgias.com`)
3. API-ключ и связанный email-адрес
4. Аккаунт Brevo с доступом к API
5. Аккаунт Tajo с активной подпиской

## Аутентификация

Gorgias использует HTTP Basic Authentication с email аккаунта и API-ключом.

### Создание API Key

1. Войдите в дашборд Gorgias
2. Перейдите в **Settings** > **REST API**
3. Нажмите **Create API Key** (или скопируйте существующий ключ)
4. Запишите базовый URL API: `https://{domain}.gorgias.com/api/`

```bash
# Basic Auth: email как имя пользователя, API-ключ как пароль
curl -X GET "https://yourstore.gorgias.com/api/customers" \
  -u "admin@yourstore.com:$GORGIAS_API_KEY" \
  -H "Content-Type: application/json"
```

Разрешения API Key

API-ключи Gorgias имеют полный доступ к данным вашего аккаунта. Модель разрешений на основе scope отсутствует. Защищайте API-ключ и регулярно ротируйте его.

### Подключение к Tajo

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

## Конфигурация

### Базовая настройка

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

### Сопоставление полей

Сопоставьте поля клиентов и тикетов Gorgias с атрибутами контактов Brevo:

```yaml
field_mapping:
  # Поля клиента
  id: GORGIAS_ID
  email: email
  name: FIRSTNAME
  phone: SMS

  # Метрики поддержки
  nb_tickets: TICKET_COUNT
  last_ticket_date: LAST_SUPPORT_DATE
  last_ticket_channel: LAST_SUPPORT_CHANNEL
  avg_response_time: AVG_RESPONSE_TIME

  # Данные CSAT
  last_satisfaction_score: CSAT_SCORE
  satisfaction_count: CSAT_RESPONSES

  # Пользовательские поля
  customer_type: CUSTOMER_TYPE
  vip_status: VIP_STATUS
```

### Маппинг событий

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

Tajo интегрируется со следующими эндпоинтами Gorgias REST API:

| Эндпоинт | Метод | Назначение |
| --- | --- | --- |
| `/api/customers` | GET | Список клиентов |
| `/api/customers/{id}` | GET | Получить клиента |
| `/api/customers` | POST | Создание клиента |
| `/api/customers/{id}` | PUT | Обновление клиента |
| `/api/tickets` | GET | Список тикетов |
| `/api/tickets/{id}` | GET | Получить тикет |
| `/api/tickets/{id}/messages` | GET | Сообщения тикета |
| `/api/tags` | GET | Список тегов |
| `/api/satisfaction-surveys` | GET | Список CSAT-опросов |
| `/api/satisfaction-surveys/{id}` | GET | Получить опрос |
| `/api/users` | GET | Список агентов |
| `/api/integrations` | GET | Список интеграций |
| `/api/events` | GET | Список событий |
| `/api/customers/{id}/custom-fields` | GET | Значения пользовательских полей |

## Примеры кода

### Инициализация коннектора

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

### Синхронизация клиентов в 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
// }
```

### Обработка событий тикетов через HTTP-интеграцию

```javascript
// Gorgias может отправлять HTTP-запросы через правила или HTTP-интеграции
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');
});
```

### Постпокупочная кампания

```javascript
// Запуск follow-up email после закрытия тикета поддержки
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
      }
    });
  }
});
```

### Синхронизация CSAT-данных

```javascript
// Синхронизация результатов опросов удовлетворённости с атрибутами Brevo
await tajo.connectors.sync('gorgias', {
  type: 'incremental',
  resources: ['satisfaction_surveys'],
  since: '2024-01-01'
});
```

## Ограничения скорости

Gorgias устанавливает лимиты скорости на аккаунт:

| Тип лимита | Значение |
| --- | --- |
| **Лимит API** | 2 запроса в секунду |
| **Burst-допуск** | До 5 запросов в короткие периоды |
| **Пагинация** | 30 элементов на страницу (по умолчанию), макс. 100 |

Стратегия пагинации

Gorgias использует курсорную пагинацию с параметрами `cursor` и `limit`. Tajo обрабатывает это автоматически, запрашивая до 100 элементов на страницу для максимальной эффективности.

Gorgias возвращает `429 Too Many Requests` при превышении лимитов скорости.

## Устранение неполадок

### Частые проблемы

| Проблема | Причина | Решение |
| --- | --- | --- |
| 401 Unauthorized | Недействительный email или API-ключ | Проверьте учётные данные в Gorgias Settings > REST API |
| 404 Not Found | Неверный эндпоинт или ID ресурса | Убедитесь, что базовый URL API включает ваш поддомен |
| Отсутствуют клиенты | Нет email в записи | Gorgias требует email для совпадения клиентов |
| Теги не синхронизируются | Теги не назначены клиентам | Убедитесь, что теги на объектах клиентов, а не только на тикетах |
| Медленная синхронизация | Низкий лимит скорости | Gorgias ограничивает до 2 запр./сек; полные синхронизации занимают больше времени |

### Режим отладки

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

### Проверка подключения

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

## Лучшие практики

1. **Используйте HTTP-интеграции для реального времени**, настройте правила Gorgias для отправки HTTP-запросов в Tajo при событиях тикетов
2. **Регулярно синхронизируйте CSAT-данные**, используйте оценки удовлетворённости для кампаний повторного вовлечения
3. **Маппируйте теги в сегменты**, преобразуйте теги клиентов Gorgias в членство в списках Brevo
4. **Осторожно обрабатывайте пагинацию**, при лимите 2 запр./сек планируйте более длительное время синхронизации для больших наборов данных
5. **Связывайте с данными e-commerce**, объединяйте данные поддержки Gorgias с данными заказов Shopify в Brevo
6. **Ротируйте API-ключи**, поскольку ключи Gorgias имеют полный доступ, регулярно их ротируйте

## Безопасность

- **Basic Auth**, email и API-ключ через HTTPS
- **Только HTTPS**, все API-коммуникации зашифрованы через TLS 1.2+
- **Ключи полного доступа**, нет гранулярного ограничения scope (защищайте ключи с осторожностью)
- **IP-разрешение**, доступно на старших планах Gorgias
- **Зашифрованное хранение**, API-учётные данные зашифрованы при хранении в Tajo
- **Соответствие SOC 2**, платформа Gorgias сертифицирована по SOC 2 Type II

## Связанные ресурсы

- [Коннектор Twilio Flex](https://tajo.io/ru/docs/connectors/custom/twilio-flex)
- [Коннектор Jira](https://tajo.io/ru/docs/connectors/custom/jira)
- [Коннектор Shopify](https://tajo.io/ru/docs/connectors/ecommerce/shopify)
- [Brevo Contacts API](https://tajo.io/ru/docs/contact-management)