NODAPI

Etiquetas

Gerencia labels de um chat

POST/chat/labels

Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.

Atualiza as labels associadas a um chat específico. Este endpoint oferece três modos de operação:

  1. Definir todas as labels (labelids): Define o conjunto completo de labels para o chat, substituindo labels existentes
  2. Adicionar uma label (add_labelid): Adiciona uma única label ao chat sem afetar as existentes
  3. Remover uma label (remove_labelid): Remove uma única label do chat sem afetar as outras

Importante: Use apenas um dos três parâmetros por requisição. Labels inexistentes serão rejeitadas.

As labels devem ser fornecidas no formato id ou labelid encontradas na função get labels.

Corpo da requisição (JSON)

CampoTipoDescrição
number*string

Número do chat ou grupo

Exemplo: 5511999999999

labelidsarray<string>

Lista de IDs das labels a serem aplicadas ao chat (define todas as labels)

Exemplo: 10,20

add_labelidstring

ID da label a ser adicionada ao chat

Exemplo: 10

remove_labelidstring

ID da label a ser removida do chat

Exemplo: 20

* obrigatório

Exemplos de corpo

Definir todas as labels do chat

{
  "number": "5511999999999",
  "labelids": [
    "10",
    "20",
    "30"
  ]
}

Adicionar uma label ao chat

{
  "number": "5511999999999",
  "add_labelid": "10"
}

Remover uma label do chat

{
  "number": "5511999999999",
  "remove_labelid": "20"
}

Respostas

  • 200Labels atualizadas com sucesso
  • 400Erro na requisição
  • 404Chat não encontrado

Experimente

Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.

Cole a chave gerada no painel.