Skip to main content

Tutorial - creating menu item

This section presents a step-by-step solution to creating menu item with a process of type "USSD App". In the beginning of this tutorial, there are 2 menu items already defined. As a result, selected menu variant will have 3 options to choose from, each executing a different process.

Requirements

  • User is logged in.
  • Application has simulator available.
  • User chose the application.

Steps to follow

  1. Open MENU BUILDER tab, if it's not already opened.

  2. Click the CREATE NEW button in Menu builder.

    A new and empty menu item appears.
  3. Click the newly created item to expand it.

  4. Change Selected process to External USSD App in the newly created menu item.

  5. Fill the USSD App Id field.

  6. Click the Define New Process button.

  7. Enter ProcessId.

  8. Click the Add Next Parameter button.

  9. Type in a name for a parameter. In this example we use Cash Amount. Choose type of regex and Regex value of [1-9]\d{1,4}.

    This example regular expression represents an amount of money to transfer from ₦1 to ₦9999.
  10. Apply by clicking the APPLY button.

    A newly added parameter is now present.
  11. Enter the newly created parameter's value. This also gets rid of the validation error.

  12. Click the SAVE CHANGES button to apply the newly created menu.

    The button may be inactive, when there are errors in any of the menu variants and their menu items. Entering correct values fixes this issue and allows to save the changes. Upon saving, the changes are available after a few seconds. It's important to remember that menu on its own is not usable. It has to be linked to some shortcode string definition, in order to be accessible. Creating such link is explained in the next tutorial.