> ## 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.

# Troubleshooting

> The most common problems when installing the Talqui chat, with the cause and the fix.

## Every platform

### "Invalid link" screen

**Cause:** the tenant ID or the connection ID is wrong, or the WebChat connection was removed.
**Fix:** copy both again from the installation code, as in [Get your IDs](https://docs.talqui.chat/guides/chat-sdks/get-your-ids.md).

### A user sees someone else's conversation

**Cause:** the previous user logged out of your app but the chat wasn't told.
**Fix:** call `reset()` on the website or `logout()` in the apps on every logout. See [Identify users](https://docs.talqui.chat/guides/chat-sdks/identify-users.md#logout).

### The user's history is gone on another device

**Cause:** the user is anonymous, so the history lives on one device; or the `userHash` changed (a new secret, a different user ID).
**Fix:** send a stable `userHash` computed on your backend. See [Identify users](https://docs.talqui.chat/guides/chat-sdks/identify-users.md).

### Metadata doesn't show up

**Cause:** a key with uppercase letters, spaces or accents, or a value that isn't text, a number or a boolean.
**Fix:** check the console warning (website) or the `error` event (apps) and follow the [rules](https://docs.talqui.chat/guides/chat-sdks/metadata.md#rules). Conversation metadata is not shown in the inbox by design.

## Website

### `$talqui is not defined` or `$talqui.open is not a function`

**Cause:** your code runs before the chat script loads.
**Fix:** declare the queue and use `push`, which works before and after loading:

```js theme={null}
window.$talqui = window.$talqui || [];
$talqui.push(["open"]);
```

### The balloon doesn't appear

**Cause:** the snippet isn't on that page, or a Content Security Policy blocks `https://webchat.talqui.chat`.
**Fix:** check the page source for `__TALQUI_TID`, and look for blocked requests in the browser console.

### The widget loads twice in a single-page app

**Cause:** the snippet is inside a component that mounts on every route.
**Fix:** load it once in the HTML template or root layout. See [Single-page apps](https://docs.talqui.chat/guides/chat-sdks/web.md#single-page-apps-react-vue-next-js).

## React Native

### The attach or camera button does nothing

**Cause:** missing permissions.
**Fix:** add the camera, microphone and photo library entries from [Permissions](https://docs.talqui.chat/guides/chat-sdks/react-native.md#2-permissions). On Expo, rebuild the app after changing `app.json` (Expo Go already has them).

### The keyboard covers the message box on Android

**Fix:** set `softwareKeyboardLayoutMode: "resize"` (Expo) or `android:windowSoftInputMode="adjustResize"` (bare).

### `useTalqui must be used inside <TalquiProvider>`

**Fix:** move `TalquiProvider` up so it wraps every screen that uses the hook, usually around your navigator.

### Links open inside the chat, or not at all

**Fix:** links open with `Linking.openURL` by default. To open them in an in-app browser, pass `onOpenUrl` to `TalquiProvider`.

### The unread badge stays at 0

**Cause:** replies are counted only once the chat has loaded.
**Fix:** call `talqui.preload()` after login. For the inline tab, pass `visible` so the SDK knows when the tab is hidden.

## Flutter

### The attach or camera button does nothing

**Fix:** add the entries from [Permissions](https://docs.talqui.chat/guides/chat-sdks/flutter.md#2-permissions) to `Info.plist` and `AndroidManifest.xml`, then run the app again (a hot reload isn't enough).

### The keyboard covers the message box

**Fix:** don't present the chat in a bottom sheet; `open(context)` already uses a full-screen route. Keep `adjustResize` on your Android activity.

### The chat reloads every time I open the screen

**Cause:** a new `TalquiController` is created on every build.
**Fix:** create it once and reuse it (a top-level variable, Provider, Riverpod, GetIt…). If you create it in a `State`, call `dispose()` in `dispose`.

## Push notifications

See [Push notifications: troubleshooting](https://docs.talqui.chat/guides/push-notifications/mobile-apps.md#troubleshooting).

## Still stuck?

Turn on `debug` (`<TalquiProvider debug>` or `TalquiController(debug: true)`) to log every message exchanged with the chat, and open an issue with that log on the [React Native](https://github.com/talqui-oss/talqui-sdk-reactnative/issues) or [Flutter](https://github.com/talqui-oss/talqui-sdk-flutter/issues) repository.


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