What it’s for
Web Fetch directs the agent to use the web for information, alongside your connected data. Org Admins decide which sites it may reach.
Before you start
- It shows only when your company has it turned on.
- Web Fetch is off in a new chat until you turn it on, or set it as a chat default.
- Org Admins choose which sites it can reach, in Settings, Fetch.
Steps
Turn it on in a chat
- Open Chat Settings, the cog in the composer, and turn on Web Fetch.
- Check the Internet and Fetch button on the prompt rail. It shows whether it is on.
- To start every new chat with it on, turn on Web Fetch under Chat defaults in Profile, Preferences.
Choose which sites it can reach (Org Admins)
- Go to Settings and open the Fetch tab. It opens on Fetch hostname policies.
- Under Allowlist, type a hostname in Add hostname, such as wikipedia.org, and choose Add. A parent domain also allows its subdomains, so wikipedia.org covers en.wikipedia.org.
- Under Blocklist, add the hostnames Fetch must not use. The blocklist is checked before the allowlist, and a match always blocks the request.
- Use the Enabled checkbox to switch a hostname off without removing it, or the remove icon to take it off the list.
- Choose Save. Changes are staged until you save; Discard drops them.
Keep at least one hostname on the Allowlist. An empty allowlist may deny all hosts in production.
Import many hostnames at once
- Make a CSV file with the columns domain and enabled. Set enabled to enabled or disabled for each row.
- Under Bulk import, choose the list in Import to: Allowlist or Blocklist.
- Choose Choose CSV and pick the file. Snowfire shows how many hostnames are ready to stage, and lists any CSV errors.
- Choose Stage import. The rows join the list, staged until you save.
- Choose Save.
See who changed the lists
- Scroll to Change history on the Fetch tab.
- Read when each change was made, who made it, the action (Saved or Removed), the list, the hostname and whether it was enabled.
- Use Columns to show more columns, and Refresh to load the latest changes.
Check and fix
When Web Fetch is on, the Internet and Fetch button on the prompt rail shows it.
| Problem | Fix |
|---|---|
| Web Fetch is missing from Chat Settings. | Your company has not turned it on. |
| A site is never used. | Check whether it is on the Blocklist, missing from the Allowlist, or not ticked Enabled. |
| Save says a domain appears on both the allowlist and blocklist. | Remove the domain from one of the lists, then save. |
| A domain looks like a public suffix or other overly broad parent domain. | You can still save, but the entry may affect a very large set of hosts. Use a narrower hostname. |
| Add says Domain must include at least one dot. | Enter a full hostname, such as example.com. |
| You see You have unsaved changes. | Choose Save to apply them, or Discard to drop them. |
| A scheduled prompt asks you to enable Web Fetch when you save it. | Its safety check found that the prompt needs the web. Turn on Web Fetch for it. |