Skip to main content
POST
Deletando instâncias em lote

Conceituação

Método utilizado para deletar várias instâncias vinculadas à sua conta em uma única requisição. Para deletar apenas uma instância, use Deletando uma instância.
Para utilizar os endpoints de Partner, informe o Token de Parceiro no campo Authorization, no formato: Bearer <Partner-Token>Não é necessário enviar o Client-Token nessas requisições.
Envie no máximo 100 instâncias por requisição. Para volumes maiores, divida a operação em várias chamadas.
Cada instância da lista é avaliada individualmente. Uma instância recusada não impede que as demais sejam deletadas: a resposta informa o resultado de cada uma.

Regras de elegibilidade

Uma instância só é deletada quando atende a todas as condições abaixo:
  • Está desconectada do WhatsApp e do celular.
  • Está com status de pagamento pendente, trial ou cancelado. Instâncias pagas, com boleto pendente, em processo de cancelamento, em retentativa de pagamento ou sem status de pagamento definido não são elegíveis.
  • Se estiver pendente, não tem assinatura pendente. Cancele a assinatura antes de deletar a instância.
Instâncias canceladas podem ser deletadas assim que entram nesse status, sem carência após o cancelamento.

Atributos

string
obrigatório
Token de parceiro no formato Bearer <Partner-Token>

Obrigatórios

array
obrigatório
Lista das instâncias a serem deletadas. Máximo de 100 por requisição.

Request Body


Response

200

O campo results traz uma entrada por instância enviada, na mesma ordem da requisição.

Motivos de recusa

Cada item recusado traz um type que identifica a regra que bloqueou a exclusão.

400

A lista de instâncias veio vazia ou acima do limite de 100 por requisição.

401

O header Authorization não foi enviado ou o Token de Parceiro é inválido.

405

Neste caso certifique que esteja enviando corretamente a especificação do método, ou seja verifique se você enviou o POST conforme especificado no início 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”.