メインコンテンツまでスキップ

HubSpot

HubSpot CRM を Squid に接続し、contact と company を検索・取得します​

HubSpot Connector の Functionality​

HubSpot connector を使用すると、Squid AI agent は user に代わって CRM data を lookup できます。connector は現在、contact と company への read-only access をサポートしています。

Capability説明
Contact を検索search query により contact を検索し、ID、name、email、company を返す
Company を検索search query により company を検索し、ID、name、domain、industry を返す
Contact detail を取得関連付けられた company を含む contact の full detail を取得する
Company detail を取得関連付けられた contact を含む company の full detail を取得する

これらの capability により、user は AI agent に「Acme の Jane の contact を検索して」や「healthcare industry の company は何がありますか？」などの質問をでき、agent は HubSpot で直接 answer を lookup します。

connector は HubSpot CRM v3 API を使用し、HubSpot rate limit を自動的に処理します。limit に達した場合は back off して retry します。

HubSpot Private App Access Token の作成​

connector は private app access token を使用して HubSpot を authenticate します。

  1. HubSpot account で Settings > Integrations > Service Keys に移動します。

  2. 新しい private app を作成するか、既存のものを開きます。

  3. Scopes tab で、次の read scope を付与します。

    • crm.objects.contacts.read
    • crm.objects.companies.read
    • crm.schemas.contacts.read
    • crm.schemas.companies.read

  4. app を作成し、その access token を copy します。

詳細については、private app に関する HubSpot documentationを参照してください。

Squid Application に HubSpot Connector を追加する​

  1. Squid Console の Connectors tab に移動します。

  2. Available Connectors をクリックします。

  3. HubSpot connector を見つけ、Add Connector を選択します。

  4. 次の configuration detail を指定します。

Connector ID: code 内で connector を一意に識別する string。この value は後から変更できません。

Access Token: HubSpot private app の access token。token は Squid secret として安全に保存されます。

Application で HubSpot Connector を使用する​

No-code Studio​

  1. Squid Console の Studio tab に移動します。

  2. Create AI Agent をクリックします。

  3. "crm-agent" や "This agent helps the user look up contacts and companies in HubSpot" などの agent ID と description を指定します。

  4. Add Abilities をクリックします。

  5. HubSpot entry を expand し、先ほど作成した HubSpot connector を選択します。

  6. 「user が CRM contact または company を lookup したい場合にこれを call する」など、agent がこの connection を使用する方法の description を指定します。

  7. Test をクリックし、agent に「Acme の contact を検索して」と尋ねてみます。

Squid SDK を使用する​

Squid SDK を使用して AI agent を作成する場合は、ask() function の connectedIntegrations option に HubSpot connector を追加して接続します。

await this.squid
  .ai()
  .agent('AGENT_ID')
  .ask('Which of our contacts work at Acme?', {
    connectedIntegrations: [
      {
        integrationId: 'HUBSPOT_CONNECTOR_ID',
        integrationType: 'hubspot',
        description: 'Call this connector to look up HubSpot contacts and companies',
      },
    ],
  });

SDK から agent と interaction する詳細については、AI agent documentationを参照してください。