Install the widget

Open the selected agent and choose Deploy. Copy code from your own dashboard so it contains the correct host and agent ID.

How it appears on mobile

On phones the chat opens as a panel that covers about 85% of the screen and rests against the bottom edge, so visitors can still see part of your page above it. To use the whole screen, tap the expand control (the upward chevron) in the top corner of the chat. Tap it again (it becomes a downward chevron) to return to the shorter view. Closing the chat resets it to the shorter view the next time it opens. On desktop the widget keeps its usual fixed size.

Open chat from your own button

After the floating script loads, add data-fetchply-open to a button to open chat. Use data-fetchply-message with a text value to open chat and submit that message.

The agent knows which page the visitor is on

With the floating widget installed, the agent is told the address and title of the page the visitor is chatting from, so questions like "is this product in stock?" or "does this apply to the plan on this page?" get grounded answers without the visitor pasting a link. Only the page address and title are shared: anything after ? or # in the address (such as search terms or tracking codes) is removed before it reaches the agent, and nothing the visitor types on your page is ever read.

Review and rating events

When visitors achieve a positive outcome or submit a review, the widget dispatches window messages to your website (window.addEventListener('message', ...)):

• fetchply:review_triggered: Dispatched when the agent senses a positive outcome and displays the review card.
• fetchply:review_submitted: Dispatched when a customer submits a rating and optional written feedback (rating, comment, sessionId).

Verify

Check where your widget is installed

Open Install for your agent and look at Install status in the last step. It shows:

Under the status, each website the widget runs on is listed with the times it was first and last seen. Select the page count next to a website to see its pages and when each was last opened.

The status comes from real page visits, so it changes when someone opens your website. You do not need to do anything else. While the status says Not detected yet, the Install page checks again every 30 seconds. You can also select Refresh.

The agent's Overview also shows a small widget badge next to the agent name. Select it to open the Install page.

What is not counted

• Previews inside your Fetchply dashboard.
• Sites opened on your own computer, such as localhost, or by an IP address.
• Test addresses ending in .test, .local, or .localhost.
• The inline chat (iframe) embed. Use the floating widget code if you want install status.

Fetchply saves only the website address and the page address, never the part after a ? or #. Nothing about your visitors is saved here. A page's last-seen time updates at most every few hours, and websites not seen for about six months are removed from the list.

Install status says "Not detected yet"

1. Open your website in a new tab after saving and publishing it. Wait up to a minute, then select Refresh.
2. Check that the install code is on the page and is this agent's code. Each agent has its own code.
3. If you used the inline chat (iframe) embed, its installs are not detected. Switch to the floating widget code to see install status.
4. If you only opened the site on your own computer (localhost) or a test address, open the live website instead.
5. If the chat bubble does not appear on your site either, follow the steps in Verify above first.

Install status says "Not seen recently"

Nobody opened a page with the widget in the last 7 days. If your site gets few visitors, open it yourself and the status returns to Live within a minute. If it still does not change, the code may have been removed. A theme change, a new site template, or a page builder update can remove it without warning, so add the code again.

A website I don't recognize is listed

The list shows every website where the widget ran with this agent's code, such as a staging copy of your site. If you don't recognize one, check which of your sites contain the code. A website you no longer use drops off the list after about six months without visits.