Skip to main content

Install the snippet

Paste the code from your WebChat connection (see Get your IDs) in the <head> of every page, or right before </body>:
The chat balloon appears in the corner of the page. The script loads async, so it never blocks your page.
The widget makes no request to Talqui until the visitor opens the chat for the first time. Pages where nobody clicks the balloon cost nothing.

Google Tag Manager

Create a Custom HTML tag with the snippet above and fire it on All Pages.

Single-page apps (React, Vue, Next.js…)

Load the snippet once, in your HTML template or root layout, not inside a component that mounts again on every route. The widget survives route changes on its own. To react to your app (a login, a page the user reached), call $talqui from your code:
The same connection also works as a link that opens the chat full screen, with nothing to install: for a bio, an email, a QR code or a button in an app. Copy it from Link direto (Direct link), below the snippet on the Geral (General) tab. People who open the chat through this link can also get browser notifications when your team replies.

Check that it works

  1. Open your site in a private window and click the balloon.
  2. Send a message.
  3. It shows up in your Talqui inbox. Answer it there: the reply appears in the chat.
Nothing appeared? Open the browser console: the widget logs problems with a [talqui] prefix. See Troubleshooting.

Next steps

JavaScript API

Open the chat from your own button, identify users, send context.

Identify users

Keep a logged-in user’s history across devices.