Formspree CLIを使ってHubSpotにリードと連絡先を作成する

formspree.json ファイルに hubspot アクションを追加することは、FormspreeダッシュボードでHubspotプラグインを追加するのと同じ効果があります。leadStatus、lifeCycleStage などの詳細については、Hubspotプラグインのヘルプ記事 をご覧ください。

プライベートアプリの作成

HubspotはアカウントAPIキーを廃止しました。現在は、代わりにプライベートアプリを作成し、アクセストークンに特定のスコープを選択する必要があります。詳細については こちらをご確認ください。

• HubSpotアカウントで、メインナビゲーションバーの 設定アイコン をクリックします。
• 左サイドバーメニューで、統合 > プライベートアプリ に移動します。
• プライベートアプリを作成 をクリックします。
• アプリの詳細を設定します。
• スコープ タブをクリックして以下を確認します：
  • crm.objects.contacts.read (CRM->Contacts->Read)
  • crm.objects.contacts.write (CRM->Contacts->Read)
  • crm.objects.companies.read (CRM->Companies->Read)
  • crm.objects.companies.write (CRM->Companies->Write)
• ダイアログボックスでアプリのアクセストークンに関する情報を確認し、作成を続ける をクリックします。

APIコールを開始するには、アプリの詳細ページに移動します。

アクセス トークン カードで トークンを表示 をクリックしてアクセストークンを確認します。コピー をクリックしてトークンをクリップボードにコピーし、Formspree CLIデプロイメントファイルの accessToken 属性に貼り付けます。

Formspree.jsonの設定

キー	型	説明
app	String	hubspot でなければなりません
type	String	createContact でなければなりません
apiKey	String	APIキー（$env変数参照である必要があります。必須）（非推奨）
accessToken	String	プライベートアプリのアクセストークン（$env変数参照である必要があります。必須）
leadStatus	String	省略可能。NEW、OPEN、IN_PROGRESS、OPEN_DEAL、UNQUALIFIED、ATTEMPTED_TO_CONTACT、CONNECTED、または BAD_TIMING のいずれか。デフォルトは NEW。
lifeCycleStage	String	省略可能。subscriber、lead、marketingqualifiedlead、salesqualifiedlead、opportunity、customer、または other のいずれか。デフォルトは空。
overwriteContact	Boolean	省略可能。true の場合、連絡先のメールアドレスがHubspotに既に存在する場合に連絡先情報を上書きします。デフォルトは false。

例

{
  "forms": {
    "registrationForm": {
      "name": "Registration Form",
      "actions": [
        {
          "app": "hubspot",
          "type": "createContact",
          "accessToken": "$accessToken",
          "leadStatus": "NEW",
          "lifeCycleStage": "lead",
          "overwriteContact": true
        }
      ]
    }
  }
}

バリデーションルール

サポートチケットを作成 アクションは、以下のバリデーションルールを暗黙的に追加します：

フィールド	バリデーションルール
email	必須
email	型は email