NODAPI

Etiquetas

Criar, editar ou deletar etiqueta

POST/label/edit

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

Cria, edita ou deleta uma etiqueta da instância.

Regras de uso:

  • Para editar uma etiqueta existente, envie o labelid real da etiqueta.
  • Para criar uma nova etiqueta, envie labelid: "new" com delete: false.

O backend irá gerar o próximo labelid numérico disponível para a instância.

  • Para deletar uma etiqueta existente, envie o labelid real com delete: true.

Observações:

  • A resposta de sucesso retorna "Label created" para criação e "Label edited" para edição.
  • Para descobrir o labelid final criado, consulte GET /labels após a operação

ou consuma o webhook/evento de labels da instância.

Corpo da requisição (JSON)

CampoTipoDescrição
labelid*string

ID da etiqueta.

Use o ID real para editar/deletar uma etiqueta existente. Use "new" para criar uma nova etiqueta quando delete for false.

Exemplo: 25

namestring

Novo nome da etiqueta

Exemplo: responder editado

colorinteger

Código numérico da nova cor (0-19)

Exemplo: 2

deleteboolean

Indica se a etiqueta deve ser deletada

Exemplo: false

* obrigatório

Exemplos de corpo

Criar nova etiqueta

{
  "labelid": "new",
  "name": "responder editado",
  "color": 2,
  "delete": false
}

Editar etiqueta existente

{
  "labelid": "25",
  "name": "responder editado",
  "color": 2,
  "delete": false
}

Deletar etiqueta existente

{
  "labelid": "25",
  "name": "",
  "color": 0,
  "delete": true
}

Respostas

  • 200Operação concluída com sucesso
  • 400Payload inválido
  • 500Erro interno do servidor ou sessão inválida

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.