for Developers
QuickstartsAPI ReferenceSDKsTutorialsDashboard
QuickstartsApi ReferenceTutorials

Quickstarts

SMS
Test credits & API keysSend an SMSReceive an SMSTroubleshooting
WhatsApp
WA Deep DiveGetting started WASandboxInstall ChannelMessage TemplatesCreate media templateSend a messageSend message with buttonsSend interactive messagesSend media template messageCreate and send authentication templatesSticker messagesProduct messagesCarousel templateCoupon templateReferralNumber RatingsСustomer's opt-insNumber MigrationWhatsApp BusinessTroubleshooting
Facebook
Quick RepliesMedia TemplatesGeneric TemplatesMessaging Referrals
Voice Calling
Get your API keysMake a voice callReceive callsSIP TrunkingTroubleshootingStructure of a CallCall and Leg statuses
Voice Messaging
Get your API keysText To Speech MessageTroubleshooting
Conversations
Test Credits & API KeysInstall SMSInstall EmailInstall LINEInstall TelegramInstall WeChatInstall WhatsAppReceiving MessagesSending MessagesReplying to MessagesMessenger optionsMessage TagsEmail Attachments and Inline ImagesIP Warm-upTroubleshooting
Numbers
Buy a numberNumber restrictions
Omnichannel Widget
Install Toggling / HidingAdding AttributesIdentifying Users
Notifications Center
Receiving Notifications via Webhooks
Verify
Test Credits & API KeysSend Your First Verify TokenVerify a Token
Pricing API (SMS & MMS)Lookup
Request a LookupRequest an HLRView an HLRTroubleshooting
MMS
Test Credits & API KeysSend MMSTroubleshooting

Troubleshooting WhatsApp

When a message cannot be sent over MessageBird's WhatsApp Business API, the status will change to “rejected” or “failed”, and any additional details available will be provided via an error object attached to the message that indicates the code and a description of the error.

The API response will look similar to this: 

{
  "id": "5f3437fdb8444583aea093a047ac014b",
  "conversationId": "2e15efafec384e1c82e9842075e87beb",
  "channelId": "853eeb5348e541a595da93b48c61a1ae",
  "type": "text",
  "content": {
  "text": "This is a test WhatsApp message"
  },
  "direction": "sent",
  "status": "failed",
  "error": {
  "code": 302,
  "description": "The contact is not registered on WhatsApp."
  }
  "createdDatetime": "2018-08-28T15:52:41Z",
  "updatedDatetime": "2018-08-28T15:52:58Z"
}

WhatsApp error codes for common delivery errors are listed below:

CodeMessage
301The message failed to send. Please check your message is valid, including any media, and/or try again later.
302The contact is not registered on WhatsApp.
470Failed to send message because you are outside the support window for freeform messages to this user. Please use a valid message template.

Questions?

We’re always happy to help with code or other doubts you might have! Check out our Quickstarts, API Reference, Tutorials, SDKs, or contact our Support team.

Cookie Settings