Skip to main content

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.

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.

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.

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

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.

React Native

The attach or camera button does nothing

Cause: missing permissions. Fix: add the camera, microphone and photo library entries from 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. 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 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.

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 or Flutter repository.