Labels (também chamadas de tags ou etiquetas) são marcadores reutilizáveis para
organizar conversas e contatos. Cada label tem cor própria e pode aparecer em
filtros, automações e relatórios.
Listar labels
Resposta
Criar label
Detalhe / atualizar / excluir
Excluir uma label remove ela de todas as conversas e contatos que estavam marcados.
Não há “undo” — considere arquivar (renomear pra _zarchive_xxx) em vez de excluir.
Aplicar label numa conversa
Não use o endpoint /labels direto pra isso — use o endpoint de conversa:
O array enviado substitui todas as labels atuais da conversa.
Aplicar label num contato
Mesma estrutura — array substitui o conjunto atual.
Filtrar conversas por label
Múltiplas labels = combinação AND (a conversa precisa ter todas as labels listadas).
Códigos de resposta