NODAPI

Etiquetas

Iniciar recarga de etiquetas do WhatsApp

POST/labels/refresh

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

Inicia uma nova leitura das etiquetas no WhatsApp em background. A resposta confirma apenas que a recarga foi iniciada ou que já existe uma recarga em andamento. Para obter a lista atualizada, consulte GET /labels depois.

Efeitos no backend:

  • a recarga também processa associações de etiquetas sincronizadas do WhatsApp
  • chats existentes podem ter o campo wa_label atualizado com as etiquetas corretas
  • quando uma associação de etiqueta muda após a sincronização do histórico, o webhook chat_labels pode ser enviado com os dados completos do chat

Uso recomendado:

  • tente primeiro com force=false
  • se isso não trouxer as etiquetas corretamente, tente force=true
  • use force=true apenas como tentativa de correção, porque ele faz uma recarga mais pesada

Corpo da requisição (JSON)

CampoTipoDescrição
forceboolean

Tente primeiro com false. Use true apenas quando a recarga padrão não funcionar bem, pois esse modo faz uma nova leitura mais completa das etiquetas.

Exemplo: false

* obrigatório

Respostas

  • 202Recarga de etiquetas aceita para processamento em background
  • 409A recarga não pôde ser executada porque a sincronização do histórico ainda está em andamento
  • 500Erro interno do servidor

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.