This article explains how to install the ViaDesk live chat widget on your website using Google Tag Manager (GTM), without pasting the code manually on each page.
Requirement: You already have the Website type inbox created in ViaDesk and the code snippet available under Settings → Inboxes → Configuration (or in the final step of the creation wizard).
Before you begin
- Access to your Google Tag Manager account.
- The GTM container already installed on your site.
- The ViaDesk script copied from your inbox (includes
desk.viafacil.comand yourwebsiteToken).
Step 1 — Open Tag Manager
- Log in to your Google Tag Manager workspace.
- Select your site's container.
- Click on Add a new tag.
Step 2 — Create the Custom HTML tag
- Rename the tag (e.g. ViaDesk Chat or Website Chat).
- Under Tag Configuration, choose the Custom HTML type.
- Paste the complete script you copied from ViaDesk into the text area.
- Check the Support document.write box.
Important: Paste the code exactly as ViaDesk shows it. Do not change the https://desk.viafacil.com URL or the inbox token.
Step 3 — Triggering and publishing
- Under Triggering, choose All Pages (or only the pages where you want to show the chat).
- Click Save.
- In the workspace, click Submit.
- Assign a version name (e.g. "Add ViaDesk chat") and publish with Publish.
Step 4 — Verify
- Open your site in an incognito window (or force a reload with Ctrl+F5).
- Confirm that the chat bubble appears.
- Send a test message and verify that it arrives in the inbox at https://desk.viafacil.com/.
Frequently asked questions
- The widget doesn't appear: confirm that the GTM version is published (not just saved) and that the container is loading on the site.
- It appears in the GTM preview but not in production: publish the container changes.
- The chat doesn't reach ViaDesk: check that the script belongs to your inbox and that the token is not incomplete when pasting.
- I only want the chat on certain URLs: change the trigger from "All Pages" to a specific page trigger.
- Blockers or cookie consent: if the site waits for consent for marketing scripts, make sure the ViaDesk tag fires when appropriate (or as essential, according to your policy).
If you cannot publish the tag, the widget does not load, or you need help locating the code in ViaDesk, open a case from the client portal, consult via the online chat with Aura on the site, or write to us on WhatsApp at +54 9 11 7826-8881.
