SMS Callback

The callback function allows you to receive back from kaleyra.io the final status and timestamp of a given message you have sent through SMS API. You can also check the phone number to which the message has been sent.

The valid statuses are:

  • Sent - A message has been sent from kaleyra to the target Mobile Network Operator.
  • Delivered - Mobile Network operator has confirmed that SMS has been delivered.
  • Failed - Not possible to deliver the message for any reason.
  • Undelivered - A message about the phone number or content in the SMS being incorrect or unsuitable.

The callback function must be requested within the same API call that is used to send an SMS. Once the information for a given message is fetched by our system, it is sent back to the Callback URL specified in your request. Your callback URL will be called by kaleyra.io either by using GET or POST HTTP methods based on what you specified in your setting.

Your callback URL must be reachable over the public internet. If needed, Kaleyra can help you in supporting IP whitelisting for the callback call generated by Kaleyra.io towards your callback URL. Contact your Kaleyra representative or Kaleyra support for more information.

Supported option for a customer to request a callback: