Pular para o conteúdo principal

Deletar mensagens

Método#

/messages#

DELETE https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/messages

Header#

KeyValue
Client-TokenTOKEN DE SEGURANÇA DA CONTA

Conceituação#

Método utilizado para apagar uma mensagem em um chat, você pode deletar tanto uma mensagem que enviou quanto uma mensagen enviada por um contato, para utilizar este recurso você só vai precisar do messageId da mensagem que quer apagar.

image


Atributos#

Obrigatórios#

AtributosTipoDescrição
messageIdstringid original da mensagem, no caso de mensagem enviada por você é o código que vem no seu reponse, caso seja uma mensagem enviada por um contato você vai receber este messageId pelo seu webhook de receive
phonestringTelefone (ou ID do grupo para casos de envio para grupos) do destinatário/remetente no formato DDI DDD NÚMERO Ex: 551199999999. IMPORTANTE Envie somente números, sem formatação ou máscara
ownerbooleanInforme true caso você tenha enviado a mensagem ou false para casos onde seja uma mensagem recebida

Opcionais#

AtributosTipoDescrição

Request Params#

URL exemplo#

Método

DELETE

https://api.z-api.io/instances/SUA_INSTANCIA/token/SEU_TOKEN/messages?messageId=123&phone=5511999998888&owner=true


Response#

204#

No content

AtributosTipoDescrição

Exemplo

{}

405#

Neste caso certifique que esteja enviando o corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET 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"


Webhook Response#

Link para a response do webhook (ao receber)

Webhook


Code#