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

HubSpot

HubSpot CRM を Squid に接続して、contacts と companies を検索・取得する​

HubSpot connector の機能​

HubSpot connector により、Squid AI agents はユーザーに代わって CRM data を検索できます。この connector は現在、contacts と companies への read-only access をサポートしています。

CapabilityDescription
Search contacts検索クエリで contacts を検索し、ID、name、email、company を返します
Search companies検索クエリで companies を検索し、ID、name、domain、industry を返します
Get contact details関連付けられた companies を含む、contact の完全な詳細を取得します
Get company details関連付けられた contacts を含む、company の完全な詳細を取得します

これらの機能により、ユーザーは AI agent に "Find the contact for Jane at Acme" や "What companies do we have in the healthcare industry?" のように質問でき、agent は HubSpot 内で直接答えを検索します。

この connector は HubSpot CRM v3 API を使用し、HubSpot の rate limits を自動的に処理して、制限に達した場合は backing off と retrying を行います。

HubSpot private app access token の作成​

この connector は private app access token を使用して HubSpot に認証します。

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

  2. 新しい private app を作成します（または既存のものを開きます）。

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

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

  4. app を作成し、その access token をコピーします。

詳細については、HubSpot の private apps に関するドキュメントを参照してください。

Squid application に HubSpot connector を追加する​

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

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

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

  4. 次の configuration details を入力します。

Connector ID: コード内で connector を一意に識別する文字列です。これは後から変更できません。

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 を展開し、先ほど作成した HubSpot connector を選択します。

  6. "Call this when a user wants to look up CRM contacts or companies." のように、この connection を agent がどのように使用すべきかの description を指定します。

  7. Test をクリックし、agent に "Find contacts at Acme" と質問してみます。

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 とやり取りする方法の詳細については、AI agent documentation を参照してください。