Delivery Error Codes

Possible error codes returned in the Messaging Apps delivery receipts include:

General Error Codes

CodePossible reasonDescription
1AbsentSubscriberSubscriber is not registered in this chat channel
2ContentRelatedErrorContent Type is not supported by this channel
3DataMissingThe request is missing a required parameter.
9EquipmentProtocolErrorThe receiver's app version is not capable of receiving business messages
11FloodingToo many messages sent to the recipient in a short period of time.
14InternalErrorInternal error
15InvalidDestinationUserId is not valid for that channel or is part of blacklist on Connect
18Invalid parameterInvalid or missing parameters. Check that all required parameters are passed and are of the correct type.
23ConnectionErrorChannel connection error
25Operation Aborted By Receiving Network Or UserMessage is intentionally undelivered by Channel
29PhoneRelatedErrorThe specified parameter value is invalid.
36ExpiredMessage expired (not delivered at the requested time)
41SmscRejectMessage rejected by Chat channel
42NoCreditNot enough credit on Account wallet
43SpamFilterMessage filtered by anti-spam reason
46SubscriberNotReachableMessage sent to Channel, but user is not reachable for delivery
61SessionExpiredMessage trashed by session expired reason

WhatsApp Error Codes

CodePossible ReasonsDescription
1000Authentication failedAuthException — Unable to authenticate app user (WhatsApp: 0)
1001Method not allowedAPI Method — Capability/permissions issue (WhatsApp: 3)
1002Rate limit exceededAPI Too Many Calls — App rate limit reached (WhatsApp: 4)
1003Permission missingPermission Denied — Permission not granted or removed (WhatsApp: 10)
1004Invalid valueParameter value not valid — Business phone number deleted (WhatsApp: 33)
1005Invalid parameterInvalid parameter — Misspelled or unsupported parameter (WhatsApp: 100)
1006Token expiredAccess token expired (WhatsApp: 190)
1007Policy violationTemporarily blocked for policy violations (WhatsApp: 368)
1008Rate limit hitWABA rate limit reached (WhatsApp: 80007)
1009Throughput exceededRate limit hit — Message throughput limit reached (WhatsApp: 130429)
1010Experimental numberNumber part of experiment (WhatsApp: 130472)
1011Region restrictionBusiness account restricted in this country (WhatsApp: 130497)
1012Unknown failureSomething went wrong — Unknown error (WhatsApp: 131000)
1013Access deniedAccess denied — Permission not granted (WhatsApp: 131005)
1014Missing parameterRequired parameter is missing (WhatsApp: 131008)
1015Invalid parameter valueParameter value is not valid (WhatsApp: 131009)
1016Service downService unavailable — Temporary service downtime (WhatsApp: 131016)
1017Sender = ReceiverRecipient cannot be sender (WhatsApp: 131021)
1018Message rejectedMessage undeliverable (WhatsApp: 131026)
1019Account lockedAccount locked (WhatsApp: 131031)
1020Display name not approvedDisplay name approval needed (WhatsApp: 131037)
1021Bad certificateIncorrect certificate (WhatsApp: 131045)
1022Message window expiredRe-engagement message (outside 24-hour window) (WhatsApp: 131047)
1023Spam control triggeredSpam rate limit hit (WhatsApp: 131048)
1024Message suppressedMeta chose not to deliver (WhatsApp: 131049)
1025Unsupported messageUnsupported message type (WhatsApp: 131051)
1026Download failedMedia download error (WhatsApp: 131052)
1027Upload failedMedia upload error (WhatsApp: 131053)
1028Sender-recipient throttledSender/recipient pair rate limit hit (WhatsApp: 131056)
1029Account under maintenanceAccount in maintenance mode (WhatsApp: 131057)
1030Wrong number of paramsTemplate param count mismatch (WhatsApp: 132000)
1031Template missingTemplate does not exist (WhatsApp: 132001)
1032Text too longTemplate hydrated text too long (WhatsApp: 132005)
1033Template violationTemplate policy violation (WhatsApp: 132007)
1034Wrong param formatTemplate param format mismatch (WhatsApp: 132012)
1035Template pausedTemplate paused (WhatsApp: 132015)
1036Template disabledTemplate disabled (WhatsApp: 132016)
1037Flow blockedFlow blocked (WhatsApp: 132068)
1038Flow throttledFlow throttled (WhatsApp: 132069)
1039Deregistration failedIncomplete deregistration (WhatsApp: 133000)
1040Server unavailableServer temporarily unavailable (WhatsApp: 133004)
1041PIN mismatchTwo-step PIN mismatch (WhatsApp: 133005)
1042Reverification requiredPhone number re-verification needed (WhatsApp: 133006)
1043Too many guessesToo many two-step PIN guesses (WhatsApp: 133008)
1044PIN entry too fastTwo-step PIN guessed too fast (WhatsApp: 133009)
1045Number not registeredPhone number not registered (WhatsApp: 133010)
1046Retry after delayWait before registering phone number (WhatsApp: 133015)
1047Too many attemptsAccount register/deregister limit exceeded (WhatsApp: 133016)
1048Unknown client-side issueGeneric user error (WhatsApp: 135000)
1049Too many sync callsSynchronization request limit exceeded (WhatsApp: 2593107)
1050Sync time expiredSynchronization request outside allowed time window (WhatsApp: 2593108)

Viber Error Codes

CodePossible ReasonsDescription
2000Successfully sentMessage sent successfully
2001Internal server errorInternal processing failure
2002Invalid service IDService ID unused or not yet uploaded
2003Bad request structureMalformed request (e.g. JSON formatting)
2004Incorrect message typeUnsupported or invalid message type
2005Missing parametersRequired field like tracking_data is missing
2006TimeoutViber server timeout
2007User blockedUser has blocked this ID or all business messages
2008Not a Viber userDestination number not registered with Viber
2009No suitable deviceDevice not compatible with Business Messages
2010Unauthorized IP or IDWrong IP or ID not whitelisted
2012Bad labelMissing or invalid 'label' parameter
2013Invalid TTLTTL is out of allowed range
2014Session message limit reachedExceeded 10-message session cap
2015Unsupported file formatFile type not allowed for this feature
2016Filename too longFile name exceeds 25 character limit
2017Thumbnail too longThumbnail URL exceeds 1000 characters
2018File too largeFile size exceeds 200 MB
2019Video too longVideo duration exceeds 600 seconds
2020Template ID not foundThe provided template ID is not found
2021Template validation failedTemplate variables did not pass the server validation