HubSpotをAIエージェントに接続する

想定されるワークフロー

コネクタのアクション

• get_contact (読み取り)

  識別子でCRMの連絡先を取得する。

• search_contacts (読み取り)

  テキストまたはプロパティフィルターで連絡先を検索する。

• get_deal (読み取り)

  識別子でCRMの商談を取得する。

• list_deals (読み取り)

  CRMの商談を一覧表示する。ページネーション対応。

• list_pipelines (読み取り)

  パイプラインとその段階(商談またはチケット)を一覧表示する。

• list_owners (読み取り)

  CRMの担当者を一覧表示する。メールで絞り込み可能。

• create_contact (書き込み)

  CRMに連絡先を作成する。

• update_contact (書き込み)

  連絡先のプロパティを更新する。

• create_deal (書き込み)

  CRMに商談を作成する。

• update_deal (書き込み)

  商談(段階、金額)を更新する。

• create_ticket (書き込み)

  サポートチケットを作成する。

• create_task (書き込み)

  CRMのタスク(フォローアップ、架電)を作成する。

• create_note (書き込み)

  メモを記録し、レコードに関連付ける。

• create_association (書き込み)

  2つのCRMレコードを関連付ける。

前提条件

• private appを作成するためのスーパー管理者権限を持つHubSpotアカウント。
• Settings、続いてIntegrations、続いてPrivate Appsからprivate appを作成する。
• 必要なスコープ(contacts、companies、deals、ticketsの読み取り/書き込み、owners)を選択する。
• 作成後に表示されるアクセストークン(prefixがpat-)をコピーする。
• Atako側で、エージェントにgrantを付与するためのインテグレーション管理権限。

接続方法

1. 1

   HubSpotのprivate appを作成する

   Settings、続いてIntegrations、続いてPrivate Appsで、appを作成して名前を付け、専用タブでスコープを選択する。

2. 2

   トークンを生成してコピーする

   appの作成後、アクセストークン(pat-...)を表示してコピーする。表示は一度だけ。

3. 3

   AtakoでHubSpotを接続する

   設定、続いて連携で、アクセストークンを貼り付ける。

4. 4

   エージェントにgrantを付与する

   エージェントのページまたは接続画面から、許可する具体的なアクションとその範囲(読み取り専用または読み書き)を選択する。