---
title: "Gorgias コネクタ"
description: "Tajo を介して Gorgias のヘルプデスクチケット、顧客データ、サポートイベントを Brevo と同期するための完全な Gorgias 統合ガイド。"
url: https://tajo.io/jp/docs/connectors/support/gorgias/
markdown: https://tajo.io/jp/docs/connectors/support/gorgias.md
lang: ja-JP
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 |
| **カテゴリ** | サポート |
| **セットアップの複雑さ** | 簡単 |
| **公式統合** | いいえ |
| **同期データ** | 顧客、チケット、イベント |
| **API タイプ** | REST API |
| **認証** | API Key + Email(Basic Auth) |
| **ベース URL** | `https://{domain}.gorgias.com/api/` |

## 機能

- **チケットイベント同期** - チケット作成、解決、CSAT イベントを Brevo タイムラインに転送
- **顧客プロファイルのエンリッチメント** - タグやカスタムフィールドを含む Gorgias 顧客データを Brevo に同期
- **サポート後のキャンペーン** - チケット解決後にフォローアップやアップセル用の Brevo ワークフローをトリガー
- **満足度トラッキング** - CSAT 調査結果を Brevo 連絡先属性として同期
- **タグベースのセグメンテーション** - Gorgias 顧客タグを Brevo リストメンバーシップとしてミラー
- **マクロとルールイベント** - 運用分析用に自動化アクションをトラッキング

## 前提条件

開始する前に、以下を準備してください。

1. 管理者アクセス権を持つ Gorgias アカウント
2. Gorgias サブドメイン(例: `yourstore.gorgias.com`)
3. API キーと関連するメールアドレス
4. API アクセス可能な Brevo アカウント
5. 有効なサブスクリプションを持つ Tajo アカウント

## 認証

Gorgias はアカウントのメールと API キーを使用した HTTP Basic 認証を使用します。

### API キーの作成

1. Gorgias ダッシュボードにログイン
2. **Settings** > **REST API** に移動
3. **Create API Key** をクリック(または既存のキーをコピー)
4. API ベース URL を確認: `https://{domain}.gorgias.com/api/`

```bash
# Basic Auth: メールをユーザー名、API キーをパスワードとして使用
curl -X GET "https://yourstore.gorgias.com/api/customers" \
  -u "admin@yourstore.com:$GORGIAS_API_KEY" \
  -H "Content-Type: application/json"
```

API キーの権限

Gorgias API キーにはアカウントデータへの完全なアクセス権があります。スコープベースの権限モデルはありません。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
// サポートチケット解決後にフォローアップメールをトリガー
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 リクエスト/秒 |
| **バースト許容量** | 短いバーストで最大 5 リクエスト |
| **ページネーション** | ページあたり 30 アイテム(デフォルト)、最大 100 |

ページネーション戦略

Gorgias は `cursor` と `limit` パラメータでカーソルベースのページネーションを使用します。Tajo はこれを自動的に処理し、最大効率のためページあたり最大 100 アイテムをリクエストします。

レート制限を超えると、Gorgias は `429 Too Many Requests` を返します。

## トラブルシューティング

### 一般的な問題

| 問題 | 原因 | 解決策 |
| --- | --- | --- |
| 401 Unauthorized | メールまたは API キーが無効 | Gorgias Settings > REST API で資格情報を確認 |
| 404 Not Found | エンドポイントまたはリソース ID が無効 | API ベース URL にサブドメインが含まれているか確認 |
| 顧客の欠落 | 記録にメールがない | Gorgias は顧客マッチングにメールが必要 |
| タグが同期されない | タグが顧客に割り当てられていない | タグがチケットだけでなく顧客オブジェクトにあることを確認 |
| 同期が遅い | レート制限が低い | Gorgias は 2 req/s に制限。フル同期には時間がかかる |

### デバッグモード

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

### 接続テスト

```bash
tajo connectors test gorgias
# ✓ API 認証に成功
# ✓ 顧客リストにアクセス可能
# ✓ チケットデータ読み取り可能
# ✓ CSAT 調査が利用可能
# ✓ タグを一覧表示可能
```

## ベストプラクティス

1. **リアルタイムには HTTP 統合を使用する** - Gorgias ルールを設定してチケットイベント時に Tajo に HTTP リクエストを送信
2. **CSAT データを定期的に同期する** - 満足度スコアを使用して再エンゲージメントキャンペーンを推進
3. **タグをセグメントにマッピングする** - Gorgias の顧客タグを Brevo リストメンバーシップに変換
4. **ページネーションを慎重に処理する** - 2 req/s 制限で、大規模データセットでは長い同期時間を計画
5. **E コマースデータとリンクする** - Gorgias サポートデータを Brevo で Shopify 注文データと組み合わせる
6. **API キーをローテーションする** - Gorgias キーには完全なアクセス権があるため、定期的にローテーション

## セキュリティ

- **Basic Auth** - HTTPS 経由のメールと API キー
- **HTTPS のみ** - すべての API 通信は TLS 1.2 以上で暗号化
- **フルアクセスキー** - 細かいスコーピングなし(キーを慎重に保護)
- **IP 許可リスト** - 上位の Gorgias プランで利用可能
- **暗号化されたストレージ** - API 認証情報は Tajo で保存時に暗号化
- **SOC 2 コンプライアンス** - Gorgias プラットフォームは SOC 2 Type II 認証取得済み

## 関連リソース

- [Twilio Flex コネクタ](https://tajo.io/jp/docs/connectors/custom/twilio-flex)
- [Jira コネクタ](https://tajo.io/jp/docs/connectors/custom/jira)
- [Shopify コネクタ](https://tajo.io/jp/docs/connectors/ecommerce/shopify)
- [Brevo Contacts API](https://tajo.io/jp/docs/contact-management)