Skip to content

📱 Mobile agent app — install ChatterMate on your phone

Choose a tag to compare

View all tags
@chattermate chattermate released this 18 Jul 16:27
v1.0.15
5ead9a6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Released 2026-07-18

Your agents can now work from their phone. The dashboard installs to the home screen like a native app — bottom navigation, a full-screen inbox, and push notifications that open straight into the conversation. Plus one-click Messenger and Instagram connections, and WhatsApp template messages for starting conversations.

Highlights

Install ChatterMate on your phone

  • Add to home screen — the agent dashboard is now an installable app (PWA) on Android, iOS and desktop. Own icon, own splash screen, no browser chrome.
  • Built for one hand — bottom navigation across Inbox, People, AI Agents and Analytics, with everything else a tap away in the More sheet. Every destination from the desktop sidebar is still reachable.
  • Full-screen inbox — the conversation list, chat and details stack into full screens instead of squeezing three desktop panes onto a phone. Your phone's back button walks back through them.
  • Keyboard-aware composer — the message box stays above the on-screen keyboard instead of hiding behind it.
  • Push notifications that go somewhere — tapping a notification opens that exact conversation. Previously a tap did nothing.
  • Desktop is unchanged.

Agents can pick up AI chats

  • The AI queue is visible — agents now see conversations the AI is still handling, not only the ones already assigned to them. Previously the queue was invisible, so there was nothing to take over.
  • "Take over" is on the chat screen — no longer hidden behind the info panel, which was hard to reach on a phone.
  • People directory — agents get read-only access to customer records. Editing still requires a manager role.
  • Two new permissions, view_unassigned_chats and view_people, so granting queue access never exposes another agent's private conversations. Existing agent roles get both automatically on upgrade.

Messenger and Instagram, in one click

  • Connect a Facebook Page or Instagram account without creating your own Meta app — sign in with Facebook and pick the account.
  • Instagram without a Facebook Page — connect a professional Instagram account directly via Instagram Login.
  • Real customer names on Messenger and Instagram conversations instead of opaque IDs.

WhatsApp templates and outbound messages

  • Start conversations with WhatsApp's approved message templates, not just reply to inbound ones.
  • Phone-number identity — customers are recognised by phone across sessions.

Fixes

  • The End Chat dialog no longer promises a rating on channels that can't display one.
  • Instagram's changes[] webhook shape is now accepted.
  • Switching the agent behind a channel starts a fresh session instead of continuing a stale one.
  • Messenger tokens that were valid are no longer rejected.
  • The integrations connect modal is readable in light theme.
  • Help center admin — filter toolbar, category headers and toggle switches now lay out correctly on a phone.

Under the hood

  • One service worker handles both offline caching and push, replacing the separate Firebase worker. New builds now prompt agents to reload rather than activating silently under an open tab.
  • Push payloads are data-only, which stops duplicate notifications and lets taps deep-link correctly.
  • Push permission is requested from a button, not on page load — the old placement silently failed on iOS.
  • Webhook logging records message IDs rather than raw request bodies.

Upgrade notes

  • Run migrations. This release adds the two permissions above and backfills every existing role that can already view chats — no manual per-organization setup.
  • One default role per organization. Installs seeded both Admin and Agent as the default, so newly invited users could land on either depending on database ordering. The migration fixes this so invites consistently land on Agent. Existing users keep whatever role they already have.
  • Reverse proxy: sw.js and manifest.webmanifest must be served with no-cache. If you run a customised nginx config, add these — a long cache freezes the service worker and stops future updates from reaching installed clients.
  • iOS push requires iOS 16.4+ and the app added to the home screen. This is an Apple restriction.
  • Existing browser sessions will unregister the old Firebase service worker automatically on first load.

Security

  • The chat takeover endpoint checked a permission that does not exist and performed no organization scoping, so any signed-in user could claim an unassigned conversation in another organization by guessing its session ID. Both are fixed, with tests. Self-hosted installs should upgrade.
  • One-click Meta signup on Cloud is limited to an allowlist during rollout.
Assets 2
Loading