Etiquetas
Gerencia labels de um chat
/chat/labelsAutenticaçã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:
- Definir todas as labels (labelids): Define o conjunto completo de labels para o chat, substituindo labels existentes
- Adicionar uma label (add_labelid): Adiciona uma única label ao chat sem afetar as existentes
- 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)
| Campo | Tipo | Descrição |
|---|---|---|
| number* | string | Número do chat ou grupo Exemplo: 5511999999999 |
| labelids | array<string> | Lista de IDs das labels a serem aplicadas ao chat (define todas as labels) Exemplo: 10,20 |
| add_labelid | string | ID da label a ser adicionada ao chat Exemplo: 10 |
| remove_labelid | string | 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.