kris/afv-library
1
0
Fork 0
mirror of https://github.com/forcedotcom/afv-library.git synced 2026-08-08 08:13:49 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
6d9ba6f113
afv-library/skills/salesforce-webapp-feature-react-agentforce-conversation-client-integrating-agentforce-conversation-client/docs/troubleshooting.md
k-j-kim 6d9ba6f113
feat: pin template deps to latest npm versions and flatten skill folders 
- Add pin-template-deps.js to resolve "*" deps to exact npm versions
- Integrate pinning into sync-template-skills npm script
- Remove check-template-skills-versions.js (no longer needed)
- Simplify workflow to single sync step
- Flatten skill output: one folder per skill with cleaned names

Made-with: Cursor
2026-03-18 15:06:43 -07:00

1.2 KiB
Raw Blame History

Troubleshooting

Common issues when using the Agentforce Conversation Client.

Component throws "requires agentId"

Cause: agentId was not passed.

Solution: Pass agentId directly as a flat prop:

<AgentforceConversationClient agentId="0Xx000000000000AAA" />

Chat widget does not appear

Cause: Invalid agentId or inactive agent.

Solution:

  1. Confirm the id is correct (18-char Salesforce id, starts with 0Xx).
  2. Ensure the agent is Active in Setup → Agents.
  3. Verify the agent is deployed to the target channel.

Authentication error on localhost

Cause: localhost:<PORT> is not trusted for inline frames.

Solution:

  1. Go to Setup → Session Settings → Trusted Domains for Inline Frames.
  2. Add localhost:<PORT> (example: localhost:3000).
  3. Restart the dev server.

Blank iframe / auth session issues

Cause: First-party Salesforce cookie restriction is enabled.

Solution:

  1. Go to Setup → Session Settings.
  2. Find Require first party use of Salesforce cookies.
  3. Disable it.
  4. Save and reload.

Multiple chat widgets appear

Cause: Component rendered more than once.

Solution: Render one instance in app layout only.