Set Up Live Responses / Reporting (ECA Setup)

This step enables live delivery reporting, inbound replies, and link hit notifications back into Salesforce. This uses Salesforce's External Client App (ECA) framework.

Deploy the External Client App

  1. In the Kudosity setup screen, locate the Live Responses / Reporting section.
  2. If you see a Setup External Client App button, click it.
  3. Wait 30–60 seconds for the spinner to complete — the ECA is being deployed in the background.
  4. Once complete, the screen will show "Your ECA is ready" with a Consumer Key input field.
ℹ️

If Live Responses already shows CONNECTED and no button appears, the ECA is already set up — no action needed.


Copy Your Consumer Key

  1. Click Open External Client App Manager — this opens Salesforce Setup in a new tab.

  2. Find Kudosity in the list.

  3. Click View → View Consumer Details.

  4. Authenticate if prompted — Salesforce may send a verification code to your email.

  5. Copy the Consumer Key.

Save Key and Connect

  1. Return to the Kudosity setup screen.

  2. Paste the Consumer Key into the field.

  3. Click Save Key & Connect.

  4. You will be redirected to a Salesforce OAuth consent page — click Allow.

  5. You will be redirected back and Live Responses / Reporting will show CONNECTED.


Troubleshooting ECA Setup

IssueResolution
Spinner times out / VF session bridge errorClick Setup External Client App again to retry
Already shows CONNECTED with no buttonECA is already set up — no action needed
Consumer Key field disappears after clicking Open App ManagerThe system detected an existing Connected App session — refresh the Kudosity setup screen and check if Live Responses now shows CONNECTED
Error email received about ECA failingGo to the Kudosity Config page and click Setup External Client App to retry