kris/afv-library
1
0
Fork 0
mirror of https://github.com/forcedotcom/afv-library.git synced 2026-08-08 00:10:29 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
474c26c00d
afv-library/skills/salesforce-webapp-agentforce-conversation-client/docs/troubleshooting.md
k-j-kim 474c26c00d
fix: resolve skill validation errors 
- Move .template-versions.json from skills/ to root
- Shorten skill names to meet 64-char limit:
  - salesforce-webapp-feature-micro-frontend-generating-micro-frontend-lwc → salesforce-webapp-micro-frontend-lwc
  - salesforce-webapp-feature-react-agentforce-conversation-client-integrating-agentforce-conversation-client → salesforce-webapp-agentforce-conversation-client
  - salesforce-webapp-feature-react-file-upload-implementing-file-upload → salesforce-webapp-react-file-upload
- Expand descriptions to meet 20-word minimum with trigger context
2026-03-17 17:44:09 -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.