TeamDay.ai
← Docs

API 統合

TeamDay の強力な API 統合機能により、AI エージェントを外部サービス、データベース、アプリケーションに接続して、機能を拡張し、複雑なワークフローを自動化できます。

API 統合について理解

API 統合とは何か？

API 統合により、AI エージェントが以下を実行できます：

  • 外部サービスとデータベースに接続
  • サードパーティアプリケーションからデータを取得
  • 他のシステムに情報をプッシュ
  • クロスプラットフォームワークフローを自動化
  • 組み込みツールを超えてエージェント機能を拡張

統合のタイプ

  • REST API: 標準的な HTTP ベースの統合
  • GraphQL API: クエリベースのデータ統合
  • Webhook: リアルタイムイベント駆動型統合
  • データベース接続: 直接的なデータベースアクセス
  • ファイルシステムアクセス: ローカルおよびクラウドファイル操作

API 統合をセットアップ

前提条件

統合をセットアップする前に、以下を用意してください：

  • ターゲットサービスからの有効な API 認証情報
  • ターゲット API ドキュメントの理解
  • TeamDay での適切な権限
  • データ形式とエンドポイントの知識

基本的な統合セットアップ

1. 認証設定

{
  "type": "oauth2",
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "scope": "read write",
  "token_url": "https://api.example.com/oauth/token"
}

2. API エンドポイント設定

{
  "base_url": "https://api.example.com/v1",
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer {token}"
  },
  "timeout": 30
}

3. データマッピング

システム間のデータフローを定義：

{
  "input_mapping": {
    "agent_field": "api_parameter",
    "user_input": "request_body.message"
  },
  "output_mapping": {
    "api_response.data": "agent_knowledge",
    "api_response.status": "operation_result"
  }
}

一般的な統合パターン

CRM 統合

顧客関係管理システムに接続：

Salesforce 統合

// 顧客情報を取得
const getCustomer = async (customerId) => {
  const response = await api.get(`/sobjects/Account/${customerId}`);
  return response.data;
};

// 顧客レコードを更新
const updateCustomer = async (customerId, data) => {
  return await api.patch(`/sobjects/Account/${customerId}`, data);
};

HubSpot 統合

// 連絡先の詳細を取得
const getContact = async (email) => {
  const response = await api.get(`/contacts/v1/contact/email/${email}/profile`);
  return response.data;

詳細については、API 統合 を参照してください。