設定すること
- Elidoのリンクイベントを今すぐSalesforceへ転送できる、動作するWebhookブリッジ。
- 2つの方法:Salesforce Flow、またはミドルウェアとしてのZapier。どちらもElidoのWebhookで動きます。
- アナリティクスAPIからクリックデータを自前のジョブに取り込む方法。
Elidoには現在Salesforceコネクタがありません。予定されていますが、時期は決まっていません。以下では、コネクタが対応する予定の内容と、今すぐ使える回避策を説明します。
コネクタに含める予定の内容
- OAuth 2.0のConnected App。トークンの手動管理は不要です。
- Elidoのコンバージョンイベントから、SalesforceのLeadとOpportunityを自動作成。
- カスタムのフィールドマッピング。SalesforceのOpportunityのステージ変更をElidoのキャンペーンステータスに反映。
現在:WebhookまたはAPI でつなぐ
コネクタができるまでは、次のいずれかの方法を使ってください。
方法A:Salesforce Flow + Elido Webhook
- Salesforceで、Platform Event トリガーの Flow を作成します。
- Elidoで Dashboard → Webhooks → Add → Generic を開き、SalesforceのWebhookリスナーのURLを貼り付けます。
- 必要なリンクイベント(
link.createdやlink.updatedなど)を有効にします。ElidoはHMAC署名付きのPOSTを送信します。処理の前に、Flow内で署名を検証してください。
方法B:ミドルウェアとしてのZapier
Elido Zapierアプリをブリッジとして使います。Elidoのトリガーを受け取り、コードを書かずにSalesforceのレコードを作成できます。
方法C:アナリティクスAPIをポーリングする
ElidoのアナリティクスAPIからクリックデータを読み取り、Salesforce REST APIでレコードを書き込む定期ジョブを実行します。クリックは1件ずつ送信されないため、ポーリングになります。手順はSalesforce link trackingで解説しています。
コネクタが提供されたら
今作ったWebhookブリッジはそのまま動き続けます。今日準備しておくことはありません。公開は変更履歴でご確認ください。
トラブルシューティング(Webhookブリッジ)
Salesforceで署名検証が失敗する。 HMACの入力には、JSONを解析する前の生のリクエストボディを使います。署名ヘッダーは X-Elido-Signature: v1=<hex> で、X-Webhook-Timestamp ヘッダーと合わせて {timestamp}.{raw_body} に対して計算されます。詳しい手順はWebhookガイドをご覧ください。
イベントがSalesforceに届かない。 Dashboard → Webhooks → Delivery log を確認してください。Salesforceからの4xxは、エンドポイントがペイロードを拒否している(認証の不一致、URLの誤り)ことを示します。5xxはSalesforce側のエラーです。