---
title: "Gorgias конектор"
description: "Пълно ръководство за интеграция с Gorgias за синхронизация на helpdesk тикети, клиентски данни и support събития с Brevo чрез Tajo."
url: https://tajo.io/bg/docs/connectors/support/gorgias/
markdown: https://tajo.io/bg/docs/connectors/support/gorgias.md
lang: bg-BG
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 helpdesk с Brevo за ангажиране на клиенти, задвижвано от поддръжка, маркетингови потоци след тикет и унифицирана аналитика за клиентското преживяване чрез Tajo.

## Преглед

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

## Функции

- **Синхронизация на събития от тикети** – Препращай събития за създаване, решаване и CSAT на тикети към timeline-ите в Brevo
- **Обогатяване на клиентски профил** – Синхронизирай клиентски данни от Gorgias, включително тагове и персонализирани полета, към Brevo
- **Кампании след поддръжка** – Задействай работни потоци в Brevo след решаване на тикет за follow-up или upsell
- **Проследяване на удовлетвореност** – Синхронизирай резултати от CSAT анкети като атрибути на контактите в Brevo
- **Сегментация на базата на тагове** – Mirror-ирай Gorgias клиентски тагове като членство в списъци в Brevo
- **Macro и rule събития** – Проследявай автоматизирани действия за оперативна аналитика

## Предварителни условия

Преди да започнеш, увери се, че имаш:

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

## Автентикация

Gorgias използва HTTP Basic Authentication с твоя email от акаунта и API ключ.

### Създаване на API ключ

1. Влез в своя Gorgias dashboard
2. Навигирай към **Settings** > **REST API**
3. Щракни върху **Create API Key** (или копирай съществуващия ключ)
4. Запиши своя API base 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 ключ

Gorgias API ключовете имат пълен достъп до данните на акаунта ти. Няма 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:
  # 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
```

### Мапване на събития

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

### Кампания след решаване

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

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

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

## Ограничения на заявките

Gorgias налага rate limits на акаунт:

| Тип лимит | Стойност |
| --- | --- |
| **API rate limit** | 2 заявки в секунда |
| **Burst allowance** | До 5 заявки в кратки burst-ове |
| **Пагинация** | 30 артикула на страница (default), макс 100 |

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

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

Gorgias връща `429 Too Many Requests`, когато rate limits са надвишени.

## Отстраняване на проблеми

### Чести проблеми

| Проблем | Причина | Решение |
| --- | --- | --- |
| 401 Unauthorized | Невалиден имейл или API ключ | Провери credentials в Gorgias Settings > REST API |
| 404 Not Found | Невалидна крайна точка или resource ID | Провери дали API base URL включва твоя subdomain |
| Липсващи клиенти | Няма имейл на запис | Gorgias изисква имейл за съпоставяне на клиенти |
| Таговете не се синхронизират | Тагове не са присвоени на клиенти | Провери дали таговете са на обекти customer, а не само на тикети |
| Бавна синхронизация | Нисък rate limit | 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 Rules да изпращат HTTP заявки към Tajo при събития от тикети
2. **Синхронизирай CSAT данни редовно** – Използвай скорове за удовлетвореност, за да задействаш re-engagement кампании
3. **Мапвай тагове към сегменти** – Преведи Gorgias клиентските тагове към членство в списъци в Brevo
4. **Обработвай пагинацията внимателно** – С лимити 2 заявки/сек, планирай по-дълги времена за синхронизация при големи datasets
5. **Свързвай с e-commerce данни** – Комбинирай Gorgias support данни с Shopify данни за поръчки в Brevo
6. **Ротирай API ключовете** – Тъй като Gorgias ключовете имат пълен достъп, ротирай ги периодично

## Сигурност

- **Basic Auth** – Имейл и API ключ през HTTPS
- **Само HTTPS** – Цялата API комуникация е криптирана чрез TLS 1.2+
- **Ключове с пълен достъп** – Без гранулирано scope-ване (защитавай ключовете внимателно)
- **IP Allowlisting** – Достъпно на по-високи Gorgias планове
- **Криптирано съхранение** – API credentials криптирани при съхранение в Tajo
- **SOC 2 съвместимост** – Gorgias платформата е SOC 2 Type II сертифицирана

## Свързани ресурси

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