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 21004
Tunisia
Burkina Faso 383

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

The format of your notification URL response must be JSON and must provide one of the following responses:

User not in your database
{
“status”: “unknown”
}

User in your database but no more subscribed
{
“status”: “already deactivated”
}

SMS MO notification handled and subscription deactivated
{
“status”: “deactivated”
}

Other cases
{
“status”: “pending”
}

Was this article helpful to you? Yes 1 No 2

How can we help?