What you will need
- Your install script. It is on the Install tab of the widget designer, at Brand → (your brand) → Chat widget → Install — shown directly on the page, with your widget ID already filled in.
- A simple HTML page you can edit, or any website you control.
- Two browser windows: one for the test page (visitor side), one for your Yaplet dashboard (agent side).
1. Install the widget on a test page
The fastest way to test is to create a minimal HTML file on your computer:
<!DOCTYPE html>
<html>
<head><title>Test</title></head>
<body>
<!-- Paste your Yaplet snippet here -->
</body>
</html>To get your snippet, open your dashboard and go to Brand → (your brand) → Chat widget → Install. Copy the script from the code block there and paste it just before the closing </body> tag in your test file — the same place the Install tab tells you to put it.
Open the HTML file in your browser. The Yaplet launcher button should appear in the corner of the page. If it doesn't appear, see Verify your installation is working for troubleshooting steps.
You can also paste the snippet directly onto any live website you control — the effect is the same. Use a staging or test environment rather than your live site if you don't want visitors to see unfinished settings.
2. Send a message as a visitor
In the browser tab showing your test page, click the Yaplet launcher button. The widget opens. Type a short message — something like "Hello, this is a test" — and press Enter or click Send.
You are now playing the role of a visitor. The message has been sent to your workspace inbox.
3. Find the conversation in the inbox
Switch to your Yaplet dashboard tab. In the left sidebar, click Inbox under Communications. You should see the new conversation at the top of the list — it arrives in real time, usually within a second.
Click the conversation to open it. You will see the message you sent as a visitor, along with metadata in the right sidebar: the widget, IP, location, and the visitor's browser and device.
4. Reply as an agent
Type your reply in the text field at the bottom of the conversation and press Enter or click Send. Switch back to the test page tab — the reply appears in the widget instantly.
You have just completed the full loop: visitor sends → message lands in inbox → agent replies → visitor sees the reply in real time.
What's next
The widget is working. When you're ready to put it on your real site, follow Install Yaplet for the production install guide.
To explore everything else Yaplet can do in your first week, head to What to set up next — a first-week checklist.