Etiquetas
Criar, editar ou deletar etiqueta
/label/editAutenticaçã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
labelidreal da etiqueta. - Para criar uma nova etiqueta, envie
labelid: "new"comdelete: false.
O backend irá gerar o próximo labelid numérico disponível para a instância.
- Para deletar uma etiqueta existente, envie o
labelidreal comdelete: true.
Observações:
- A resposta de sucesso retorna
"Label created"para criação e"Label edited"para edição. - Para descobrir o
labelidfinal criado, consulteGET /labelsapós a operação
ou consuma o webhook/evento de labels da instância.
Corpo da requisição (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| labelid* | string | ID da etiqueta. Use o ID real para editar/deletar uma etiqueta existente. Use Exemplo: 25 |
| name | string | Novo nome da etiqueta Exemplo: responder editado |
| color | integer | Código numérico da nova cor (0-19) Exemplo: 2 |
| delete | boolean | 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.