メインコンテンツにスキップ

Salesforceアカウントデータを同期する

Salesforceアカウント属性をFinに同期してworkflowsとメッセージのパーソナライズを強化する方法。

Salesforceアカウントデータ同期により、SalesforceとFin間でアカウント属性を双方向に同期できます。SalesforceからFinにアカウントデータを取り込み、Finで同期されたフィールドの更新は自動的にSalesforceに反映されます。

同期後、これらの属性はFin workflows内でアカウントデータに基づく分岐を可能にし、同期されたアカウントフィールドを使ってメッセージをパーソナライズし、アカウントベースのルールでFin Messengerの表示を制御できます。


Salesforceアカウントデータ同期の設定

  1. Finの設定 > Salesforceデータに移動します。

  2. Salesforceからデータを取得セクションで、JWTトークンを介して提供される会社IDと一致させるアカウントのフィールドを選択します。

  3. Finの会社オブジェクトに同期したいアカウントフィールドを追加します。

注意:

  • Salesforceアカウントフィールドの双方向同期を有効にできます。これをオンにすると、Finで同期された会社フィールドの更新は対応するSalesforceアカウントに書き戻されます。

  • これはFinのデプロイ時のDataステップでも設定可能です。

workflowsでSalesforceアカウント属性を使用する

  1. Fin workflowをエディターで開きます。

  2. アカウント属性に基づく分岐を追加(例:業界、プランタイプ)。

  3. メッセージテンプレートでアカウントフィールドの値を使ってパーソナライズします。

注意: Salesforceアカウントフィールド同期は、統合設定で選択したフィールドの双方向更新をサポートしています。Fin内(workflowsやAPI経由など)での更新は、主要な接続Salesforceワークスペースの対応フィールドも更新します。

JWTで認証する

Fin MessengerとSalesforceアカウントデータを安全に同期するには、JWT認証を使用する必要があります。

  • 主要なSalesforceアカウントの場合、JWTペイロードに設定済みのアカウントIDをキーcompany.idの下に含めます。

  • 非主要なSalesforceアカウントの場合、JWTペイロードに対象Salesforceアカウントの外部IDを同じキーcompany.idの下に含めます。これによりFinはどのアカウントのデータを同期するかを認識します。

JWTの例(Ruby):

JWT.encode({email: "user@example.com", user_id: "this_is_an_example_contact_external_id", company: { id: "this_is_an_example_account_external_id" }}, exp: Time.now.to_i+3600}, "your_jwt_secret_goes_here", "HS256")

注意:

  • Fin Messengerの表示ルールでアカウントフィールドを使用するには、JWTトークンに会社が設定されている必要があります。

  • 新しいアカウントフィールド値をJWTペイロードに含めてSalesforceに自動同期できます。あるいは、API更新などFinがサポートする任意の更新方法で同じ同期がトリガーされます。

  • Salesforce Caseイベント経由の同期ではJWTは不要です。


ベストプラクティスとトラブルシューティング

同期タイミング

  • Messengerが開かれた → 関連するSalesforceアカウントの同期をトリガーします。

  • Salesforce Case同期 → 関連するSalesforceアカウントの双方向同期をトリガーします。

  • Launcherルール → 同期された属性が使用されている場合のみSalesforceからアカウントを同期します。

  • Salesforce引き継ぎ → 更新されたSalesforceアカウントデータフィールドをSalesforceに同期します。

ヒント: Fin Messengerの表示ルールでアカウントフィールドを使うと表示が少し遅れることがあります。パフォーマンス向上にはworkflows内の分岐を使うことをおすすめします。


よくある質問

Salesforceから同期されるアカウントデータは何ですか?

連絡先に関連付けられた主要なアカウントのみがFinに同期され、Salesforce統合設定で指定したフィールドのみが対象です。

Salesforceアカウントデータ同期は双方向ですか?

はい。SalesforceアカウントデータはSalesforceとFin間で双方向に同期されます。Finで同期されたアカウントフィールドの更新は自動的にSalesforceに反映されます。

こちらの回答で解決しましたか?