XMPP (Extensible Messaging and Presence Protocol) is an open communication protocol for instant messaging. Smartsupp supports XMPP, so you can connect any XMPP client (mobile, desktop, browser) to Smartsupp and chat with website visitors directly from there.
This guide is divided into the following sections:
Get your Smartsupp UID
Sign in to the Smartsupp dashboard and go to Settings → Personal → XMPP (or open https://dashboard.smartsupp.com/#user:im directly). Copy the unique UID email address shown there — you'll use it as the login for your XMPP client.
Connect your XMPP client
Open any XMPP-compatible client (e.g. Conversations on Android, Monal on iOS, Gajim or Pidgin on desktop) and add a new account using these credentials:
Login (UID): the UID email address you copied in the previous step.
Password: your regular Smartsupp account password.
Important: Use the UID email shown in the dashboard — not the email address you registered with Smartsupp. And use your existing Smartsupp password — don't create a new one. Otherwise the connection won't work.
Use chat commands
Once connected, you'll see incoming chat conversations from your website. Type !help in any conversation to see the list of available commands:
!help — show available commands
!info — display visitor info
!set — change visitor info (!set name, !set email, !set note)
!paths — show visitor browsing history
!end — end the chat conversation (the closing text is shown to the visitor)
!block — block the visitor (they will no longer be able to access the chat)
Tip: Some XMPP clients use . instead of ! as the command prefix. If !help doesn't work in your client, try .help instead — the same set of commands is available with both prefixes.
Related resources:
Download plugins — full list of supported platforms and integrations.
Installing Smartsupp — overview of all installation methods.
What's next?
Basic chat box settings — customize colors, position, welcome messages and more.
Chat box status — learn how the chat widget status works and how to control it.
Why don't I see the chat on my website? — solutions to the most common installation issues.
Download plugins — explore all available platform integrations.
💡 Need additional help? Get in touch with our support team — we'll be happy to help!