Concepts

Concepts used in Twilio BDK Book.

An SMS (Short Message Service) message. Represents a text communication sent over a cellular network,typically between mobile phones.

Field Name	Description	Type
sid	The unique, Twilio-provided string that identifies the Message resource.	optional[text]
body	The text content of the message	optional[text]
num_segments	The number of segments that make up the complete message. SMS message bodies that exceed the character limit are segmented and charged as multiple messages. Note: For messages sent via a Messaging Service, num_segments is initially 0, since a sender hasn't yet been assigned	optional[text]
sender_number	The sender's phone number (in E.164 format), alphanumeric sender ID, Wireless SIM, short code, or channel address (e.g., whatsapp:[phone]). For incoming messages, this is the number or channel address of the sender. For outgoing messages, this value is a Twilio phone number, alphanumeric sender ID, short code, or channel address from which the message is sent	optional[text]
recipient_number	The recipient's phone number (in E.164 format) or channel address (e.g. whatsapp:[phone])	optional[text]
price	The amount billed for the message in the currency specified by price_unit. The price is populated after the message has been sent/received, and may not be immediately available. View the Pricing page for more details.	optional[number]
account_sid	The SID of the Account associated with the Message resource	text
num_media	The number of media files associated with the Message resource.	number
status	The status of the message, for more information about possible statuses see Message Status	optional[text]
messaging_service_sid	The SID of the Messaging Service associated with the Message resource. A unique default value is assigned if a Messaging Service is not used.	text
date_sent	The RFC 2822 timestamp (in GMT) of when the Message was sent. For an outgoing message, this is when Twilio sent the message. For an incoming message, this is when Twilio sent the HTTP request to your incoming message webhook URL.	optional[datetime]
date_created	The RFC 2822 timestamp (in GMT) of when the Message resource was created	optional[datetime]
date_updated	The RFC 2822 timestamp (in GMT) of when the Message resource was last updated	optional[datetime]
price_unit	The currency in which price is measured, in ISO 4127 format (e.g. usd, eur, jpy).	text
error_code	The error code returned if the Message status is failed or undelivered. If no error was encountered, the value is null.	optional[number]
error_message	The description of the error_code if the Message status is failed or undelivered. If no error was encountered, the value is null.	optional[text]