Chatbox

Send the user's current location to the currently active conversation.

The behavior of this method is identical to the user clicking the location button in the message field, that is, the confirmation dialog is shown.

1sendLocation(): void;

Retrieves the conversation currently shown in the UI.

The result is null when the selected conversation couldn't be found.

1getCurrentConversation(): Promise<ConversationData | null>

Triggers when the user clicks on the "Leave conversation" action.

This event only triggers when the user performs a Leave action from inside the chat UI. Notably, when a user leaves the conversation through other means (for example, they're removed from the conversation using the REST API), this event doesn't trigger.

1onLeaveConversation(handler: LeaveConversationHandler): Subscription;

Triggers when a user launches a custom action on a message within the TalkJS UI.

To set up a custom action, you need to create it on the Chat UI page of your dashboard. If an action is allowed on a particular message, it'll show up in that message's action menu. The name you specify when setting up the action, is also the name you should pass in here. Names are case sensitive. The event you get contains information about the message on which the action was called, including its ID, so you can look it up later via the REST API.

1onCustomMessageAction(action: string, handler: CustomMessageActionHandler): Subscription;

Triggers when a user launches a custom action on a conversation within the TalkJS UI.

To set up a custom action, you need to create it on the Chat UI page of your dashboard. If an action is allowed on a particular conversation, it'll show up in that conversation's action menu. The name you specify when setting up the action, is also the name you should pass in here. Names are case sensitive. The event you get contains information about the conversation on which the action was called, including its ID, so you can look it up later via the REST API.

1onCustomConversationAction(action: string, handler: CustomConversationActionHandler): Subscription

Used to stop listening to TalkJS events.

1off(eventType: 'blur' | 'focus' | 'sendMessage' | 'translationToggled'): void;

Enable or turn off translation by default. This setting is applied to any conversation for which you haven't set a specific value.

1setTranslationEnabledDefault(enabled: boolean | 'auto'): void

Triggers a KeyupEvent when the user releases a key.

This event is only emitted when captureKeyboardEvents is enabled. In that case, it's emitted for every keypress, including regular letters typed into text fields.

event.isInputFocused is true when a TalkJS input area is focused (such as the message field, the search box, or adjacent buttons). When this is the case, keypresses are likely to cause changes inside the chat UI. We recommend that you discard these events, except when implementing global shortcuts that should take effect regardless of whether the user is typing a message or otherwise interacting with the chat UI using the keyboard.

All other event fields are the same as the corresponding fields in the browser's KeyboardEvent.

1type KeyupHandler = (event: KeyupEvent) => void;

Emitted through on("keyup") when the user presses a key. All fields except isInputFocused precisely match the corresponding fields in the browser's KeyboardEvent.

Triggers when the user sends a message using the TalkJS UI.

1type SendMessageHandler = (event: SendMessageEvent) => void;

This event is triggered before the message is sent to TalkJS.

Triggers when the user clicks on the "Leave conversation" action.

1type LeaveConversationHandler = (event: LeaveConversationEvent) => void;

This event only triggers when the user performs an action to leave a conversation from inside the chat UI. When a user leaves the conversation through other means (for example, they're removed from the conversation using the REST API), this event doesn't trigger.

Triggers when the user clicks on a given custom action on a message within the Chatbox.

1type CustomMessageActionHandler = (event: MessageActionEvent) => void;

This event is emitted from Chatbox.onCustomMessageAction when a user clicks on custom action defined in the dashboard.

Triggers when the user clicks on a given Conversation Action.

1type CustomConversationActionHandler = (event: ConversationActionEvent) => void;

This event is emitted from Chatbox​.onCustomConversationAction when a user clicks on a custom action in a conversation within the TalkJS UI.

Triggers when the chat UI gets unfocused, that is, when the user clicks or taps anywhere outside of the chat.

1type BlurHandler = (event: BlurEvent) => void;

BlurEvent is an empty object.

Triggers when the chat UI gets focused, that is, when the user clicks or taps anywhere inside the chat.

1type FocusHandler = (event: FocusEvent) => void;

FocusEvent is an empty object

Triggers when the user toggles translation in a conversation.

1type TranslationToggledHandler = (event: TranslationToggledEvent) => void;

This event is triggered when the user toggles real-time message translation using the built-in toggle.

Lets you show only specific messages in the chat panel.

1// Assuming you have set a `category` custom field in your messages.
2// Only show messages that have no category set:
3{
4  custom: {
5    category: '!exists';
6  }
7}