mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-08-09 00:42:46 +08:00
6ab99f7368
- Rename skill folders from salesforce-webapp-* to *-webapp-* convention - Update sync-template-skills.js: set SKILL.md front matter name to dest folder - Remove sync-template-skills workflow and pin-template-deps script - Add .synced-template-skills.json manifest, deploying-webapp-to-salesforce skill - Replace salesforce-webapp-designing-webapp-ui-ux with designing-webapp-ui-ux Made-with: Cursor
61 lines
1.2 KiB
Markdown
61 lines
1.2 KiB
Markdown
# 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:
|
|
|
|
```tsx
|
|
<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.
|