Monitoring the Status of your SMS messages

Quick Links

Create New Webhooks Endpoint - API Documentation Link

Retrieve Webhook Lists Endpoint - API Documentation Link

View Webhook Details Endpoint - API Documentation Link

Update Webhooks Endpoint - API Documentation Link

Delete Webhooks Endpoint - API Documentation Link

List SMS Receipts Endpoint - API Documentation Link

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

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:

• Create New webhooks

• Retrieve a list of all webhooks registered against your account

• View details of a specific webhook

• Update webhooks

• Delete Webhooks

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: https://app-2.tallbob.com/distributions/apigatewayreport

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 support@tallbob.com