@nistrix/chat

The Nistrix chat for your own site or app: your visitors talk to your Nistrix agents and team, in a screen you design. It runs in browsers and in React Native, with no other dependency.

It uses a publishable key (nx_pk_live_..., or nx_pk_test_... in your test environment). It is not a secret: it can only open visitor chats on one chat channel, from the sites and apps you listed on it. Never put a secret key (nx_sk_, nx_rk_) in a site or app.

Install

npm install @nistrix/chat

The SDK and publishable keys are on every Nistrix plan, with no add-on.

Get a key

In Nistrix, Integrations → API and MCP → Nistrix in your apps → Publishable keys: choose the chat channel, list your sites (https://shop.example) and apps (com.shop.app), and copy the key.

Use it

import { NistrixChat } from "@nistrix/chat";

const chat = new NistrixChat({
  publishableKey: "nx_pk_live_...",
  storage: window.localStorage, // keeps the visitor between visits
});

const history = await chat.messages();
await chat.send("Hi, can I book a time?", { name: "Bia" });

const stop = chat.subscribe((messages) => render(messages)); // the agent or team wrote
// later: stop();

React Native

Native apps have no origin, so they name themselves with appId (the bundle id or package name listed on the key):

import AsyncStorage from "@react-native-async-storage/async-storage";

const chat = new NistrixChat({
  publishableKey: "nx_pk_live_...",
  appId: "com.shop.app",
  storage: AsyncStorage,
});

Errors

Calls throw ChatError with the HTTP status and the API's code, for example origin-not-allowed (add the site or app to the key) or rate-limited.

Booking pages and lead forms

NistrixIntents uses the same key to show free times, ask for appointments, send leads, and turn sensitive values into data tokens. A booking or a lead is an intent (nx_int_, ten minutes) that your backend confirms with a secret key, unless the key confirms it on its own.

import { NistrixIntents } from "@nistrix/chat";

const nistrix = new NistrixIntents({ publishableKey: "nx_pk_live_..." });

const [slot] = await nistrix.slots({ service: "Cleaning", from: "2026-12-08" });
const booking = await nistrix.book({ start: slot.localStart, name: "Bia", phone: "92991234567" });

const cpf = await nistrix.tokenize("cpf", "529.982.247-25"); // nx_tok_..., never the value
const lead = await nistrix.submitLead({ phone: "92991234567", fields: { cpf: cpf.token } });

Test environment

A nx_pk_test_ key from your sandbox works the same way; conversations, bookings, and leads land in the sandbox, and test is true.

Develop

pnpm install
pnpm test
pnpm build