Skip to main content
The Messenger is the chat widget your visitors interact with on your website. You can customize everything from its visual appearance to the conversation flow and installed apps. Access these settings from Messenger in the sidebar. The Messenger settings are organized across five tabs: Appearance, Spaces, Conversations, General, and App Store.

Appearance

The Appearance tab controls your messenger’s visual identity, color scheme, and code syntax highlighting.

Identity

Identity settings define how your agent presents itself to visitors.
1

Upload an agent avatar

The agent avatar appears in the chat header and next to agent messages. Click Select to choose from presets, or click Upload File to use a custom image. Images must be square JPG or PNG files, under 1 MB, with minimum dimensions of 300×300 pixels.
2

Upload a launcher icon

The launcher is the floating button visitors click to open the chat. You can select a preset icon or upload a custom image with the same requirements as the avatar.
3

Set the messenger position

Choose whether the launcher and chat window appear on the left or right side of the screen. The default is Right.You can also fine-tune the messenger’s placement using the spacing controls:
  • Side spacing — horizontal distance (in pixels) from the edge of the screen
  • Bottom spacing — vertical distance (in pixels) from the bottom of the screen
4

Set the agent name

Enter the display name shown in the chat header. This is the name visitors see when interacting with your agent.
5

Add a tagline (optional)

Add a short tagline to emphasize your agent’s purpose. This appears below the agent name in the messenger header.

Colors

Customize the colors of your messenger to match your brand. Each color accepts a hex value and can be set using the color picker or by entering a hex code directly.
  • Header Color — the background color of the messenger header
  • Accent Color — used for buttons, the send icon, and interactive elements
  • Agent Launcher Background — the background color of the floating launcher button
  • Link Color — the color of clickable links in messages

Syntax highlighting

If your agent shares code snippets in responses, you can choose a theme for how code blocks are highlighted in the chat interface. Select a style from the Syntax Highlight Style dropdown. The default is Atom One Dark.

Spaces

Spaces organize your messenger’s content into distinct sections. The messenger currently supports two spaces: Home and Messages. Home is the central hub visitors see when they open the messenger. It displays your greeting, installed apps, and quick-action cards. Messages is the inbox where visitors view and continue their conversations.

Configuring spaces

You can toggle the Home space on or off. The Messages space is always enabled. Use the Default space on launch dropdown to choose which space opens when a visitor launches the messenger. Set it to Chat to skip the Home space entirely and launch visitors straight into a conversation.

Customize the Home space with apps

The Home space is powered by apps. You install apps from the App Store, then manage them here. Apps are organized into three lists on this tab:
  • Installed Apps — all apps that have been installed for this agent, whether active or not. You can add new instances of an app by clicking Add.
  • Enabled Apps — apps currently visible to visitors in the Home space. Drag to reorder their display priority, or toggle them off to disable.
  • Disabled Apps — installed apps that are turned off. Toggle them on to re-enable, or click the delete icon to uninstall.

Welcome message in the Home space

Set a greeting and introduction that visitors see when they first open the messenger.
  • Greeting — a short welcome line displayed prominently at the top of the Home space (e.g., “Hi there 👋”).
  • Introduction — a secondary line below the greeting that introduces your agent’s purpose (e.g., “How can we help?”).
Both fields support per-language values when you have additional languages enabled.

Conversations

The Conversations tab controls what visitors experience when starting and participating in a chat.

Start conversation text

Customize the text on the new conversation card that appears in the Home and Messages spaces. Choose from preset options for both the Title (e.g., “Chat with us”, “Send us a message”, “Contact support”) and Subtitle (e.g., “We’re here to help”, “AI agent is ready to help”). You can also choose Hide subtitle to show only the title.

Welcome messages

Welcome messages greet visitors automatically when a new conversation begins. You can add multiple messages, and they appear in order as separate chat bubbles from the agent. Click New Welcome Message to add more. This is useful for setting expectations — for example, a first message that greets the visitor followed by a second that explains what the agent can help with.

Suggested messages

Suggested messages are clickable prompts displayed below the welcome message to help visitors get started. You can add as many as you like, but only three are shown at a time. When a visitor clicks a suggestion, it’s sent as their message and removed from the list, revealing the next suggestion in the queue. Each suggestion has two fields:
  • Label — the text displayed on the clickable chip in the chat interface.
  • Message — the text actually sent in the chat when the label is clicked. This can differ from the label, allowing you to show a short label while sending a more detailed prompt.
Write suggested messages that address your visitors’ most common questions. For example, use a label like “Pricing” with a message like “Tell me about your pricing plans and what’s included.”

Input placeholder text

Customize the placeholder text shown in the message input field before the visitor starts typing. The default is generic, but you can personalize it to match your use case — for example, “Ask me anything about our products…”.

General

The General tab covers language support, privacy, and behavioral settings for your messenger.

Supported languages

Set the default language for your messenger interface and enable additional languages. When an additional language is enabled, the messenger automatically switches to it if it matches the visitor’s browser language. For detailed information on how localization works — including what gets translated, agent response language, and multilingual setup — see Localization.

Privacy policy notice

Display a privacy policy notice to visitors when they start a conversation. The notice remains visible until the visitor sends a message or dismisses it, and it won’t reappear after that. Toggle the feature on, then write your notice in the rich text editor. The notice supports basic formatting (bold, italic, underline, links) and has a 200-character limit. This field supports per-language values when additional languages are enabled.

Behavior

The Behavior section contains toggle settings that control branding, references, downloads, and auto-launch timing.
By default, the messenger displays a “Powered by Tiny Talk” link at the bottom. Certain paid plans allow you to hide this branding. Toggle Display a link to the Tiny Talk website off to remove it (when available on your plan).
Allow visitors to download their conversation history as a Markdown file. Toggle Allow conversation download on or off.
Set a delay (in seconds) before the messenger automatically opens on page load. This is useful for proactively engaging visitors. Set the value to 0 to disable auto-launch entirely. Use the slider to adjust the delay.

App Store

The App Store is where you discover and install apps that extend your messenger’s functionality. Apps are added to the Home space of your messenger. Three apps are currently available:

New Conversation

Adds a card to the Home space that lets visitors start a new conversation with your team or AI agent. This is the primary way visitors initiate a chat.

Announcement

Display an announcement card in the Home space with a heading, description, image, and call-to-action button. Useful for promoting new features, sharing updates, or highlighting important information.

External Links

Showcase additional links in the Home space that direct visitors to external resources — such as your documentation, blog, or other pages.
To install an app, visit the App Store tab and click the app card. Once installed, manage the app from the Spaces tab where you can enable, disable, reorder, or configure it.