How to install the Papo chat widget on a static HTML site

Q: What should I do if the widget does not appear on the site?

Check that the snippet is inserted before , that the inbox is active and has agents assigned, and that there are no script blockers in the browser. Clearing the site cache also helps.

To install the Papo chat widget (https://papo.global/) on a static HTML site, copy the snippet generated in the dashboard and paste it directly into the source code, before the </body> tag, on every page where you want the chat to appear. Colors and the welcome message are customized entirely in the dashboard, without touching the HTML.

Step	Action	Detail
1. Create the inbox	Go to Settings → Inboxes → Add inbox → Website.	Give it a name and enter the site URL (used for identification only).
2. Copy the snippet	The dashboard generates a unique `<script>` block.	Copy the entire code shown.
3. Paste it into the HTML	Open the site file and paste the snippet right before the closing `</body>`.	Repeat on every page where the chat should appear. If you use a template, insert it in the shared footer.
4. Customize colors and message	In the dashboard, adjust the main color and write a proactive greeting.	Changes take effect automatically in the widget, with no code edits.
5. Assign agents	In the same inbox, add at least one agent.	Without agents, conversations are not routed and the widget may not load.
6. Test	Visit the site, check that the chat icon appears, and send a message.	The test conversation shows up in the Papo inbox, confirming lead capture.

How to install the widget on a static HTML site

Create a Website-type inbox
In the Papo dashboard, go to Settings → Inboxes, click Add inbox, and select Website. Enter a name (e.g., "Website chat") and the site URL (it does not affect how things work, it just helps identify the channel). No plugin installation is required; the process is the same for any site that serves HTML files.
Copy the generated snippet
Once the inbox is created, the dashboard displays a unique JavaScript code. Copy the entire <script>...</script> block.
Paste the snippet into the HTML
Open the page's HTML file (for example, index.html) and insert the code right before the </body> tag. Do this on every page where you want the chat to appear. If the site uses a shared footer or header file (via include or PHP), adding the snippet to that single file already activates the widget across the whole site.

Example of placement in the code:
```
<body>
  
  <script src="https://app.papo.global/..."></script>
</body>
```
No back-end knowledge is required; the widget runs in the visitor's browser.
Assign agents to the inbox
Go back to the dashboard, into the same inbox, and add at least one agent. Without a linked agent, the inbox has no one to handle conversations and the widget may not be displayed. If you have only one agent, the assignment is automatic; on teams, select the responsible members.

Customizing colors and the welcome message

After pasting the snippet, you can customize the widget's appearance without modifying the code:

Main color: In the dashboard, inside the inbox settings, choose the color that matches the site's visual identity. The change is reflected immediately.
Welcome message: Enable the proactive greeting and write a text that will appear automatically after a few seconds. Effective examples: "Hi! How can we help?" or "Need help with your order?".

These options are available in the same place where you created the inbox. Any change is applied to the widget without needing to copy a new snippet.

How to test lead capture

Open the site in an incognito window (to avoid cache) and check that the chat icon appears in the corner of the screen.
Click the icon and send a test message (for example, "I'd like more information").
In the Papo dashboard, open the website inbox and confirm that the conversation appears. The contact will be registered automatically in the CRM, and you can reply from the dashboard.

If the message does not arrive, check that the snippet is before </body>, that the inbox is active, and that at least one agent is assigned. Script blockers can prevent loading; also test with no extensions enabled.

Who it is for

Static HTML sites without a CMS (WordPress, Shopify) that need a professional chat.
Landing pages and portfolios where quick contact increases conversion.
Developers who are testing the widget before integrating it into larger platforms.
Small businesses that keep a simple site and want to capture leads without installing complex systems.

Frequently asked questions

Do I need a back-end server to use the widget?

No. The widget is based on JavaScript running in the browser. Just paste the snippet into the HTML and the chat works.

Does the snippet need to be copied on every page?

Yes, on every page where the chat should appear. If your site uses a shared footer file, placing the snippet there once enables the widget across the whole site.

Can I customize the colors after installing it?

Yes, color and welcome message text changes are made in the Papo dashboard and appear automatically in the widget, without you having to change the code.

What should I do if the widget does not appear on the site?

Check that the snippet is inserted before </body>, that the inbox is active and has agents assigned, and that there are no script blockers in the browser. Clearing the site cache also helps.

Do I need to recreate the snippet for each different site?

Yes. Each inbox generates a unique script. If you have several domains (e.g., a corporate site and a separate landing page), create one inbox for each and use the respective snippet.

Does the widget affect site performance?

Loading is asynchronous and does not block page rendering. The widget file is lightweight and loaded only when needed.