1. Home
  2. Docs
  3. Unsubscription (SMS MO)
  4. Principles & Description

Principles & Description

Principles

It allows users to notify the SP of their wish to unsubscribe by sending a SMS to an appropriate short-code.



Note:

Please note that the MO Stop is mandatory in Ivory Coast, DR Congo and Cameroon as a method of unsubscription.

Country Short-code
Ivory-Coast 7752
RDCongo  444888
Cameroon 9411
Senegal
Tunisia

Description

Please find below the elements needed to set up from our side this feature:

  • A notification URL: the URL where Bizao will notify/send you the neccessary information:
    • In the header
      • bizao-token => BIZAO_TOKEN
      • bizao-alias => BIZAO_ALIAS
    • In the body (sample)
    •             {
                  "inboundSMSMessageNotification":{
                     "callbackData":"xxxxxxxxxxx",
                           "inboundSMSMessage":{
                           "dateTime":"2019-01-21T12:49:46",
                           "destinationAddress":"+2257752",
                           "messageId":"5c45b1fdfs54654h6f7f53fe20cf",
                           "message":"THE_KEYWORD STOP",
                           "senderAddress":"acr:token"
                           }
                     }
                  }
                  
  • A keyword: the code that your end-user will send followed by the word “STOP”. Provided by Bizao.
    • Sample: “C02 STOP” to 7752

Note:

A keyword can be linked to only one url but a url can be linked to many keywords.

Example:

For a service called TheBestGameStore available in Ivory Coast and Cameroon, the right setting could be the following:

  • Keyword: “TBGS”
  • Notification url: “https://thebestgamestore.com/notification/mo” (same url for all countries)

IMPORTANT

It is not necessary to response back to a MO notification. If you do, make sure your Content-Type (header) is set to “application/json” and the actual response is a json array.

Was this article helpful to you? Yes 1 No

How can we help?