E15xxx — WhatsApp sending & delivery
Error codes in the E15xxx range that the public Bird API returns. Each code links to its own page (the page its doc_url points at) with the cause and what to do. Retired codes stay listed; they are never renamed or reused.
| Code | Name | Status | Message |
|---|---|---|---|
| E15000 | WhatsAppBackendUnavailable | 503 | The WhatsApp service is temporarily unavailable. Please retry. |
| E15001 | WhatsAppInvalidRecipient | 422 | The recipient is not a valid E.164 phone number or business-scoped user ID. Use the international phone format with a leading plus, for example +14155550100, or a business-scoped user ID, for example US.13491208655302741918. |
| E15002 | WhatsAppTemplateNotFound | 422 | No WhatsApp template matches the requested slug and language. |
| E15003 | WhatsAppTemplateParameterMismatch | 422 | The message parameters do not match the parameters the template declares. |
| E15014 | WhatsAppRecipientNotSupportedForTemplate | 422 | This template can only be sent to a phone number, not to a business-scoped user ID. |
| E15015 | WhatsAppContentRequired | 422 | The message carries no content. |
| E15016 | WhatsAppContentAmbiguous | 422 | The message carries more than one kind of content. |
| E15017 | WhatsAppSenderRequired | 422 | This message needs a sender. Set from to the business phone number to send it from. |
| E15018 | WhatsAppSenderNotAllowed | 422 | This message's sender is already determined, so from cannot be set. |
| E15019 | WhatsAppSenderNotFound | 422 | This is not a WhatsApp sender this workspace can send from. |
| E15021 | WhatsAppMediaExpired | 410 | This message's media is no longer available. Media on a received WhatsApp message is kept for 30 days. |
| E15023 | WhatsAppSenderWABAMismatch | 422 | The from number is on a different WhatsApp Business Account than the template. |
| E15039 | WhatsAppSenderNotConnected | 422 | The from number has not finished connecting to WhatsApp. |
| E15044 | WhatsAppServiceWindowClosed | 422 | This conversation's 24-hour customer service window is closed, so only a template message can be sent. |
| E15055 | WhatsAppInteractiveLimitExceeded | 422 | The interactive message exceeds a limit for its kind. |
| E15056 | WhatsAppInteractiveDuplicateLabel | 422 | Two buttons or rows in this message carry the same label. |
| E15057 | WhatsAppInReplyToNotFound | 422 | The message this send quotes is not one this workspace holds. |
| E15058 | WhatsAppInReplyToNotQuotable | 422 | The message this send quotes cannot be quoted. |
| E15059 | WhatsAppInteractiveCarouselButtonsMismatch | 422 | The carousel's cards do not all carry the same buttons. |
| E15061 | WhatsAppContactNameIncomplete | 422 | A contact card's name needs more than a formatted name. |
| E15062 | WhatsAppContactBirthdayInvalid | 422 | A contact card's birthday is not a date. |
| E15063 | WhatsAppDestinationRestricted | 422 | Bird's shared WhatsApp sender does not deliver to this destination. |
Related
- Errors: the full wire contract, status mapping, and all code ranges
- Error handling: branching on type and code, validation details, and vendor_code