Skip to content

Account Settings: Wallet, Profile, and API Keys

The top-right header is the account chrome on every logged-in page: wallet, notifications, WhatsApp number expiry, and the profile menu. This guide is what those controls open.

Agents see a reduced header (no Go Back; wallet may be hidden).

Header tour

Left

ControlWhat it does
LogoHome / dashboard (agents stay put)
Menu (hamburger)Collapse / open the sidebar
Go BackBrowser-style back (hidden for Agent accounts)
NowLive clock
Expiry pillWhatsApp number plan expiry. Lists numbers, plan, end date, days left. Renew starts gateway recharge

Right (the profile cluster)

ControlWhat it does
WalletCurrent balance in the selected currency; dropdown lists all wallet currencies
BellIn-app notifications; View More opens the notifications list
Avatar + nameProfile menu (items depend on role) + Logout

Wallet

  • Shows Available balance for the selected currency (flag + amount).
  • Open the dropdown to switch currency if the account has more than one wallet.
  • Empty state: No balances.

Full wallet screen: My Wallet / Transactions (/system/wallet-history).

ToolWhat you do
TransactionsSearch, filter, export wallet history
Recharge WalletAdd credits (if the account is allowed to recharge)
RefreshReload balances

Credits here pay SMS, WhatsApp, RCS, fallback hops, and inbox replies. Low balance is the most common send failure. Check this header before you open a ticket about a failed campaign.

Notifications

  • Badge = unread count.
  • Dropdown lists recent alerts.
  • View More → notifications page (system/notifications / broadcast notifications, depending on tenant).
  • Inside User Profile → Notifications, choose which alerts you receive.

WhatsApp number expiry

If a connected WhatsApp number’s subscription / plan is ending:

  • The header shows an expiry warning.
  • Expand to see mobile number, plan, end date, days left.
  • Renew opens recharge for that number.

This is not the same as wallet credits. You can have SMS balance and still fail WhatsApp because the number plan ended. Renew from the pill, or see Subscriptions.

Profile dropdown

Always present:

  • Account header: username + account type (User / Reseller / Team / Agent / Account Manager, and similar)
  • Dynamic links from profile menu
  • Logout

Typical items (you may see a subset):

Menu itemOpensWhat it is
ProfileUser Profile / Edit profileName, mobile, email, entity, avatar, services, default currency
My WalletWallet historyTransactions and recharge
TeamTeam managementRoles and team users (not inbox agents)
Get WidgetsWhatsApp chat widgetEmbed a click-to-chat button on a website
Self WhitelabelWhite-label brandsLogo, domain, branding (Reseller / Super Admin)
Login HistoryLogin historyWho signed in, when, from where
API KeyDeveloper API keysKeys for SMS / WhatsApp / RCS HTTP APIs (sometimes under System → Developer instead)
LogoutSign outEnds the session

If an item is missing, the role does not include that profile-menu entry.

User Profile

Route: /system/edit-user-profile (and /system/user-profile/:userId).

Sidebar tabs (each can be hidden by permission):

TabWhat you do
Profile SettingsAvatar, username, personal / entity details, assigned services, default currency
PreferencesDefault currency, extra wallet currencies, service pricing alignment
AuthenticationTwo-step login: OTP and/or Google Authenticator
NotificationsWhich in-app / email alerts to receive
SecurityChange password
Delete AccountRequest account deletion
DocumentsUpload KYC / business documents

Keep profile, password, and 2FA up to date. API keys and wallet live nearby in the same header cluster.

Team vs Inbox agents

/system/team-management

ScreenWhat it is
RolesPermission packs for team members
Team usersPeople who log in under this account

This is portal team access, not Team Inbox agents. Inbox agents are created under Team Inbox → Agent list. Portal Team users open the dashboard; inbox agents pick chats.

Related (if the role has it): Agent config and Agent analytics.

Get Widgets

/whatsapp-app/getWidgets

Embed a WhatsApp live-chat button on your site (no coding required). Chats still land in Team Inbox.

SettingMeaning
WhatsApp NumberConnected business number
Widget Button NameOptional, max 15 characters
PositionLeft or right
Theme colorButton colour
Brand NameMax 15 characters
Brand SubtitleMax 40 characters
Brand Image URLLogo
Welcome MessageMax 200 characters

Copy the generated snippet onto the website. Pick the same WhatsApp number the inbox is watching, or chats open on a different thread.

API keys

/system/apikey — also System → Developer → API Key on many accounts.

ToolWhat you do
Generate API KeyCreate a key with a title
IP allowlistRestrict which servers can call the APIs
PriorityQueue priority for sends
Rotate / disable / deleteGovern keys
Read API DocsOpens this Developers document

This is the same apikey header used on SMS /v1/sms, WhatsApp /v1/whatsapp, and RCS /v1/rcs. See Authentication. Treat the key like a password; do not put it in a website widget or a mobile app.

Self Whitelabel

/system/self-whitelable (Reseller / Super Admin).

Brand library: add / activate brands (logo, look and feel, domain). Customers of a reseller see that brand in the header logo instead of the default Omni logo.

Login History

/system/login-history

Audit table: search / filter login and logout times (and related session details). Use it to spot unexpected access. Pair with Authentication (OTP / Google Authenticator) on the profile.

Subscriptions

If the tenant has Subscription in the menu (/subscription/...):

ScreenWhat it is
My subscriptionCurrent plan
PlansAvailable plans
BillingInvoices / payment
UsageConsumption
SuccessPost-payment confirmation

WhatsApp number expiry in the header is related: renewing a number plan is different from recharging the wallet. You often need both — plan for the number, wallet for each message.

Logout

Always the last item in the profile menu. After logout you must sign in again. Unsaved compose screens are lost.

How these tools connect

  • Wallet (header) funds SMS, WhatsApp, RCS, fallback hops, and inbox replies.
  • Fallback is selected on compose; it does not send by itself.
  • Profile → API Key is how developers send without the portal.
  • Get Widgets + Team Inbox = website visitors chatting on WhatsApp.
  • Expiry pill + Subscription / Renew keep WhatsApp numbers live.
  • Login History + Authentication keep the account safe.

Typical issues

AreaSituation
FallbackRule created but not selected on compose — Fallback
FallbackBackup channel has no credits / unapproved template
WalletSend fails with insufficient credit — check the header balance
ProfileMissing menu item — role does not include that profile-menu entry
2FALogin blocked until OTP / authenticator is completed
WidgetsWrong WhatsApp number selected — chats go to another inbox
ExpiryWhatsApp number plan ended — Renew from the header pill

Next: Fallback to chain channels, Authentication for the apikey header, Team Inbox for widget chats.

Was this page helpful?