Message Failed
The message.failed
event is delivered whenever a message sent from your
Surge number fails to be delivered to the recipient’s device.
Common Use Cases
- Track delivery status of sent messages in your own system
- Update conversation analytics
- Log customer interactions
- Surface errors to users
Payload Structure
The ID of the account that sent the message
Always message.delivered
for this event
properties
The unique identifier for the message
The content of the message
properties
The unique identifier for the attachment
The type of the attachment. Can be one of file
, image
, link
, or video
The URL where the attachment can be downloaded
ISO 8601 timestamp of when the message failed
The reason the message failed.
properties
The unique identifier for the conversation
The Surge phone number from which the message was sent
properties
The unique identifier for the phone number
The E.164 representation of the phone number
The type of the phone number. Can be one of local
, toll_free
, short_code
, or demo
properties
The unique identifier for the contact
The first name of the contact, if it is known
The last name of the contact, if it is known
The contact’s phone number in E.164 format