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
| Medida | Como 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 dias | Aplica-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
| Etapa | Critérios de evolução |
|---|---|
| 250 → 2.000 | De 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.000 | De 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.000 | De 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 → ilimitado | De 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. |
| Ilimitado | Na 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:
- Verificar a empresa pelo processo da Meta.
- 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.
- 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.
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
- 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.
- 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.
- 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.
- 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.
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
| 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. |
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.
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. |
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.
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.