Excluir canal

curl --request DELETE \ --url https://api.hubmessage.io/v1/channels/{channelId} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "cancelReason": "Cliente encerrou a empresa" } '

Conceituação

Remove permanentemente um canal e todos os seus dados. A exclusão é irreversível — o canal é fisicamente removido do sistema.

Este endpoint requer a role ENTERPRISE na sua conta.

Condições para exclusão

A exclusão só é permitida quando o canal não possui assinatura ativa. A tabela abaixo descreve o comportamento por status:

Status	Exclusão permitida	Observação
Trial	Sim	—
Pendente	Sim	Se houver fatura aberta, ela será cancelada automaticamente
Pago	Não	O canal deve ser cancelado antes de ser excluído
Em processo de cancelamento	Não	O canal deve ser cancelado antes de ser excluído
Cancelado	Sim	—

A exclusão é permanente e irreversível. Para excluir um canal com assinatura ativa, primeiro cancele a assinatura via Cancelar assinatura e aguarde o status CANCELED.

O channelId é obtido através do endpoint Criar canal.

Autorizações

Authorization

string

header

obrigatório

Secret Key gerada no painel de Segurança do Hub Message

Parâmetros de caminho

channelId

string

obrigatório

ID do canal (obtido via Criar canal)

Exemplo:

"019E4C54B1B375A28970B605CA9B03C3"

Corpo

application/json

cancelReason

string

Motivo da exclusão (opcional, mas recomendado para auditoria)

Exemplo:

"Cliente encerrou a empresa"

Resposta

Canal excluído com sucesso. Nenhum conteúdo retornado.

Introdução

WhatsApp Oficial

Canais

Templates

Mensagens livres

Webhooks

Conceituação

Condições para exclusão

Autorizações

Parâmetros de caminho

Corpo

Resposta

​Conceituação

​Condições para exclusão

Autorizações

Parâmetros de caminho

Corpo

Resposta

Conceituação

Condições para exclusão