For AI agents: Find a documentation index at https://talkjs.com/llms.txt (full content at https://talkjs.com/llms-full.txt). Get a markdown version of any page by appending .md to its URL path.

Support inbox

Give your team a place to answer customer messages.

View as Markdown

Use Tori for a ready-made support inbox

If you are using TalkJS for customer support, we recommend trying Tori (our customer support product, built on TalkJS) instead. Tori gives you a shared inbox for answering customers and leaving private notes, with excellent AI support agents that handle the majority of customer questions for you.

Explore Tori or See the team inbox

This guide shows how to add a staff inbox to an existing service. It assumes you have already added the customer-facing chat popup.

Add staff to customer conversations

In your existing conversation setup, add staff as participants. This JavaScript Data API example adds Alex and Sam by their TalkJS user IDs:

const conversation = session.conversation(conversationId);

await conversation.participant("support_alex").createIfNotExists();
await conversation.participant("support_sam").createIfNotExists();

Alex and Sam can now both see the conversation and reply to the customer.

Show the staff inbox

On your staff page, show the inbox with the signed-in staff member's TalkJS user ID. These examples use staffUserId for that ID.

SupportInbox.jsx
'use client';

import { Inbox } from "@talkjs/react-components";
import "@talkjs/react-components/default.css";

export function SupportInbox({ staffUserId }) {
  return (
    <Inbox
      appId="<APP_ID>"
      userId={staffUserId}
      style={{ width: "100%", height: "600px" }}
    />
  );
}

The inbox lists the conversations that staff member participates in. Selecting a conversation opens it for replying.

Private staff messages and notes

For private staff messages and notes, create a separate conversation with a random ID and add only staff as participants. Store the ID with the support case and return it only to staff.