HubSpotを接続する
営業チームやカスタマーサクセスチームがHubSpotで作業し、サポートチームがFyneDeskで作業している場合は、HubSpotを接続しましょう。新しいチケットと顧客向けの返信を対応するHubSpotコンタクトに記録でき、誰もがサポートの状況を把握できるようになります。
始める前に
- FyneDesk管理者である必要があります。
- プライベートアプリのアクセストークンを作成または管理できるHubSpotアカウントが必要です。
- チケットのリクエスト者がHubSpotにまだ存在しない場合に、FyneDeskがHubSpotコンタクトを作成すべきかどうかを決めておきます。
- FyneDeskがHubSpotでサポートアクティビティをどう記録すべきか(メモ、チケット、またはその両方)を決めておきます。
ステップ1 — HubSpotのアクセストークンを作成する
- HubSpotを開き、プライベートアプリを管理する領域に移動します。
- FyneDesk用のプライベートアプリを作成するか、ヘルプデスクのログ記録専用の既存のものを使用します。
- コンタクトのタイムラインを読み取り・更新する権限と、使用予定のアクティビティタイプを作成する権限を付与します。
- 生成されたらアクセストークンをコピーします。
HubSpot管理者でない場合は、HubSpot管理者にトークンの作成を依頼し、一緒にFyneDeskに入力してもらってください。トークンはHubSpotのデータへのアクセスを与えるため、パスワードのように扱ってください。
ステップ2 — FyneDeskでHubSpotを接続する
- FyneDeskで設定 → 接続 → HubSpotを開きます。
- HubSpotのアクセストークンをトークンフィールドに貼り付けます。
- FyneDeskがHubSpotで不足しているコンタクトを作成すべきかどうかを選択します。
- サポートアクティビティをHubSpotのどこに表示するかを選択します:メモ、チケット、または両方。
- 接続または変更を保存をクリックします。
適切なオプションの選択
不足しているコンタクトを作成は、サポートがまだHubSpotにいない人からメールを受け取る場合に役立ちます。HubSpotを厳密に管理したい場合は、これをオフのままにしてコンタクトを手動で作成してください。
メモとして記録はシンプルで、HubSpotが主に顧客タイムラインとして使われている場合にうまく機能します。
チケットとして記録は、HubSpotチームがサポートアクティビティを構造化されたサービス作業としてHubSpot内に表示したい場合に便利です。
両方として記録は最も可視性が高くなりますが、ノイズも増える可能性があります。迷う場合はメモから始めてください。
ステップ3 — 接続をテストする
- HubSpotに存在するコンタクト用のテストチケットをFyneDeskで作成または開きます。
- チケットに公開返信を追加します。
- HubSpotでコンタクトを開き、選択したタイムラインまたはチケット領域にサポートアクティビティが表示されることを確認します。
- イベントが配信されたかどうかを確認する必要がある場合は、設定 → 接続 → HubSpotに戻り、配信ログを開きます。
管理または切断
- 設定 → 接続 → HubSpotから、いつでもオプションを変更できます。
- HubSpotで新しいトークンを作成し、FyneDeskに貼り付けて保存することで、トークンをローテーションします。
- FyneDeskにHubSpotへのアクティビティ記録をさせたくなくなった場合は、同じページから切断します。
トラブルシューティング
トークンが拒否される。HubSpotから正しくコピーされたこと、取り消されていないこと、選択したアクティビティタイプに必要な権限が含まれていることを確認してください。
HubSpotでコンタクトが見つからない。チケットのリクエスト者のメールアドレスがHubSpotコンタクトのメールアドレスと一致するか確認してください。その人がHubSpotに存在しない場合は、不足しているコンタクトを作成をオンにするか、コンタクトを手動で作成してください。
アクティビティが誤ったコンタクトに表示される。HubSpotのマッチングはメールアドレスに依存します。チケットのリクエスト者のメールとHubSpotのコンタクトのメールを確認してください。
イベントが遅延または失敗する。HubSpot接続ページの配信ログを開いてください。失敗したイベントは通常、取り消されたトークン、不足しているHubSpotの権限、または一時的なHubSpotの問題を指し示しています。
プライバシーと信頼
FyneDeskは、連携に必要なサポートアクティビティのみを送信します。トークンは安全に保存され、保存後に全体が再表示されることはありません。公開返信はチケットの会話のうちHubSpotに記録され得る部分であるため、シークレット、パスワード、非公開の内部詳細を公開返信に含めないでください。