HookCloud Flow Central de ajuda
Suporte Abrir painel
HookCloud Flow · documentação oficial do produto

Números, status e ações

Como ler os cards, expandir detalhes, desconectar com segurança e diferenciar conexão atual, histórica, transferida e substituída.

Versão 4.6.0 Atualizada em 24 de setembro de 2026 · passo a passo da contratação de adicionais pelo fluxo de conexão. Condições comerciais dos assinantes atuais preservadas.

Categorias da aba Números

Categoria Inclui
Ativos Conexões canônicas e operacionais.
Em processamento Onboarding, validação, transferência, revisão assistida ou operação pendente.
Restritos Números com limitação conhecida.
Banidos Ativos bloqueados pela Meta.
Desconectados Conexões encerradas local/remotamente.
Substituídos Versões técnicas antigas do mesmo telefone no workspace.
Transferidos Número movido para outro workspace.
Encerrados Registros terminados por cobrança, risco ou ação administrativa.

Card compacto e expansão

O card recolhido mostra o número, nome verificado, última sincronização e status. Clique no resumo ou no sinal de expansão para ver IDs, permissões, webhook, token, histórico e ações. O painel preserva card e log abertos durante atualizações automáticas.

Campos do card expandido

Campo Significado
Connection ID Identificador interno da conexão no Flow.
Phone Number ID Identificador técnico usado no endpoint /messages.
WABA ID Conta do WhatsApp Business que contém o número.
Portfólio empresarial Nome do Business Portfolio proprietário da WABA, quando a Meta permite a sincronização.
Business ID Business Portfolio/BM relacionado.
Nome verificado Nome retornado pela Meta para o número.
Qualidade GREEN, YELLOW, RED ou desconhecida.
App Meta App principal ou legado usado pela credencial.
Concedidas/ausentes Escopos disponíveis e limitações do token.
Callback e rota URL esperada, readback e escopo efetivo.
Última sincronização Momento da consulta mais recente.
Modo de entrega Webhook próprio ou plataforma externa.
Estado da entrega Aguardando, externa confirmada, conflito ou webhook verificado.
Número para Chatwoot Número normalizado em E.164, copiável como +15553811311, sem espaços ou traços.
Username comercial Nome público do número, quando enviado pela Meta.
Status do username Reservado, Ativo, Removido ou em análise.
Prontidão BSUID Orientação para validar o sistema de atendimento em cenários sem telefone.

Estado local, autorização e última confirmação

O card reúne dados locais e o último estado confirmado pela Meta. Por isso, CONNECTED descreve a conexão conhecida pelo Flow, mas não garante sozinho que o token ainda está ativo, que todas as permissões continuam válidas ou que o callback responde.

  • confira a data da última sincronização;
  • leia o estado de autorização da credencial e os escopos ausentes;
  • consulte qualidade, restrição e risco do Phone Number ID correto;
  • se houver aviso de credencial revogada ou reautorização necessária, faça uma nova conexão oficial;
  • use o teste de rota somente para diagnóstico: alcance HTTP não equivale à validação completa do webhook.

Limites de mensagens da Meta: todas as faixas

O limite de mensagens é definido pela Meta para o portfólio empresarial e compartilhado entre os números desse portfólio. Ele mede a quantidade máxima de destinatários únicos aos quais a empresa pode entregar mensagens fora da janela de atendimento, em um período móvel de 24 horas. Um número pode consumir a capacidade compartilhada; ter vários números não multiplica esse limite.

Esse limite da Meta é diferente da quantidade de números contratada na HookCloud. A referência oficial atual apresenta as faixas 250 → 2.000 → 10.000 → 100.000 → ilimitado. 1K não é uma faixa nessa sequência atual: 1.000 é a metade de 2.000 usada em um dos critérios de evolução.

Consulte o quadro das etapas, os caminhos para chegar a 2.000, a escala automática posterior e como conferir o limite atual.

O que cada janela mede

MedidaComo interpretar
Janela de atendimento de 24 horasÉ a janela individual iniciada quando o cliente envia uma mensagem ou faz uma chamada; uma nova interação reinicia o período, conforme as regras da Meta. A contagem do limite descrito aqui considera entregas fora dessa janela.
Período móvel de 24 horas do limiteÉ a janela de capacidade do portfólio. Não é uma cota que necessariamente zera à meia-noite.
Período móvel de 30 diasAplica-se ao caminho de uso documentado para chegar a 2.000. Não é a regra de metade do limite usada na escala posterior.
Últimos 7 diasÉ o período de uso considerado na escala automática depois de 2.000. Não transforma o limite de 24 horas em uma cota semanal.

Quadro geral das faixas

EtapaCritérios de evolução
250 → 2.000De 250 para 2.000: concluir um caminho de verificação ou de uso, seguido da análise de qualidade e aprovação da Meta; não é a regra automática de metade do limite.
2.000 → 10.000De 2.000 para 10.000: pelo menos 1.000 destinatários únicos no uso elegível dos últimos 7 dias, junto com mensagens de alta qualidade em todos os números e templates do portfólio.
10.000 → 100.000De 10.000 para 100.000: pelo menos 5.000 destinatários únicos no uso elegível dos últimos 7 dias, junto com mensagens de alta qualidade em todos os números e templates do portfólio.
100.000 → ilimitadoDe 100.000 para ilimitado: pelo menos 50.000 destinatários únicos no uso elegível dos últimos 7 dias, junto com mensagens de alta qualidade em todos os números e templates do portfólio.
IlimitadoNa faixa ilimitada, não há etapa posterior nem meta adicional de metade do limite na sequência documentada; as demais regras da plataforma continuam valendo.

De 250 para 2.000: caminhos e análise da Meta

Novos portfólios começam com limite de 250. A faixa de 250, isoladamente, não comprova que a empresa não esteja verificada. Para alcançar 2.000, a Meta documenta três caminhos alternativos:

  1. Verificar a empresa pelo processo da Meta.
  2. Verificação por um parceiro elegível e aprovado pela Meta, quando aplicável. A modalidade depende da autorização específica do parceiro; não é uma função disponível em toda integração. Consulte as condições oficiais desse caminho.
  3. Uso com qualidade: enviar 2.000 mensagens entregues fora das janelas de atendimento a destinatários únicos, em um período móvel de 30 dias, utilizando templates de alta qualidade.

Concluir um caminho não garante o aumento. Depois disso, a Meta analisa a qualidade das mensagens e decide se aprova ou nega a elegibilidade. A verificação da empresa não deve ser apresentada como liberação automática.

Se aprovar, a Meta eleva o limite para 2.000 e comunica o resultado. Se negar ou pedir mais informações, o limite atual é mantido; confira o aviso recebido e o caminho indicado, que pode envolver verificação de identidade ou uso com qualidade. Não crie contas duplicadas nem force envios para tentar contornar a análise. Fonte: Meta — caminhos para aumentar o limite.

Depois de 2.000: escala automática

A partir de 2.000, a Meta considera os dois critérios em conjunto: mensagens de alta qualidade em todos os números e templates do portfólio e uso de pelo menos metade do limite atual nos últimos 7 dias.

Os totais do quadro são destinatários únicos no uso elegível do período, não mensagens repetidas nem uma exigência diária. Dez mensagens ao mesmo destinatário não representam dez destinatários únicos. Tentativas sem entrega e mensagens dentro da janela de atendimento não devem ser somadas como prova desse uso elegível.

Ilimitado se refere a esta faixa de destinatários, não a uma isenção de todas as regras. Continuam aplicáveis qualidade, regras de templates, autorização de contato (opt-in) e limites técnicos de chamadas, velocidade e capacidade da plataforma. Fonte: Meta — limites de uso da plataforma.

A qualidade considera feedback dos usuários nos últimos 7 dias, com maior peso para os sinais recentes, como bloqueios, denúncias, silenciamento e arquivamento. A Meta orienta enviar conteúdo útil a quem autorizou o contato e evitar excesso. Fonte: Meta — qualidade das mensagens.

Volume sozinho não confirma evolução
Atingir metade do limite não comprova a qualidade de todos os números e templates. Também não prova que a qualidade seja o motivo de uma demora: ela precisa ser verificada. Não force disparos, repetições ou contatos sem interesse para tentar subir de faixa.

Prazo da escala automática e avisos da interface

A documentação oficial consultada em 15 de setembro de 2026 informa aumento automático de um nível em até 6 horas depois de atendidos todos os critérios. Esse prazo se refere à escala posterior a 2.000; não deve ser aplicado como prazo garantido da análise inicial de 250 para 2.000.

Não conte a espera apenas a partir do primeiro envio, da criação do portfólio ou de um aumento anterior. O uso exibido agora, sozinho, não informa quando o volume e a qualidade passaram a atender aos critérios simultaneamente.

Se a interface apresentar um aviso de até 24 horas ou outro prazo, registre o texto e o horário: interface e documentação podem divergir. Essa diferença não permite afirmar que existe cache, fila específica ou outro motivo técnico. Nenhum desses prazos é um SLA de liberação da HookCloud.

Se o limite continuar igual, os critérios da etapa estiverem mantidos e o prazo informado já tiver passado, solicite uma verificação à Meta com os dados e avisos da conta. A HookCloud pode ajudar a organizar o diagnóstico, mas não pode garantir nem forçar o aumento.

Como conferir o limite e uma possível divergência

  1. Abra o WhatsApp Manager da empresa correta. Em Ferramentas da conta → Limites de mensagens, confira o portfólio, a faixa atual e o período do indicador. Os nomes das opções podem variar com o idioma.
  2. Se a própria Meta continua na faixa anterior, confira a regra daquela etapa. Para 250 → 2.000, veja o caminho concluído e o resultado da análise. Depois de 2.000, confira uso elegível e qualidade de todos os números/templates. A HookCloud não antecipa uma elevação que a Meta ainda não confirmou.
  3. Se a Meta já mostra uma faixa maior e a HookCloud mostra a anterior para o mesmo portfólio, confira os horários. Pode haver desatualização do dado exibido. Compare Business ID, WABA, Phone Number ID, última sincronização e eventuais erros de consulta antes de concluir perda de limite.
  4. Use a atualização disponível e confira o resultado. Atualize o painel ou use a consulta oferecida para a conexão. Se a diferença persistir, envie ao chat privado da HookCloud os IDs, os dois valores e seus horários. Não desconecte um número saudável para tentar atualizar o limite.

Para pedir verificação à Meta, reúna Business ID, WABA ID, Phone Number ID, faixa atual, indicador de destinatários únicos e período, qualidade dos números/templates e horários dos avisos. Use a opção de suporte disponível para a conta no Business Support Home. Não envie token, senha, PIN, códigos de verificação ou conteúdo de conversas de clientes.

Leia também estado local e última confirmação e onde consultar o limite na Meta. Fonte: Meta — limites de mensagens e escala automática.

Número restabelecido na Meta e status antigo no Flow

O aviso de banimento mostra o último retorno registrado para aquela conexão. Se a Meta já liberou o mesmo número/WABA e o card continua antigo, confira os horários e siga o passo a passo de atualização após liberação. Se for necessário refazer a autorização, o fluxo padrão fica na Visão geral: escolha a integração correta e use Conectar com a Meta para autorizar o mesmo ativo novamente. Não é necessário excluir o número na Meta para atualizar o Flow.

O banimento, sozinho, não comprova que o token foi revogado. Uma validação antiga como “válida” também não comprova acesso atual. Uma leitura atual bem-sucedida de acesso e saúde do mesmo ativo exige investigar a divergência local, sem reconectar repetidamente. A reconexão depende das validações normais, não remove restrição ainda vigente na Meta e não zera incidentes por si só. Quando o sistema confirma a restauração pela Meta para o mesmo ativo, o BAN anterior abrangido fica resolvido, sai do contador e permanece na auditoria. RED não é retirado por essa restauração, e um novo BAN posterior conta novamente. Veja a regra de BAN resolvido. Se já houver operação em andamento, aguarde o resultado antes de repetir.

Selo OBA e conta comercial oficial

Entidades governamentais: novas contratações e operações pela HookCloud estão em validação com atendimento humano da Meta. Antes de contratar para esse uso ou iniciar novo cadastro, operação relacionada a OBA ou migração pela HookCloud, aguarde o posicionamento formal e a publicação das condições aplicáveis. Consulte a condição temporária para entidades governamentais. A espera não impede o uso dos canais independentes da Meta ou do provedor atual.

OBA, qualidade do número e limite de mensagens são informações diferentes. A migração e a contratação do Flow não concedem o selo. Veja os requisitos oficiais e como solicitar OBA por conta própria. A HookCloud oferece orientação documental, sem submissão ou acompanhamento individual.

Username comercial e identidade

Quando a Meta envia uma atualização, o card mostra o username comercial, o estado e a data da última alteração.

@

Reservado

Nome reservado, ainda sujeito à liberação e visibilidade da Meta.

✓

Ativo

Username aprovado e associado ao número comercial.

×

Removido

Nome removido; o histórico técnico pode manter o último valor.

Entenda a diferença entre username e BSUID →

Botões do card

Botão Efeito Disponibilidade
Mostrar/Copiar token Revela temporariamente o token Meta. Owner/admin autorizado; nunca em conexão histórica ou credencial inválida.
WhatsApp Manager Abre o gerenciamento oficial do ativo. O usuário também precisa de acesso na Meta.
Alterar webhook Troca a rota efetiva da conexão e confirma por readback. Somente conexão atual e sem operação incompatível.
Validar rota Consulta callback/App sem escrever. Diagnóstico.
Reaplicar webhook Regrava e confirma a rota própria. Quando a validação apontar divergência.
Atualizar status Busca dados do número, WABA, qualidade e portfólio na Meta. Pode ficar limitado sem management.
Configurar caixa existente Aplica a URL e o verify token de uma inbox existente do Chatwoot no Phone Number ID e confirma a rota. Modo Chatwoot/plataforma externa; permanece disponível durante verificação passiva.
Verificar Chatwoot Faz uma leitura passiva da rota sem alterar callback. Não bloqueia Configurar caixa existente, Usar webhook próprio ou Desconectar.
Usar webhook próprio Migra a entrega para uma URL HTTPS própria. Quando o destino passar a ser CRM, n8n, Make ou backend próprio.
Desconectar Encerra o vínculo operacional com segurança e preserva o histórico técnico. Owner/admin; não equivale a excluir o registro.
Parar desconexão Cancela a solicitação enquanto nenhuma etapa irreversível tiver começado. Somente enquanto o painel indicar que a parada ainda é segura.
Reconectar Inicia novo Embedded Signup e cria uma nova geração técnica da conexão. Conexão desconectada ou autorização inválida, quando permitido.
Excluir definitivamente Remove registros técnicos em uma operação administrativa excepcional. Não disponível ao assinante. Somente administração HookCloud, após verificações de segurança.
Usar esta conexão como atual Resolve duplicidade no mesmo workspace após validar a rota. Somente owner e fluxo assistido.
Log da conexão Mostra eventos, jobs, tentativas, resultados e código de suporte. Todos os papéis com acesso de leitura.
Copiar número para Chatwoot Copia o telefone em formato internacional, sem espaços, traços ou parênteses. Quando o número estiver disponível.

Desconectar não é excluir

O assinante não pode excluir um número definitivamente
No painel do assinante, a ação disponível é Desconectar. A exclusão definitiva não é um recurso de autoatendimento e só pode ser executada pela administração HookCloud em situações excepcionais, depois de conferir ownership, jobs, histórico, WABA compartilhada, credenciais e rotas.
Ação O que acontece Histórico
Desconectar Encerra o vínculo operacional, tenta retirar a rota quando a credencial permite e conclui a limpeza local segura. Preservado para auditoria, suporte e reconexão.
Parar desconexão Cancela o job antes da fase remota/local irreversível. Permanece como operação cancelada no log.
Reconectar Uma nova autorização assume a conexão e invalida desconexões antigas que pertençam à geração anterior. A linhagem anterior continua consultável.
Exclusão definitiva Operação administrativa de exceção; não é oferecida ao assinante. Pode remover registros técnicos conforme a prévia administrativa.
Não apague o número na Meta para “limpar o card”
Excluir o número no WhatsApp Manager pode mudar Phone Number ID, WABA, histórico e elegibilidade. Use Desconectar ou procure o suporte quando o estado não terminar corretamente.

Desconecte no Flow antes de remover a parceria na Meta

Para encerrar a integração, o proprietário ou administrador deve solicitar Desconectar no card do número e aguardar o resultado da operação. Só depois remova a parceria da HookCloud ou suas permissões no portfólio empresarial da Meta, se esse for o objetivo.

Retirar o acesso primeiro pode impedir que a HookCloud confirme a retirada do endereço de recebimento de mensagens na Meta. Isso não apaga o histórico nem significa que o número foi banido. Antes de remover uma parceria ou autorização compartilhada, confira se ela também atende outros números ou integrações que você pretende manter.

Já removeu a parceria e o card ficou em “Desconectando”?
Informe isso no atendimento privado e indique o número ou a operação exibida no card. Não exclua o número, não faça outra compra e não repita a conexão apenas para limpar a tentativa antiga. A equipe confere o acesso e a operação correta; quando a limpeza remota não puder ser confirmada, o encerramento local seguro e a pendência remota devem ser apresentados separadamente.

O processamento precisa chegar a um resultado: concluído, cancelado ou com uma pendência identificada. Um cronômetro zerado não comprova conclusão, e uma falha não deve manter a indicação de processamento por tempo indefinido. Quando necessário, a CláudIA encaminha a situação para revisão técnica no próprio atendimento.

Uma pausa administrativa é uma proteção interna diferente de uma restrição da Meta. Se houver uma pausa ativa, a equipe precisa revisá-la; contratar novamente ou autorizar o número outra vez não retira essa pausa automaticamente. Se a autorização da Meta foi revogada, uma nova assinatura também não a restaura.

Desconexão local não comprova que um callback ou token foi removido na Meta. Um erro de objeto inacessível, inclusive 100/33, também não prova sozinho que alguém excluiu o número ou retirou a parceria. Os registros antigos e os incidentes de risco continuam preservados.

Processamento, verificação passiva e cronômetro

Conectar, aplicar uma rota, trocar webhook e desconectar podem depender de respostas da Meta. O cronômetro é uma estimativa visual e não encerra sozinho uma operação remota.

Operação Bloqueia ações concorrentes? Comportamento
Verificar Chatwoot Não É uma leitura passiva. A verificação manual faz uma leitura; a automática tenta no máximo três vezes e termina como “Aguardando plataforma externa” quando a rota não foi detectada.
Configurar caixa existente Sim, durante aplicação/readback Escreve a rota da inbox no Phone Number ID e confirma o callback efetivo.
Webhook próprio Sim, durante aplicação/readback Preserva as proteções do fluxo e confirma a rota antes do sucesso.
Desconectar Sim, durante as etapas seguras O botão Parar desconexão aparece enquanto ainda for possível cancelar sem inconsistência.
Contador em 00:00
Atualize o painel somente quando a mensagem orientar. Uma verificação passiva não deve manter os demais botões bloqueados; uma aplicação explícita deve chegar a um resultado terminal antes de ser repetida.

Log da conexão

O log diferencia Registro/Auditoria, Processando, Concluído e Falhou. Abra detalhes técnicos somente quando necessário. Copie o código de suporte, não o token.

Pesquisa e paginação

Pesquise por telefone, nome verificado, WABA ou Phone Number ID. Escolha a quantidade de cards por página. A pesquisa não muda o workspace nem a conexão canônica.

Ainda precisa de ajuda?

Envie o e-mail do owner, Workspace ID, Connection ID, horário aproximado e o código de suporte exibido no painel para suporte@hookcloud.app. Nunca envie o token completo.

Capacidade e substituição de números

A aba Assinatura mostra o plano vigente, a capacidade paga e a previsão de adicionais na renovação. A conclusão de uma desconexão ou o reconhecimento de um banimento pode liberar uma vaga reutilizável, sem apagar o histórico de risco. Veja como substituir números, como os adicionais são ajustados e como migrar voluntariamente para o Pro.

Para contratar uma nova vaga adicional no Starter 2 ou no Pro 1 elegível, comece na Visão geral pelo botão Conectar com a Meta. Depois da seleção e autorização do número, se faltar uma vaga já paga, o painel apresenta a prévia do adicional antes de concluir a conexão. O proprietário confere os valores e autoriza a contratação; a capacidade depende da confirmação do pagamento. A aba Assinatura não possui um editor de quantidade para essa compra. Veja o passo a passo, as condições dos planos e o que fazer se houver erro.