HubSpot Marketing の認証

OAuth 2.0 認可コード、独自の OAuth 2.0 アプリ、またはプライベート アプリ アクセス トークンを使用して、UiPath を HubSpot Marketing に接続します。

前提条件

選択した認証の種類に応じて、次のいずれかの資格情報が必要です。

• OAuth 2.0認証コード:HubSpotアカウントに関連付けられたEメールアドレスとパスワード。
• 独自の OAuth 2.0 アプリ (クライアント ID とクライアント シークレット) を使用する
• プライベート アプリのアクセス トークン: トークン。

HubSpot に接続するには、 開発者アカウントが必要です。

プライベート OAuth2 アプリを作成するには、HubSpot のドキュメントに記載されている手順に従います。すなわち、OAuth の操作。HubSpot のプライベート アプリケーションについて詳しくは、 Hubspot ドキュメントの 「プライベート アプリ 」をご覧ください。

注:

HubSpot に OAuth アプリケーションを登録する際は、 コールバック URL をコネクション作成ページに表示される値に設定してください (例: Automation Cloud の https://cloud.uipath.com/provisioning_/callback )。

HubSpot Marketing コネクションを追加する

お使いの Hubspot Marketing インスタンスへのコネクションを作成するには、次の手順を実行する必要があります。

1. 製品ランチャーから [Orchestrator] を選択します。

2. フォルダーを選択して [ コネクション ] タブに移動します。

3. [ コネクションを追加] を選択します。

4. コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。

5. 認証の種類を選択し、必要な資格情報を入力します。

6. [接続] を選択します。

   Where available, select the menu next to a field and choose Use credential asset or Use Orchestrator asset to reference an Orchestrator asset instead of entering the value directly. For more information, see Use credential assets for connections.

注:

接続時に「未確認のアプリを接続しています。」というメッセージが表示されます。このアプリの詳細は、HubSpotによって確認または検証されていません。開発者をアカウントに接続する前に、開発者を信頼していることを確認してください。UiPath アプリは現在、HubSpot による承認のための審査中です。アプリがレビューされている間は、使用できる状態です。承認後は警告メッセージは表示されなくなります。コネクタ側では変更はありません。

範囲と権限

コネクションを使用して、UiPath Studio 内で Hubspot Marketing アクティビティ を有効化することで、リスト、連絡先、企業管理のオートメーションを作成できます。実現できるさまざまな権限ベースのユース ケースは次のとおりです。

スコープ/権限	ユースケース	アクティビティ/イベント
crm.objects.contacts.read	ユーザーとして、CRMの連絡先をHubspotマーケティングに同期し、マーケティングメールへの関与を維持したいと考えています。	連絡先を取得 連絡先→すべてのレコードのリストを取得 連絡先の関連付け→すべてのレコードのリストを取得
crm.objects.contacts.write		連絡先を作成 連絡先を更新
crm.objects.companies.read	ユーザーとして、CRM会社をHubspotマーケティングに同期し、マーケティングメールへの関与を維持したいと考えています。	企業を取得 会社のすべてのレコードのリストを取得→ 会社の関連付け→すべてのレコードのリストを取得
crm.objects.companies.write		コマプニーを作成 会社を更新
crm.lists.read	ユーザーとして、Hubspotマーケティングの連絡先リストに連絡先を割り当てたいと思います。 以前の購入に基づいてCRM連絡先にタグを付け/グループ化しましたが、今後のマーケティングキャンペーンでは、連絡先リストに同期する必要があります。	リストを取得 すべてのレコード→リストのリストを取得
crm.lists.write		リストを作成 リストを更新 リストに連絡先を追加
files	受注書やエンゲージメントレポートなど、顧客に関連するファイル/添付ファイルをアップロードします。	ファイルをアップロード ファイルを更新 レコード→フォルダーの挿入 すべてのレコード→フォルダーのリストを取得
crm.objects.deals.write	CRMとマーケティング間の取引/機会の同期は、ユーザーがそれらの取引の進捗状況を追跡するのに役立ちます	レコード→取引を挿入 レコード→取引を更新
crm.objects.deals.read		取引→すべてのレコードのリストを取得 取引の関連付け→すべてのレコードのリストを取得
crm.schemas.contacts.read crm.schemas.companies.read crm.schemas.deals.read	取引/連絡先/会社の単一またはすべてのカスタムプロパティを取得して、同じものに値を追加/更新します	すべてのレコード→プロパティのリストを取得 レコード → のプロパティを取得
crm.schemas.deals.write crm.schemas.contacts.write crm.schemas.companies.write	取引/連絡先/会社のカスタムプロパティの作成/更新	レコード→のプロパティを挿入 レコード →のプロパティを更新
オートメーション	Hubspot でアクティブな自動化/ワークフローをすべて取得します。	ワークフロー→すべてのレコードのリストを取得 レコードを取得 → ワークフロー
フォーム	Hubspot でフォームを取得、作成、または更新する	フォーム→すべてのレコードのリストを取得 レコード→フォームを挿入 レコード→フォームを更新