Message Failed

This event occurs only for some platforms and notifies you about a message that could not be. This may happen when given phone number is wrong or message expires, etc.


Only for Some Platforms

This webhook is used only by some platforms, i.e. by Viber, Mobile, etc.

  "event": "message_failed",
  "timestamp" : "2017-12-29T17:26:17.331Z",
  "data" : {
    "channel": {
      "id": "6456078759331238786",
      "type": "{{CHANNEL_TYPE}}"
    "contact": {
      "id": "6456078781510718339",
      "phone_number": "15558576309",
    "message": {
      "id": "6456078996108088196"
    "error": {
      "code": 1,
      "message": "Error while processing the request."
data.channelobjectChannel where the resides in.
data.contactobjectContact to whom the message was sent but not delivered.
data.messageobjectMessages which was sent, will contain only
data.error.codenumberError code, see errors below.
data.error.messagestringDetail message of an error, see errors below.


Error CodeReason
1Error while processing the request.
2Sending messages to this user is blocked.
3Cannot find user for given phone number.
4Message failed to be delivered within 24 hours.