Skip to main content
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