Message Failure Sources

When sending messages to the Channels API, /workspaces/:id/messages/:id, a message can end up in a failed status. The possible failure statuses are

  • sending_failed

  • delivery_failed

Errors are captured in the message reason field and also failure object. See the example below

"status": "delivery_failed",
 "reason": "details: unknown subscriber; reason: unknown_subscriber; code: 1",
 "direction": "outgoing",
 "details": "unknown_subscriber",
 "failure": {
   "code": 15005,
   "source": {
     "name": "sms-messagebird",
     "code": "1"
     }

The above is a snippet of the actual entire message object will be retruend

The source of the failure indicates where the issue impacting the message arose.

pre-processing

It is expected when the message fails during processing (before being sent to a third-party platform)

accounting

It is expected when a message fails specifically due to an accounting/billing service error (before being sent to a third-party platform)

contact

It is expected when a message fails specifically due to an issue with the contacts service (before being sent to a third-party platform)

touchpoint

It is expected when a message fails specifically due to an issue with the touchpoints/ templates service (before being sent to a third-party platform)

sms-messagebird

It is expected when a message fails due to an error returned from the SMS platform. In such instance failure.source.code's value will contain the specific errors returned from the SMS platform and/or a downstream SMS carrier. Refer to SMS Platform Extended Error Codes for platform-specific extended errors

email-messagebird

It is expected when a message fails due to an error returned from the email platform. In such instance failure.source.code's value will contain the specific errors returned from the email platform.

whatsapp

It is expected when a message fails due to an error returned from the whatsapp platform. In such instance failure.source.code's value will contain the specific errors returned from the whatsapp platform. Refer to WhatsApp Cloud API error codes for platform-specific extended errors

facebook

It is expected when a message fails due to an error returned from the facebook platform. In such instance failure.source.code's value will contain the specific errors returned from the facebook platform. Refer to Messenger platform error codes for platform-specific extended errors.

line

It is expected when a message fails due to an error returned from the LINE platform. In such instance failure.source.code's value will contain the specific errors returned from the Line platform. Refer to LINE error responses for platform-specific extended errors.

apple-business-chat

It is expected when a message fails due to an error returned from the Apple Messages platform. In such instance failure.source.code's value will contain the specific errors returned from the line platform. Refer to Apple Messages response codes for platform-specific extended errors.

voice

It is expected when a message fails due to an error returned from the voice platform. In such instance failure.source.code's value will contain the specific errors returned from the voice platform.

instagram

It is expected when a message fails due to an error returned from the Instagram platform. In such instance failure.source.code's value will contain the specific errors returned from the Instagram platform. Refer to Messenger platform error codes for platform-specific extended errors.

Last updated