1. 始める前に
- LetsBot アカウント。クレジットカード不要の 14 日間無料トライアルから始められます。
- メッセージは公式 WhatsApp Business API で送信されるため、LetsBot に接続された WhatsApp Business の番号。
- アプリをインストールする権限を持つ HubSpot アカウント(アカウント管理者)。
- アプリが受信者を特定できるよう、HubSpot の連絡先に国際形式の有効な電話番号。
セットアップガイド · HubSpot
HubSpot + WhatsApp 連携セットアップガイド
このガイドでは、HubSpot 内で LetsBot アプリをインストール・設定する手順を、CRM イベントから最初の WhatsApp 自動メッセージが送信されるまで、ステップごとに説明します。
セットアップは五分ほどで完了し、コードは不要です。このページは公開されており、サインインは必要ありません。
2. アプリをインストールして HubSpot を接続
接続は HubSpot OAuth を通じて行われます。API キーをコピー&ペーストするよう求められることはありません。
-
LetsBot パネルにサインインします。
letsbot.net/login - 「連携」セクションを開き、HubSpot を選びます。
- 「HubSpot を接続」ボタンをクリックすると、HubSpot の OAuth 認可画面に移動します。
- 接続したいアカウントを選び、権限を確認して承認します。
- 接続が完了すると自動的に LetsBot パネルに戻ります。主要なトリガーはすでにオンになっており、すぐにカスタマイズできます。
3. 要求する権限とその理由
アプリが要求するのは、機能に実際に必要な権限だけです。以下がその完全な一覧です:
| 対象範囲 | 必要な理由 |
|---|---|
crm.objects.contacts.read |
連絡先のプロパティ(名前、電話番号、メール)を読み取り、受信者の特定とメッセージ変数の入力に使用します。 |
crm.objects.contacts.write |
不明な番号から WhatsApp メッセージが届いたときに連絡先を作成し、返信を連絡先タイムラインにメモとして記録します。 |
crm.objects.deals.read |
商談のプロパティ(名前、ステージ、金額、完了予定日)と関連付けられた連絡先を読み取り、商談トリガーに使用します。 |
tickets |
チケットのプロパティ(件名、内容)と関連付けられた連絡先を読み取り、チケットトリガーに使用します。 |
アプリが商談やチケットを変更したり、レコードを削除したりすることはありません。書き込みを行うのは、不明な番号からメッセージが届いたときの連絡先の作成と、その連絡先のタイムラインへの会話メモの追加だけです。
4. トリガーイベントを選ぶ
各イベントは独立しています。必要なものだけを有効にし、それ以外はいつでもオフにできます。ご自身で有効にしていないイベントでメッセージが送信されることはありません。
| イベント | HubSpot のサブスクリプションタイプ | 実行内容 |
|---|---|---|
| 連絡先の作成 | contact.creation |
HubSpot に新しい連絡先が追加された瞬間にウェルカムメッセージを送信します。 |
| 連絡先のライフサイクルステージの変更 | contact.propertyChange |
連絡先が新しいライフサイクルステージ(例: マーケティング・クオリファイド・リード)に移動したときにメッセージを送信します。 |
| 商談の作成 | deal.creation |
商談が作成されるとすぐに、その商談に関連付けられた連絡先にメッセージを送信します。 |
| 商談ステージの変更 | deal.propertyChange |
商談がパイプラインの別のステージに移動したときに最新情報を送信します。 |
| チケットの作成 | ticket.creation |
チケットを受け付けて対応中であることを、WhatsApp で顧客に通知します。 |
5. メッセージを作成するかテンプレートを選ぶ
イベントごとに、簡単なテキストメッセージを作成するか、ボタン・リスト・メディアに対応したリッチな WhatsApp テンプレートを選べます。HubSpot のデータは次の変数でメッセージに挿入されます:
| 変数 | 値 |
|---|---|
{CONTACT_FIRSTNAME} |
連絡先の名 |
{DEAL_NAME} |
商談名 |
{DEAL_STAGE} |
商談ステージ |
{DEAL_AMOUNT} |
商談金額 |
{TICKET_SUBJECT} |
チケットの件名 |
{TICKET_CONTENT} |
チケットの内容 |
メッセージはアラビア語と英語の両方に対応しています。LetsBot で連絡先の言語が設定されていればその言語版が送信され、設定されていない場合は英語版が既定で使われます。
6. 有効化してテスト
- 設定したイベントの横にあるトグルをオンにして、保存します。
- HubSpot で、ご自身の電話番号を使ってその種類の実際のレコード(新しい連絡先など)を作成します。
- 数秒以内に WhatsApp メッセージが届きます。配信状況は LetsBot 内のメッセージログで確認できます。
7. 返信を HubSpot に記録
顧客が WhatsApp で返信すると、LetsBot がその返信を HubSpot の連絡先タイムラインにメモとして記録するため、会話の文脈全体が顧客レコードに残ります。未登録の番号から返信があった場合は、連絡先が自動的に作成され、メモはその連絡先に記録されます。
8. トラブルシューティング
メッセージが届かない
- イベントのトグルがオンになっていて、保存されているか確認してください。
- HubSpot の連絡先に国際形式の有効な電話番号が登録されているか確認してください。番号がないと受信者を特定できません。
- WhatsApp Business の番号が接続され、LetsBot 内でオンラインと表示されているか確認してください。
商談やチケットのトリガーが作動しない
メッセージはレコードではなく人に送信されるため、商談とチケットのトリガーは関連付けられた連絡先を必要とします。電話番号を持つ連絡先に商談またはチケットを関連付けてから、もう一度お試しください。
接続が切れた
HubSpot 側でアプリがアンインストールされたか、認可が取り消された場合に発生します。LetsBot パネルで「HubSpot を接続」をもう一度クリックして再接続してください。
9. 接続解除とアンインストール
LetsBot パネルの接続解除ボタン、または HubSpot アカウントの接続済みアプリ設定からアプリを削除することで、いつでも接続を解除できます。接続を解除すると、すべての自動メッセージが直ちに停止し、アプリはお客様のデータにアクセスできなくなります。
10. データとプライバシー
すべてのデータは暗号化された接続で送信され、アクセストークンは暗号化して保存されます。LetsBot が HubSpot から読み取るのは、メッセージのパーソナライズと受信者の特定に必要なフィールドだけであり、お客様のデータが第三者と共有されることはありません。
セットアップでお困りですか?AI サポートが 24/7 あらゆる言語でお答えし、接続の完了から最初のメッセージ送信まで、アラビア語と英語で人間のチームがサポートします。