How do I use Message Logs?

Follow

Emma Bradley

Updated

Our Message Logs feature allows you to access information about the status of your messages in real time and see what’s happening to them at Bandwidth before the delivery information is received. This feature also lets you follow the flow of the message while it’s being sent.

Accessing Message Logs

  1. Log into the Bandwidth Dashboard.
  2. In the top navigation bar, select Insights and click Messaging.
  3. Select Message Logs.

Messaging Insights page

Note: If you’re unable to view this page, please ensure that you have Messaging Insights permissions enabled.

  1. From here you may refine your search for Message Logs using the following parameters:
    • From Date
    • To Date
    • From Number 
    • To Number
    • Status
    • Error Code
    • Message Type
    • Message ID
    • Carrier
    • Direction

Note: Your results will include records from the past 30 days and a maximum of 10,000 records without filtering. Please use the search filters to refine the results. 

What information is available in Messaging Logs?

You may be familiar with these fields from other reporting you use at Bandwidth. An explanation for each field is listed below for your convenience. 

  • Message ID: The unique ID associated with the message.
  • Date/Time (UTC): In Coordinated Universal Time (UTC), this is the date and time the message was received by Bandwidth.
    • Note: You can search within at least the last 30 days.
  • Type: Indicates whether the message is SMS or MMS.
  • Direction: Indicates whether the message is inbound or outbound.
  • From: This phone number is the sender.
  • To: This phone number is the receiver.
  • Status: This is the current status of the message, which is derived from the event status as the message is processed. For more information, please see the list of message statuses below.
  • Error: This is the 4-digit messaging error code associated with the message. For more information, please see the complete list of messaging error codes.
  • Carrier: This is the name of the carrier, either originating carrier or destination carrier depending on the direction of the message.
  • Campaign Class: The campaign class of the message, or unregistered. Only applies to A2P traffic where campaigns have been registered.
  • Segment Count: SMS messages that exceed the character limitation for their given encoding are broken into multiple parts in order to be sent or received. This is the total quantity of parts your message was broken into. 

How status in Message Logs works

Message Logs show the real-time status of the message. This diagram shows the multiple statuses a message goes through as it is being sent through Bandwidth to its intended destination. 

Messaging statuses diagram

Outbound Status  Description
RECEIVED Bandwidth has received your request to send a message. This is the initial status when sending a message to indicate Bandwidth accepted the message. 
QUEUED Bandwidth has successfully received the message and queued it prior to being sent downstream. 
SENDING Bandwidth is in the process of sending your message to the downstream carrier. 
SENT Bandwidth has sent the message and the carrier has accepted the message.  This can be a final delivery status for messages when no delivery receipt (DLR) was requested or when no DLR was received from the carrier.  
FAILED The message could not be sent. The error code associated with this message will provide more information about the specific reason for this final failure delivery status. 
DELIVERED Bandwidth has received a delivery receipt (DLR) from the downstream carrier confirming successful delivery to the carrier or handset (when available). This represents a final success delivery status.  
UNDELIVERED The DLR received from the carrier indicated the message was not deliverable. The error code associated with this message will provide more information about the specific reason for this final failure delivery status. 

2022-01-20_14-44-28.png

Inbound Status  Description
RECEIVED Bandwidth has received a request to send a message to a Bandwidth number. This is the initial status for inbound messages. 
ACCEPTED Message was accepted by the customer. This is the most common final status for inbound messages, indicating successful receipt of a message. 
FAILED The message could not be delivered to the customer. 
DELIVERED This status indicates a DLR was requested by the carrier sending the message to Bandwidth. 

Understanding error codes

The Error field indicates the messaging error for each message. If the message was successful, it will display a 0. If not, it will display a 4-digit error code once the message is in a final delivery status. See the full list of messaging errors for the description and explanation of each error. 

Note: If you send messages using SMPP and/or MM4, you may be more familiar with 3-digit SMPP and MM4 codes. The error codes you’re able to search by in Message Logs are very similar: they have a leading digit that indicates whether the error is a client (customer) or service error.

Understanding segment count

The Segment Count field indicates the number of segments the original SMS message from the user is broken into before it's sent over the carrier networks. Because the number of supported characters in an SMS message is limited based on the encoding used, the message that exceeds that limit will be broken into multiple parts. See our character limitations and concatenation practices to learn more about why your messages may have multiple segments.

Article is closed for comments.