USSD

From its catalog listing

Talk to Hermes from any phone by dialling a USSD short code: no app, no data plan, no smartphone. A gateway platform for Africa's Talking-style USSD callbacks: replies are paged into 160-character keypad screens, exec approvals become numbered menus whose choices appear only after the last page of the command, answers that outlive the session wait in an inbox or arrive by SMS, and a dropped call resumes on the page it left. Ships a keypad-phone simulator served to localhost only.

Good to know before installing

runs an HTTP callback server on 127.0.0.1:8788 while the gateway runs (the user exposes it through their own tunnel); callbacks are authenticated by a 16+ character secret in the URL path because USSD gateways do not sign requests; only when AFRICASTALKING_USERNAME and AFRICASTALKING_API_KEY are set, message text and the recipient's number go to api.africastalking.com (or its sandbox) to send SMS; USSD and SMS are readable by the mobile operator and aggregator; inboxes are in memory only; no telemetry, no shell commands, no self-update.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs USSD_WEBHOOK_SECRET), then asks whether to turn it on.
    hermes plugins install ussd-platform
  2. Said no? Turn it on later:
    hermes plugins enable ussd-platform
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Languages & regions · Web, research & browsing · Chat apps & voice
Maintained by
GodlyDeveloper1 (Community)
Needs
USSD_WEBHOOK_SECRET API key
Needs Hermes
0.23.0 or newer
Version
1.0.0
In the catalog
2026-11-10

Known issues (from its catalog listing)

  • Real handsets need a USSD short code from Africa's Talking or another aggregator; the built-in simulator and the Africa's Talking sandbox need neither.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in languages & regions

All languages & regions plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins