mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-08-04 22:33:31 +08:00
445ac2f126
Directory renames: webapplications/ → uiBundles/, samples dirs drop -experimental suffix File renames: *.webapplication-meta.xml → *.uibundle-meta.xml, webapplication.json → ui-bundle.json XML metadata: <WebApplication> → <UIBundle> NPM packages: @salesforce/webapp-* → @salesforce/ui-bundle-* Skill names: *-webapplication-* → *-salesforce-ui-bundle-* CLI references: sf webapp → sf ui-bundle Source code: function/variable/type names, import paths, string literals updated ESLint config: Added .worktrees/** to ignores CHANGELOG repo URLs preserved
1.5 KiB
1.5 KiB
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:
- Confirm the id is correct (18-char Salesforce id, starts with
0Xx). - Ensure the agent is Active in Setup → Agentforce Agents.
- Verify the agent is deployed to the target channel.
Authentication error on localhost
Cause: localhost:<PORT> is not trusted for inline frames.
Solution:
- Go to Setup → Session Settings → Trusted Domains for Inline Frames.
- Add
localhost:<PORT>(example:localhost:3000).
Important:
- This setting should be temporary for local development only.
- Remove
localhost:<PORT>from trusted domains after development. - Recommended: Test the Agentforce conversation client in a deployed app instead of relying on localhost trusted domains for extended periods.
Blank iframe / auth session issues
Possible cause: First-party Salesforce cookie restriction may block embedded auth flow in some environments.
Solution:
- Go to Setup → Session Settings.
- Find Require first party use of Salesforce cookies.
- Disable it only if needed and approved by your security/admin team.
- Save and reload.