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`