Skip to main content

GitHub

Source, issues and changelog

npm

Package and versions

Example app

Runs in Expo Go
Works in Expo Go. The SDK has no native code of its own: no dev build, no config plugin, no prebuild.
Unread count in the host appFull screen chat with text, an image and a voice messageThe chat inline in a tab

Requirements

React Native 0.73 (Expo SDK 50) or later, iOS 15, Android 7.0 (API 24).

1. Install

Using an AI coding agent? Point it to AGENT_INSTRUCTIONS.md: a step-by-step install it can follow and validate on its own.

2. Permissions

Attachments, photos and voice messages need these entries.

3. Add the provider

Wrap your app once, with the values from Get your IDs:

4. Open the chat

From any screen below the provider:
The chat opens full screen and closes with the header button or the Android back button. The conversation keeps running while it is closed.

Or inline, in a tab

visible tells the SDK whether the tab is on screen, so replies count as unread while it isn’t. hideCloseButton removes the header’s close button, which has nothing to close in a tab.

5. Identify the user

The pre-chat form is skipped and your team sees who is talking. How to compute userHash →

6. Send context

Rules and where it shows up →

7. Events and unread badge

Call talqui.preload() early (after login, for example) so replies are counted before the user first opens the chat. All events →

8. Logout

Forgets the user on this device, clears everything you set, unlinks the push token and starts a fresh anonymous visitor.

9. Push notifications

Optional: notify the user when a reply arrives while they are away. Set up Firebase and hand the device token to the SDK. See Push notifications for mobile apps.

API reference

<TalquiProvider>

useTalqui()

useTalquiEvent(name, callback)

Subscribes to one event for the lifetime of the component.

<TalquiChat>

Example app

Open it in Expo Go. It has an “Open chat” button with the unread count, a “Chat” tab, and buttons for identify, metadata, prefill and logout, connected to the Talqui demo workspace. Something not working? See Troubleshooting.