Pular para o conteúdo principal

Ao desconectar

Conceituação#

Esse é o webhook de resposta de desconexão

Atenção

O Z-API não aceita webhooks que não sejam HTTPS


Atualizando Webhook#

Para atualizar a rota do webhook é possível fazer isso pela API ou pelo painel administrativo.

API#

/update-webhook-disconnected#

PUT https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/update-webhook-disconnected

Header#

KeyValue
Client-TokenTOKEN DE SEGURANÇA DA CONTA

Request Body#

{
"value": "https://endereco-do-seu-sistema.com.br/instancia/SUA_INSTANCIA/disconnected"
}

Painel Administrativo#

img


Retornos dos webhooks#

Os possíveis retornos do webhook on-whatsapp-disconnected estão cadastrado logo abaixo:

Response#

AtributosTipoDescrição
mommentintegerMomento em que a instância foi desconectada do número.
errorstringDescrição do erro.
disconnectedbooleanIndicação se a instância está conectada com o número ou não.
typestringTipo do evento da instância, nesse caso será "DisconnectedCallback".

200#

{
"type": "DisconnectedCallback",
"instanceId": "39ECB202B157D11E37905AE607963117",
"phone": "5544999999999",
"momment": 1698691825296,
"disconnected": true,
"error": "It was not possible to restore a session with the current token, please login again"
}
---------
{
"type": "DisconnectedCallback",
"instanceId": "39ECB202B157D11E37905AE607963117",
"phone": "5544999999999",
"momment": 1698691825296,
"disconnected": true,
"error": "The number was disconnected by a possible whatsapp number blocking"
}

405#

Neste caso certifique que esteja enviando o corretamente a especificação do método, ou seja verifique se você enviou o POST ou PUT conforme especificado no inicio deste tópico.

415#

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json"