Connecting to Agentforce

The Salesforce Integration allows you to connect your Salesforce Agentforce agents with Wayfound, enabling comprehensive performance monitoring and management. This integration synchronizes your Salesforce agents with Wayfound's powerful analytics and evaluation tools, providing valuable insights to improve agent effectiveness.

Before You Connect

Salesforce Requirements - What must be enabled in Salesforce before starting:

• Agentforce enabled with at least one active agent

• Data Cloud provisioned

• Agent Analytics enabled in Data Cloud

Who Should Authorize the Connection?

• A System Administrator role with have all of the required permissions

• For non-admin roles the following permissions are needed:

  • API Enabled

  • Data Cloud User permission set

  • Read access to BotDefinition

  • Approve Uninstalled Connected Apps or Use Any API Client

You need to be an active Wayfound user and admin as well as a Salesforce user with required permissions to connect Salesforce via OAuth.

Connecting to Salesforce

To connect Salesforce to Wayfound, visit the Agentforce page in Wayfound's Settings tab:

In the Agentforce page, click . This will take you through Salesforce OAuth:

Once you have logged into Salesforce and authorized Wayfound, you will be taken back to Wayfound's Agentforce page:

Salesforce Configuration

To connect Agentforce agents to Wayfound, agents must be enabled within Salesforce, in addition to agent analytics for Data Cloud. When Wayfound detects that each of these conditions are met, it will display a blue checkmark next to them.

Enable Agentforce

If Agentforce is not turned on in Salesforce, visit the Agentforce Agents setup page by clicking . This will take you to the following page:

Here, take the following actions:

1. Turn on Agentforce

2. Either create a New Agent or enable the Agentforce (Default) Agent

After taking these actions, refresh Wayfound's Agentforce settings page you will see a blue checkmark next to Enable Agents.

Enable Data Cloud

If Data Cloud is not enabled, click to take you to visit the Einstein Feedback and Monitoring Setup page in Salesforce:

NOTE: Access to this page requires that you have already enabled Data Cloud

Here, turn on Agent Analytics. It may take some time for Salesforce to update this setting. Return to Wayfound's Agentforce page to confirm that Agent Analytics have been activated. If so, Wayfound will display a blue check mark next to Enable Data Cloud.

What Wayfound Accesses

When you authorize the connection, Wayfound requests three OAuth scopes from Salesforce:

Scope	What It Does
api	Reads your list of Agentforce agents
cdp_api	Reads agent conversation transcripts from Data Cloud
refresh_token	Keeps the connection active so Wayfound can sync sessions in the background.

All access is read-only. Wayfound never writes data back to Salesforce.

Syncing Agents with Wayfound

Once Salesforce is correctly set up in Wayfound, you can activate your agents on the platform. To do so, activate Supervise in Wayfound for each agent you would like to sync with Wayfound:

Once an Agentforce agent is activated, it appear on The Agents Page as any other agent. Now, you can add a role, goal, and guidelines to your agent to give the Wayfound AI Supervisor the context it needs for analyzing its performance:

Session Recordings with Wayfound

Every hour, Wayfound will sync with your Salesforce instance to pull your active agents' latest sessions.

Once the agent is activated it can take up to an hour for the first conversations to appear. In addition, conversations will only be pulled into Wayfound once they are in Data Cloud. This means it can take some time for conversations to appear. In the worst case, this may take several hours.

You can view your Agentforce Agents' session recordings in Recordings.

Stop Syncing Agents

If you would like to disconnect an Agentforce agent from Wayfound, deactivate Supervise in Wayfound for the agent in Wayfound's Agentforce page. Disconnected agents can always be reconnected on this page. When reconnected, guidelines and previous sessions will be restored. You can always turn it back on again afterwards and you will not lose any guidelines or previous sessions synced to Wayfound.

When an agent is reconnected, Wayfound will not download all sessions that have taken place during the period between the agent's deactivation and reactivation. Instead, Wayfound will only download agent sessions from the last six hours.

Disabling Salesforce

To disconnect all Agentforce agents, click in Wayfound's Agentforce page. This will deactivate all agents and Wayfound will no longer be able to sync any agents unless Salesforce is reconnected.

Troubleshooting

Problem	Likely Cause
OAuth authorization fails immediately	User doesn't have API Enabled or lacks permission to approve connected apps
Connection succeeds but no agents appear	Agentforce isn't enabled or no agents are active
Agents appear but no conversations sync	Data Cloud or Agent Analytics isn't enabled
"Access Denied" or scope errors	User is missing the Data Cloud User permission set