Menu Builder


HashTalk Menus are your building blocks of USSD apps. Menus messages are displayed to users during an interactive USSD session, while menu items are the available user options in a typical USSD screen. Start using the menu builder by clicking on the Button on the Products List Page

All menus have 2 common fields: Name and Menu Position. The "Name" Field is a text field used to describe or group the menu. While the "Menu Position" describes if this menu is a START, CONTINUE OR TERMINAL menu. There can be only one "START" menu in a product.


Static Menus

Static menus are just static. Displaying what you want WYSIWYG-wise!

  • Message - The WYSIWYG text to display to the user
  • Menu Positions - START, TERMINAL, CONTINUE

Dynamic Menus

Dynamic Menus enable USSD apps builders extend the Static Menus by making API calls to your core business REST APIs.

  • Menu Builder - This field describes you want HashTalk to send/receive information from your APIs. Menu builder option can be:
    1. POST, THEN WAIT:
      Call the API then wait for 12 seconds. If response doesn't come early, kill session and respond to user that transaction is still processing. Your API is expected to send an SMS. Use only in Terminal menus.

    2. POST, THEN HANDS-OFF: 
      Call the API, and don't expect a response on time. Just tell the user that the transaction will be processed. User should receive an SMS from you after complete processing. Use only in Terminal menus.

    3. POST FOR LOOKUP:
      Call the API, and wait for the response. This is used in order to continue the session.

  • Processor - This is the Post URL that HashTalk will call. Please note that the Base URL in your tenant is the host for all the APIs.

Enquiry Menus

Simply put, enquiry menus display information so that the user can respond. Any type if response is receivable. The data collected will be passed to your Core API using a Dynamic Menu.

  • Message - This is the message that will show to prompt the user to enter some information
  • Value Key Name - This is the Field name that HashTalk will send in the Posts to your Core API

Function Menus

Function menus perform Operations on what your user entered. Basically, "SAVE" the response. More functions can be introduced as required.

  • Handler - What function you require
  • Value Key Name - Extra Parameters for the function

List Loader Menus

A list loader menu calls a back end API to return a list of options for the user to choose from which is saved in the parameter list with [LIST NAME]. The list loader menu usually has 3 options based on the list returned.

  1. if the list is empty
  2. if the list contains only one item, which is automatically selected for the user
  3. if the list contains more than one item, then a paginated menu is followed that will paginate the list in

List loaders cannot start a product!

Generating/Compiling Scenes

Scenes are generated from menus and menu items. After building your menus, click on the button to compile. This is the first stage of deploying your USSD app.

Deploying Scenes

Here you deploy the changes made to the simulator. Like a staging environment before final deployment to customer's access. Which is done on the USSD Short codes area.

Downloading Scenes

This menu helps you save a copy of your product's menus as a personal backup or in cases of your corporate's version control system.

Uploading Scenes

This menu helps you restore a previously downloaded product menu version.