From be2c35e15fb561204d0dfee35a5863f83903af35 Mon Sep 17 00:00:00 2001 From: Paola Mayuri Date: Tue, 19 May 2026 09:02:15 -0300 Subject: [PATCH] docs(webhooks): add errorCode field, update shadowban errors on DeliveryCallback and Blockednumbernew --- en/tips/blockednumbernew.mdx | 1 - en/webhooks/on-message-send-examples.mdx | 8 +++++++- tips/blockednumbernew.mdx | 1 - webhooks/on-message-send-examples.mdx | 8 +++++++- 4 files changed, 14 insertions(+), 4 deletions(-) diff --git a/en/tips/blockednumbernew.mdx b/en/tips/blockednumbernew.mdx index 3ff57d0..425ea83 100644 --- a/en/tips/blockednumbernew.mdx +++ b/en/tips/blockednumbernew.mdx @@ -61,7 +61,6 @@ This type of restriction can be identified through the [On Message Send](/webhoo When attempting to send a message, you may receive errors such as: - `"The message was not sent due to a likely shadow ban"` -- `"Did not have permission to send this message"` - `"Whatsapp rejected sending this message"` These responses indicate that the number is temporarily restricted from sending messages. diff --git a/en/webhooks/on-message-send-examples.mdx b/en/webhooks/on-message-send-examples.mdx index b22fc80..5360329 100644 --- a/en/webhooks/on-message-send-examples.mdx +++ b/en/webhooks/on-message-send-examples.mdx @@ -37,6 +37,11 @@ All **On Send** webhook responses contain the following attributes: Present **only in error cases**. Contains the description of the error that occurred when sending the message + + Error identifier code. Present **only in specific error cases**. + Currently sent only when the error is related to a temporary message sending restriction (shadow ban), with the value `"SHADOW_BAN"` + + --- ## Return Examples @@ -93,7 +98,8 @@ When an error occurs during sending, the response includes the `error` field wit WhatsApp did not allow sending this message. - The number is probably temporarily restricted from sending messages (shadow ban) + The phone number is likely under a temporary message sending restriction (shadow ban). + When this error occurs, the `errorCode` field is sent with the value `"SHADOW_BAN"` Your account does not have permission to send this message. diff --git a/tips/blockednumbernew.mdx b/tips/blockednumbernew.mdx index 7e3e415..4fb50e9 100644 --- a/tips/blockednumbernew.mdx +++ b/tips/blockednumbernew.mdx @@ -65,7 +65,6 @@ Quando um número está sob shadowban, podem ocorrer os seguintes comportamentos Ao tentar enviar uma mensagem, você pode receber erros como: - `"The message was not sent due to a likely shadow ban"` -- `"Did not have permission to send this message"` - `"Whatsapp rejected sending this message"` Esses retornos indicam que o número está temporariamente impedido de enviar mensagens. diff --git a/webhooks/on-message-send-examples.mdx b/webhooks/on-message-send-examples.mdx index 0bb1f07..4aec1c9 100644 --- a/webhooks/on-message-send-examples.mdx +++ b/webhooks/on-message-send-examples.mdx @@ -37,6 +37,11 @@ Todos os retornos do webhook **Ao enviar** possuem os seguintes atributos: Presente **apenas em casos de erro**. Contém a descrição do erro ocorrido no envio da mensagem + + Código identificador do erro. Presente **apenas em casos específicos de erro**. + Atualmente enviado somente quando o erro for relacionado a restrição temporária de envio de mensagens (shadow ban), com o valor `"SHADOW_BAN"` + + --- ## Exemplos de retorno @@ -93,7 +98,8 @@ Quando ocorre um erro no envio, o retorno inclui o campo `error` com a descriç O WhatsApp não permitiu o envio desta mensagem. - O número provavelmente está com uma restrição temporária de envio de mensagens (shadow ban). + O número provavelmente está com uma restrição temporária de envio de mensagens (shadow ban). + Quando este erro ocorre, o campo `errorCode` é enviado com o valor `"SHADOW_BAN"` Sua conta não tem autorização para enviar esta mensagem.