> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talqui.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Website

> Add the Talqui chat to your website with one snippet, or share it as a link that opens full screen.

## Install the snippet

Paste the code from your WebChat connection (see [Get your IDs](https://docs.talqui.chat/guides/chat-sdks/get-your-ids.md)) in the `<head>` of every page, or right before `</body>`:

```html theme={null}
<script type="text/javascript">
  window.__TALQUI_TID = "YOUR_TENANT_ID";
  window.__TALQUI_PCID = "YOUR_CONNECTION_ID";
</script>
<script src="https://webchat.talqui.chat/t.js" async></script>
```

The chat balloon appears in the corner of the page. The script loads `async`, so it never blocks your page.

> [!NOTE]
>
> 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`](https://docs.talqui.chat/guides/chat-sdks/web/javascript-api) from your code:

```js theme={null}
// After login
$talqui.identify({ name: user.name, email: user.email, userHash: user.talquiHash });

// On logout
$talqui.reset();
```

## Direct link

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](https://docs.talqui.chat/guides/push-notifications/browser.md) 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](https://docs.talqui.chat/guides/chat-sdks/troubleshooting.md).

## Next steps

> [card] [JavaScript API](https://docs.talqui.chat/guides/chat-sdks/web/javascript-api.md)
>
> Open the chat from your own button, identify users, send context.

> [card] [Identify users](https://docs.talqui.chat/guides/chat-sdks/identify-users.md)
>
> Keep a logged-in user's history across devices.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.