> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 連携

> 1 つの Alforse 会社を、会計、CAD、プロジェクト管理、見積、経費、決済、メール、Slack と結ぶ自社提供コネクタを有効にします。

連携とは、Alforse が他の業務アプリケーション向けに構築・保守しているコネクタです。会社の管理者が、**設定 → 連携**で 1 社ずつ、各連携を有効にして接続情報を入力します。

## プランごとの利用可否

| 連携 | プラン |
| - | - |
| **メール** | すべてのプラン |
| その他すべての連携 | **Business** または **Partner**（機能 `INTEGRATIONS`） |

## 定義とアクティベーション

すべての接続の背後には 2 種類のレコードがあります。

| レコード | スコープ | 保持する内容 |
| - | - | - |
| **定義**（Definition） | システム全体 | その連携が必要とするフィールド（API キー、OAuth トークン、マッピングオプションなど）。 |
| **アクティベーション**（Activation） | 1 社 | `companyIntegration` レコード。`active` フラグと、その会社の認証情報や設定を含む `metadata` オブジェクトを持ちます。 |

連携をアクティベートする前に、Alforse は `metadata` を定義と照合します。この検査に通らない設定があると、アクティベーションは停止します。

## 連携を探す

**設定 → 連携**には、連携ごとに 1 枚のカードが表示されます。**検索**で一覧を絞り込むか、フィルターを**すべて**、**インストール済み**、**利用可能**で切り替えます。

各カードには連携の状態が表示されます。

| カードの表示 | 意味 |
| - | - |
| **インストール済み**バッジ | この会社でその連携が接続されています。**詳細**で設定を開き、**アンインストール**で接続を解除します。 |
| **未設定**バッジ | この環境ではその連携が設定されていないため、**インストール**は利用できません。 |
| **インストール**ボタン | その連携は接続できる状態です。 |
| **アップグレード**ボタン | ご契約のプランにその連携は含まれていません。課金ページにリンクします。 |
| 「Uninstall … first」 | 競合する連携がインストールされています。先にそちらを削除してからインストールしてください。 |

## アプリを接続する

カードの**インストール**を選択し、接続を完了します。方法はアプリによって異なります。

| 方法 | アプリ | 操作 |
| - | - | - |
| プロバイダー設定 | メール | プロバイダーを選び、そのフィールドを入力します。 |
| API キー | Linear、Paperless Parts、Rillet | 相手のアプリで発行したキーと、要求されるオプションを貼り付けます。 |
| OAuth | Xero、QuickBooks Online、Jira、Onshape、Slack | プロバイダーのサインインウィンドウで Alforse を承認します。得られたトークンは Alforse が保存します。 |

Mount、Sage Intacct、Ramp、Stripe Connect は、各連携のページにある接続設定で構成します。

## 接続を解除する

連携のカードで**アンインストール**を選択します。Alforse は「Disconnected … integration」と表示して確認し、一覧に戻ります。

接続解除は `active = false` を設定するだけです。保存済みの認証情報は Alforse に残ります。

HEADS UP

**接続を解除する前に認証情報を削除してください**

認証情報も削除するには、先にその連携の設定をクリアしてから接続を解除してください。

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

| 症状 | 原因 | 対処 |
| - | - | - |
| カードに**インストール**ではなく**アップグレード**が表示される | 会社のプランに `INTEGRATIONS` 機能が含まれていません。 | **Business** または **Partner** プランに変更します。 |
| **インストール**がグレーアウトし「Uninstall … first」と表示される | この連携と競合する別の連携がインストールされています。 | 示された連携をアンインストールしてから、この連携をインストールします。 |
| Onshape が "Another Onshape integration is already connected. Uninstall it before connecting this one."（別の Onshape 連携がすでに接続されています。これを接続する前にアンインストールしてください）と表示する | 有効にできる Onshape 接続は 1 つだけです。 | 既存の Onshape 連携を先にアンインストールします。 |
| "Failed to disconnect integration"（連携の接続解除に失敗しました） | 接続解除を保存できませんでした。 | **アンインストール**をもう一度実行します。成功するまで連携は接続されたままです。 |

## カテゴリ別の連携

**会計**

Xero、QuickBooks Online、Sage Intacct、Rillet。

[Open](https://docs.alforse.com/ja/docs/integrations/accounting.md)

**プロジェクト管理**

品質上の問題を Linear または Jira に送ります。

[Open](https://docs.alforse.com/ja/docs/integrations/project-management.md)

**CAD**

Onshape から CAD データを取り込みます。

[Open](https://docs.alforse.com/ja/docs/integrations/cad.md)

**見積と積算**

Paperless Parts から見積と BOM をインポートします。

[Open](https://docs.alforse.com/ja/docs/integrations/estimating.md)

**メール**

Resend または自社の SMTP サーバー経由で送信メールを配信します。

[Open](https://docs.alforse.com/ja/docs/integrations/email.md)

**アシスタント**

Slack 内で Alforse アシスタントを利用します。

[Open](https://docs.alforse.com/ja/docs/integrations/assistant.md)

## 関連

**Webhook**

どのコネクタにもない用途ですか？ レコードの変更を自社のエンドポイントに送信できます。

[Open](https://docs.alforse.com/ja/docs/building/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.