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 a assinatura cancelada. Instâncias pagas, pendentes, com boleto pendente, em processo de cancelamento ou em retentativa de pagamento não são elegíveis.
  • Não está em trial. Um trial precisa expirar naturalmente ou ser cancelado antes.
  • Já passou da carência de 40 dias contados da data de cancelamento da assinatura.

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”.