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: callreset() 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 theuserHash 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 theerror 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 blockshttps://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 changingapp.json (Expo Go already has them).
The keyboard covers the message box on Android
Fix: setsoftwareKeyboardLayoutMode: "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 withLinking.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: calltalqui.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 toInfo.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 newTalquiController 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 ondebug (<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.