The app brings AiHummer to phone and desktop. It is a native app that gives
employees a convenient way to talk to their agents in real time — from a phone, a
tablet or a computer.
The server side is the os-client service module from the built-in
Marketplace: it installs like any other
module, but it is not a channel connector — it is a service backing the client
apps (WebSocket bridge, push notifications, media relay). It is configured in
the Admin UI.
[!NOTE]
The Community plan includes only the core channels — Telegram, web and the web
widget. The mobile/desktop app requires an active Starter, Business or
Enterprise licence — see Licensing.
The app
The app is available across all major platforms (identifier —
ru.aihummer.app) — the download buttons for App Store, Google Play,
AppGallery, RuStore, Windows and Linux are at the top of this page.
QR-code sign-in only
On mobile there are no logins or passwords. Sign-in is QR-only: an
operator generates a code in the Admin UI, the user scans it in the app, and the
device is paired to your instance. No credential entry is required afterwards.
If sign-in fails
The app distinguishes the reasons a sign-in fails and shows a specific message
with a hint:
Message
Cause
What to do
“The code is invalid or has expired.”
Pairing codes are one-time and time-limited.
Generate a fresh QR code in the Web UI and scan it again.
“Request timed out. Check your connection.”
The server did not answer in time.
Check the device’s internet and the server’s reachability, then retry.
“No connection to the server. Try again.”
The instance is unreachable from the device.
Make sure the instance is running and its public address is reachable from your network (VPN/firewall), then retry.
“The app service isn’t responding. The os-client plugin may not be installed…”
The code was accepted but the app bridge is down.
Install (or restart) the os-client plugin in Web UI → Plugins.
“Couldn’t parse the connection string.”
The wrong code was scanned/pasted.
Use the QR/connection string from the AiHummer Web UI specifically.
Real time and notifications
Real-time chat — messages and agent replies arrive instantly.
Push notifications — the user is alerted even when the app is in the
background or closed.
Branding
The app ships with default AiHummer branding. Once paired with your instance
it adopts that instance’s logo and name, so employees see your organization’s
branding rather than a generic product.
[!NOTE]
Default branding applies until pairing completes; your company’s logo and name
take effect as soon as the device is paired.
**The app brings AiHummer to phone and desktop.** It is a native app that gives
employees a convenient way to talk to their agents in real time — from a phone, a
tablet or a computer.
The server side is the **`os-client` service module** from the built-in
[Marketplace](/en/v1.0/marketplace/overview-tiers): it installs like any other
module, but it is not a channel connector — it is a **service backing the client
apps** (WebSocket bridge, push notifications, media relay). It is configured in
the Admin UI.
> [!NOTE]
> The Community plan includes only the core channels — Telegram, web and the web
> widget. The mobile/desktop app requires an active **Starter**, **Business** or
> **Enterprise** licence — see [Licensing](/en/v1.0/commercial/licensing).
## The app
The app is available across all major platforms (identifier —
**`ru.aihummer.app`**) — the download buttons for App Store, Google Play,
AppGallery, RuStore, Windows and Linux are at the top of this page.
## QR-code sign-in only
On mobile there are **no logins or passwords**. Sign-in is **QR-only**: an
operator generates a code in the Admin UI, the user scans it in the app, and the
device is paired to your instance. No credential entry is required afterwards.
## If sign-in fails
The app distinguishes the reasons a sign-in fails and shows a specific message
with a hint:
| Message | Cause | What to do |
|---|---|---|
| "The code is invalid or has expired." | Pairing codes are one-time and time-limited. | Generate a fresh QR code in the Web UI and scan it again. |
| "Request timed out. Check your connection." | The server did not answer in time. | Check the device's internet and the server's reachability, then retry. |
| "No connection to the server. Try again." | The instance is unreachable from the device. | Make sure the instance is running and its public address is reachable from your network (VPN/firewall), then retry. |
| "The app service isn't responding. The os-client plugin may not be installed…" | The code was accepted but the app bridge is down. | Install (or restart) the **os-client** plugin in Web UI → Plugins. |
| "Couldn't parse the connection string." | The wrong code was scanned/pasted. | Use the QR/connection string from the AiHummer Web UI specifically. |
## Real time and notifications
- **Real-time chat** — messages and agent replies arrive instantly.
- **Push notifications** — the user is alerted even when the app is in the
background or closed.
## Branding
The app ships with **default AiHummer branding**. Once paired with your instance
it adopts **that instance's logo and name**, so employees see your organization's
branding rather than a generic product.
> [!NOTE]
> Default branding applies until pairing completes; your company's logo and name
> take effect as soon as the device is paired.
## Where next
- Installing connectors: [Marketplace](/en/v1.0/marketplace/overview-tiers).
- For your website see the [Web widget](/en/v1.0/channels/web-widget).
- For chat apps see [Telegram](/en/v1.0/channels/telegram) and
[MAX](/en/v1.0/channels/max).
