ferret OneはHubSpotと連携が可能です。その連携方法について説明します。
※この機能は、HubSpotと契約をしている企業様のみ、ferret Oneとの連携が可能となります。
※HubSpotの管理画面についてのご質問はサポート外となります。
目次
HubSpotとは
HubSpot, Inc.が提供するマーケティングオートメーションツールです。BtoBやBtoCのマーケティング活動に対応する多様な機能を備えており、リード生成から顧客エンゲージメント、成約に至るまでのプロセスを一元管理できます。特に、インバウンドマーケティングに特化した機能が充実しているのが特徴です。
ferret Oneと連携してできること
HubSpotのAPIを利用し、ferret Oneのフォームに到達したお問い合わせをHubSpotのコンタクトに連携します。
※連携を行う際、HubSpotに既に同じメールアドレスが存在する場合は上書きされます。
API連携とトラッキングコード連携との違い
|
|
API連携 |
トラッキングコード連携 |
| コンタクト作成 | ⚪︎ | ⚪︎ |
| フォーム作成（※） | × | ⚪︎ |
| 添付ファイル連携 | ⚪︎ | × |
| チェックボックス連携 | ⚪︎ | × |
| 非表示項目の連携 | ⚪︎ | × |
| 連携エラー時の通知 | ⚪︎ | × |
※フォーム作成はHubSpotのフォームになります。
参考：
https://knowledge.hubspot.com/ja/forms/use-non-hubspot-forms
連携手順
解説動画（※音声が出ます）
1. HubSpot管理画面 > 設定 > 非公開アプリ から「非公開アプリ」を作成し、アクセストークンをコピーする
※連携には「スコープ」から「crm.objects.contacts」の読み取りと書き込みをONにする必要があります。
下記、HubSpotのヘルプページもご確認ください。
2. ferret One管理画面 > 設定 > 外部サービス設定 > HubSpot から「利用する」をクリックし、アクセストークンに貼り付ける
3. ferret One管理画面 > サイト > 入力フォーム > 入力フォーム一覧 から連携するフォームの編集画面に入る
4. 連携するフォームの編集画面の「オプション」タブにある外部サービスから「HubSpotと連携」をONにする
5. 連携するフォーム項目に内部名を設定する
HubSpot側の内部名を確認し、ferret One側のフォーム項目にある内部名を一致させます。
※基本項目については、予めfO側でデフォルト設定がされており、HubSpotプロパティ名の内部名と一致できるものは一致させています。
| ferret One項目名 | 内部名 | HubSpot項目名 |
|---|---|---|
| 氏名 | name | 氏名 |
| 姓 | lastname | 姓 |
| 名 | firstname | 名 |
| 郵便番号 | zip | 郵便番号 |
| 都道府県 | state | 都道府県 |
| 電話番号 | phone | 電話番号 |
| FAX番号 | fax | FAX番号 |
| 携帯電話番号 | mobilephone | 携帯電話番号 |
| メールアドレス | Eメール | |
| ホームページのURL | website | ウェブサイトURL |
| 性別 | gender | 性別 |
| 会社名 | company | 会社名 |
| 役職 | jobtitle | 役職名 |
| Twitter アカウント | twitterhandle | Twitter のハンドル |
＜HubSpot側画面＞
設定 > データ管理 > プロパティ から確認できます。
＜ferret One側画面＞
サイト > 入力フォーム > 入力フォーム一覧 > フォーム編集 > 項目設定 から確認できます。
※内部名は外部サービス連携のテキストボックス内に記載してください。
※項目名「姓・名、メールアドレス、電話番号、会社名」は内部名がデフォルトで決まっているため編集不可です。
6. フォームの送信テストを行う
フォームを公開し、送信後、HubSpot側にデータが連携されたかをご確認ください。
連携時の注意点
連携時エラー
オーナーと管理者にエラーメールが送信されます。
- API認証エラー時
- 項目バリデーションエラー時(数値に文字列を入力した等）
- HubSpotのチェックボックス、 ラジオボタンの選択肢にない選択肢を選んだ場合のエラー時
- その他エラー（要因不明）
参考エラーメール例
APIの利用制限
HubSpotのAPIには利用制限があります。詳細はHubSpotにご確認ください。
下記、HubSpotのヘルプページもご確認ください。
HubSpotのトラッキングコード
HubSpotのトラッキングコードをインストールする場合、「HubSpot以外のフォーム」にある「ウェブサイトフォームからデータを収集」をオンにしないでください。
自動連携とAPI連携が同時に動作し、正しく連携できない場合があります。