Monitoring the Status of your SMS messages

Modified on Tue, 18 Jul, 2023 at 2:31 PM

This guide will explore the different ways you can monitor and report on the status of your SMS messages including:

SMS Message Statuses

When sending messages via Tall Bob they will fall into one of four key states

  1. Preparing your message

  2. Sending your Message

  3. Delivering your message

  4. Failing to send your message

Standard SMS Flow

Via Webhooks

You can listen for message status updates by registering callback URLs for the following four webhooks

  • Message prepared for delivery

  • Message sent

  • Message delivered

  • Delivery failed

Creating a webhook through the platform

Creating a webhook via the API

Tall Bob provides a set of APIs that assist in managing your Webhooks through the API you can:

Debugging Webhooks

If you are ever unsure about if a webhook is being sent correct to your endpoint, you can temporarily enable debugging within the Tall Bob platform, refer to the below on instructions how to do this.

Polling via API Endpoint

The Tall Bob APIs provide an endpoint called List SMS Receipts the List SMS Receipts endpoint will allow you to retrieve messages and optionally filter based on:

  • To (recipient's mobile number)

  • Status

  • Date Range

    • before specified date

    • after specified date

You can apply a combination of filters to achieve fine-grained reporting and interrogation of the data.

In Platform Reporting

Similar to the API endpoint if you have access to the Tall Bob platform you can access historical reporting and apply similar filters to view the status of messages sent by the platform, reporting related specifically to API Traffic can be accessed by authorised accounts here:


Helpful Stuff

  • Looking for definitions that revolve around the Mobile, SMS and Telco Industries, then click here

  • Looking for those pesky API docs that don't have all of the waffle like above and just get straight down to business, then go here

  • More information on Sending SMS via API can be found here

  • Other helpful developer documents can be found here

If you ever need further assistance or someone to point you in the right direction you can email the team at 

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article