O painel, tela por tela

Esta página descreve o que a tela desenha hoje, do ponto de vista de quem abre. Ela serve para quem não escreve código e precisa achar a credencial, conferir o estado de um número ou entender uma cobrança sem abrir chamado.

Onde ele fica, e o que ele pede

A entrada é hub.zeracompany.com, com o e-mail do cadastro. Depois de entrar, o painel abre em app.zeracompany.com, e é ele que este capítulo descreve. Você chega na mesma tela pelo botão Ir para o painel, no topo desta página.

• O acesso vale por 30 dias em cada navegador, sem precisar entrar de novo. Passado esse tempo, a tela pede um acesso novo e diz isso com todas as letras, em vez de ficar em branco. Para encerrar antes, use Sair, no alto da página.
• O painel precisa de JavaScript. Ele monta cada seção no navegador. Com o JavaScript desligado, continuam funcionando o cadastro do cartão e o botão Sair, e a própria tela avisa isso.
• A faixa no topo só aparece quando existe um fato para contar. Hoje ela sobe num caso só: a assinatura já foi cancelada, e a frase traz a data até quando o acesso vale.

É por aqui que você entra, e é o único lugar do produto onde a sua credencial fica visível.

O cabeçalho, que é igual em todas as telas

A faixa de cima não muda de seção para seção. Ela carrega seis coisas, e vale saber o que cada uma faz antes de procurar dentro das telas.

• A marca, à esquerda, volta para a lista de canais.
• O nome da sua empresa, e ao lado dele um seletor escrito Escolher um canal. Ele lista os seus números e leva direto para a tela de um deles.
• O botão Pedir mais um número, que abre um e-mail para a Zera. Ele não compra nada, e não existe botão que compre: a quantidade de números é definida na assinatura.
• O círculo com as suas iniciais, à direita, que leva aos dados da conta, em Ajustes. Ele não abre menu nenhum, porque não existe menu de conta construído.
• O botão Sair, na ponta direita, que encerra o acesso deste navegador. Ele é o único controle do painel que funciona com o JavaScript desligado, porque sair pela metade sem avisar é a falha que mandaria você embora achando que fechou a porta. Ele apaga o acesso guardado aqui e cancela a sessão do lado da Zera: quem tiver uma cópia dela também deixa de entrar.
• A fileira de seções: Canais, Cobrança, Faturas, Usuários e Ajustes. Na ponta direita fica Documentação, que sai do painel e abre o início desta documentação.

Logo abaixo vem a migalha, que diz onde você está: ZeraSync, a sua conta, e o número aberto quando você está dentro de um.

É por aqui que você troca de número sem voltar para a lista.

Canais: a lista dos seus números

É a tela inicial. Cada linha é um número de WhatsApp da sua conta, e as colunas são estas seis, sempre nesta ordem.

Na ponta direita de cada linha ficam as ações, e a coluna delas não tem título visível: quem usa leitor de tela ouve Ações. Quando o número está pedindo alguma coisa, o botão dessa ação aparece primeiro, com o texto inteiro. Ao lado dele, o botão de seta abre a tela do canal.

• O campo Buscar por número filtra pelos dígitos do telefone, sobre a lista que já está carregada. Ele não busca por nome nem por identificador.
• A lista mostra dez por página, com a contagem e as setas no rodapé.
• O botão Adicionar um número não abre um formulário de compra: ele abre a explicação de como um número novo entra, que é junto com a assinatura dele.
• Número cancelado não aparece nesta lista.

É por aqui que você vê todos os seus números de uma vez e abre um deles.

O que cada situação quer dizer

A coluna Situação na Zera mostra o estado do número dentro da Zera. O que a Meta enxerga fica em outro lugar, no cartão Estado na Meta da aba Detalhes. São coisas diferentes de propósito, e misturar as duas é o jeito mais rápido de procurar problema no lugar errado.

Existe ainda o estado Cancelado, que não aparece na lista. Se um dia a tela mostrar uma situação com um nome que ela não conhece, ela escreve o código cru e diz que ainda não sabe traduzir, em vez de escolher a pastilha mais parecida.

É por aqui que você descobre o que falta em cada número, sem precisar perguntar.

A tela de um canal, e as sete abas

Clicando num número você entra na tela dele, que tem sete abas. O endereço guarda a aba aberta, então dá para salvar nos favoritos e mandar por e-mail o link da aba certa.

/painel/canal/ID_DO_CANAL/comecar
/painel/canal/ID_DO_CANAL/detalhes
/painel/canal/ID_DO_CANAL/perfil
/painel/canal/ID_DO_CANAL/modelos
/painel/canal/ID_DO_CANAL/insights
/painel/canal/ID_DO_CANAL/atividade
/painel/canal/ID_DO_CANAL/caixa_de_entrada

O identificador do canal é o mesmo que aparece embaixo do título do cartão Dados do canal. Repare que a aba escrita Métricas tem insights no endereço: o rótulo segue o português e o endereço segue o nome que a rota emite.

Abrindo o número sem escrever a aba, o painel decide qual mostrar: Detalhes quando ele já passou pela conexão com a Meta, e Começar quando ainda não passou.

As rotas citadas acima são as do próprio painel, e elas andam com a sessão do seu navegador. Elas não fazem parte da API que você chama com a sua credencial: essa está em Referência, e o servidor dela é a Meta.

Começar

É a aba que responde uma pergunta só: como usar este número. O painel não pergunta, ele diz, a partir do que a sua conta tem. São três caminhos, e você vê um deles.

• Conectar o número à Meta. Enquanto ele não estiver conectado, nada entra e nada sai. A tela pergunta ao servidor se a conexão pode abrir agora e mostra o botão Ir para a ativação, ou o motivo de não abrir: pagamento ainda não confirmado, número que vinha de outra plataforma de API, outro número da conta na frente na fila, nenhum número da conta esperando conexão agora, ou uma falha nossa, dita como falha nossa.
• Atender pela plataforma. Aparece para quem contratou a caixa de entrada da Zera, com o botão Abrir a plataforma. Ele só nasce depois que a sua conta existe lá dentro, e a tela explica quando ainda não existe.
• Usar pela API. É o caminho de quem comprou o número conectado para o próprio sistema. Traz dois botões: Ver os ajustes de API, que abre a aba Detalhes, e Ler a documentação, que abre o início desta documentação.

Quando o número está pedindo alguma coisa, um cartão no topo desta aba diz o que é e por quê, com o botão que resolve.

É por aqui que você descobre o próximo passo de um número novo.

Detalhes

É a aba mais densa, e a que você vai abrir mais vezes. Ela tem quatro cartões, nesta ordem.

Em Como o número chegou aparece uma destas quatro respostas, que é o que você informou na ficha: número novo sem WhatsApp antes, vinha do WhatsApp comum no aparelho, vinha do WhatsApp Business no aparelho, ou vinha de outra plataforma de API.

Os sete campos do cartão Estado na Meta são Qualidade, Limite de mensagens, Pode enviar, Situação do número, Nome aprovado, Verificação por código e Revisão da conta. Dois deles merecem um aviso:

Para quem não tem a caixa de entrada no plano, o fim desta aba traz uma faixa sobre a caixa de entrada da Zera. É oferta, e está escrito que é.

É por aqui que você pega os identificadores que as suas chamadas usam.

Perfil

Mostra o perfil público do número, que é o que a pessoa vê ao abrir a conversa com você: Sobre, Descrição, Endereço, E-mail, Sites, Categoria do negócio e Foto do perfil. A leitura é feita na Meta ao abrir a aba, e a data dela fica no topo do cartão.

• Campo vazio no seu perfil e campo não lido são duas frases diferentes. A tela nunca diz que o seu perfil está em branco quando quem falhou foi a leitura.
• Sites traz até cinco endereços. Quem tem mais que isso no perfil vê os cinco primeiros, e a tela não avisa que cortou.
• A foto é desenhada, servida pelo domínio da Zera para não esbarrar na política de segurança da página. Quando o endereço temporário da Meta já venceu, ela não carrega: a prévia mostra as iniciais e a linha "Foto do perfil" passa a dizer que a foto existe e não carregou agora, que é diferente de não existir.
• Tem um botão que abre uma conversa com o próprio número, pelo wa.me.
• A Zera lê o seu perfil e agora também escreve nele. O botão Editar o perfil abre um formulário e o Salvar na Meta manda a alteração para a Meta. Se ela recusar, a tela diz o motivo e o que você digitou não se perde.

É por aqui que você confere o que o seu cliente vê antes de mandar a primeira mensagem.

Modelos

A tabela dos modelos de mensagem da sua conta de WhatsApp, com Nome, Categoria, Idioma, Situação na Meta e Qualidade. Quando algum modelo trouxer o motivo da recusa, nasce uma sexta coluna com ele. A coluna não aparece vazia de propósito: coluna sempre em branco afirmaria que a Meta não deu motivo para nenhum.

• A leitura traz até 100 modelos. Com mais que isso, a tela avisa que existem outros e que ela ainda não pagina.
• Os modelos são da conta de WhatsApp inteira. Se você tem mais de um número na mesma conta, eles servem para todos.
• Entregues, taxa de leitura e cliques não aparecem. Esses números vêm de uma leitura por modelo que a Zera não faz, e uma coluna zerada diria que os seus modelos não chegaram a ninguém.
• Modelo de texto você cria aqui. No cartão Criar um modelo de texto, embaixo da tabela: nome, idioma, categoria, o texto e um exemplo para cada variável. A Zera envia para aprovação na Meta e relê o modelo lá para mostrar o estado que ela respondeu.
• Editar, apagar, e criar com cabeçalho, botão, mídia ou rodapé continua na Meta. O formato de cada um desses não é montado por aquele formulário. Como fazer está em Modelos de mensagem.

É por aqui que você descobre qual modelo está aprovado antes de tentar enviar.

Métricas

Mensagens enviadas e entregues, o custo aproximado do período e a quebra por categoria de cobrança. Você escolhe o período, entre 7, 30 e 90 dias, e o detalhe do gráfico, por dia ou por mês. A aba abre com um aviso, e ele é a coisa mais importante da tela: quem cobra o envio é a Meta, direto de você. A Zera não intermedia esse pagamento e não põe margem nele.

• Os números são a analítica da Meta, que é aproximada e pode divergir da fatura. Para a contabilidade vale o faturamento da Meta, nunca este gráfico.
• Eles são da conta de WhatsApp inteira, e não só deste número. A tela lista quais números entraram na soma, quando a Meta diz quais são.
• O custo vem com a moeda e o intervalo ao lado, sempre. Ele é lido na sua conta da Meta, e vai para a tela na moeda em que ela cobra você. A Zera não converte para real: converter exigiria uma cotação, e cotação chutada dentro de um painel de dinheiro é a pior invenção possível nesta tela.
• Quando a Meta não devolve o valor, a tela diz por quê. Ela esconde o custo de quem não carrega a própria linha de crédito, ou seja, de quem tem a conta cobrada por um parceiro em vez de ser cobrada direto por ela. Nesse caso a aba escreve o motivo e o caminho da fatura, e não desenha zero: zero diria que você não gastou nada.
• Intervalo sem número não vira barra de altura zero. Barra zero afirmaria que nada foi enviado, e o que aconteceu foi a Meta não mandar o campo.

É por aqui que você acompanha o volume e o custo aproximado. O número que fecha a conta continua sendo o da fatura da Meta.

Atividade

O histórico deste número, em três colunas: Data, O que aconteceu e Por. Ele começa na primeira mudança de estado do canal e é gravado pelo próprio banco, então nada se perde depois que passa a existir. A tela mostra até os 100 eventos de mudança de estado mais recentes. O rodapé conta quantas linhas ela desenhou, e esse total pode passar de 100, porque as exibições de credencial entram por outro caminho e são somadas depois.

Em Por a tela escreve três respostas: Você, pelo painel, para a mudança que passou por uma tela do produto; Meio de pagamento, para o que chegou do gateway de cobrança; e Sistema, para o que veio de uma rotina nossa, como o corte no fim do período pago. Autor que a tela não reconhece também sai como Sistema, em vez de virar um nome inventado. E-mail de pessoa da Zera nunca aparece aqui.

As dez exibições mais recentes da credencial viram linha nesta aba, com data e hora. Tentativa que foi recusada depois de registrada não entra, e exibição mais antiga que a décima sai da lista. É a segunda trilha da revelação, e ela não é permanente: a primeira é o e-mail que sai para o dono da conta no mesmo minuto.

É por aqui que você confere as mudanças de estado do seu número e as exibições da credencial. A troca do endereço do webhook não aparece aqui. Com a conexão concluída, o registro dela que chega a você é o e-mail ao dono da conta; o apontamento feito pela rotina de operação da Zera não manda e-mail.

Caixa de entrada

Para quem contratou a caixa de entrada da Zera, esta aba responde três coisas: se a caixa deste número está criada, quando ela foi conferida, e qual é o identificador dela. Tem também o botão Abrir a plataforma, que só aparece depois que a sua conta existe lá dentro.

Para quem está no plano da API, a aba existe e diz que o plano não inclui a tela de conversas. Nenhuma conversa de exemplo é desenhada ali: uma demonstração com o seu número em cima seria a tela mentindo para vender.

É por aqui que você confirma que o atendimento da Zera já está de pé para este número.

Onde fica a credencial, clique a clique

A credencial da Cloud API mora dentro da aba Detalhes, no fim do cartão Ajustes de API. Este é o caminho inteiro, sem pular passo.

1. Entre com o e-mail do cadastro

   Em hub.zeracompany.com, pelo link que chega no e-mail ou com a sua senha.

2. Abra Canais e clique no seu número

   Na ponta direita da linha, o botão de seta abre a tela do canal.

3. Fique na aba Detalhes

   Se o número já está conectado, ela abre sozinha. Se não, clique nela na fileira de abas.

4. Role até o cartão Ajustes de API

   O Identificador do número e a Conta WABA já estão na tela, sem clique nenhum. Eles não são segredo.

5. Clique em Mostrar a credencial

   O botão fica no fim do mesmo cartão, embaixo do título Credencial da Cloud API. O que ele vai fazer está escrito antes do clique, e não depois.

Quatro coisas valem saber antes de clicar, e as quatro estão na tela: o painel exige um acesso feito nos últimos dez minutos, o dono da conta recebe um e-mail no mesmo minuto, são três exibições a cada 24 horas na conta inteira, e a credencial some da tela quando você troca de aba ou recarrega a página.

[Decisão de 06/09/2026] Esse bloco aparece para todo plano, inclusive o que tem caixa de entrada: o ZeraSync passou a incluir a API do WhatsApp, e a credencial serve para o seu sistema enviar. Até 06/09/2026 este parágrafo dizia que o bloco só aparecia para quem estava no plano sem caixa, porque era a mesma credencial que o atendimento usava e exibir ela abriria o caminho de derrubar o próprio atendimento: o risco continua real, e quem segura ele hoje é a rota não ter botão nenhum de girar ou trocar o token: só ver o valor não derruba nada. Quem tem a caixa de entrada da Zera continua com o recebimento nela, sem mudar (é o mesmo número, a mesma credencial, e dois usos diferentes). O que cada recusa quer dizer, e o que fazer em cada uma, está em A sua credencial.

É por aqui que você pega o token que as suas chamadas usam.

Quando cada número desta tela foi lido

Todo valor que veio da Meta aparece com a data da leitura ao lado. Isso não é enfeite: valor sem data mente por omissão, porque leitura de três semanas atrás parece leitura de agora. Quem pede leitura nova é você, apertando um botão, e cada botão tem o seu freio.

Quando um limite bate, a tela diz que bateu e mantém na tela o que já tinha lido, com a data. Ela não apaga o valor anterior por causa de uma leitura que não passou.

É por aqui que você sabe se está olhando um valor de agora ou de terça.

O webhook, e o que o painel faz com ele na Meta

Esse endereço entra pela primeira vez na ficha do número, num campo opcional que só aparece no plano sem caixa de entrada. Quem contratou a caixa de entrada nunca vê esse campo, porque as mensagens dele chegam na plataforma, e a rota recusa a troca com plano_com_inbox. Para trocar depois, o lugar é aqui mesmo, neste cartão: o bloco do endereço tem um botão de alterar, e salvar em branco apaga o que estava guardado, na Meta primeiro e no nosso banco depois.

Salvar aqui exige uma sessão com menos de dez minutos de vida, a mesma trava da exibição da credencial, e, com a conexão do número concluída, avisa o dono da conta por e-mail antes de a Meta ser tocada. Se o e-mail não for aceito pelo provedor, nada é apontado nem apagado na Meta naquele salvamento. Ao apontar, o endereço fica guardado do nosso lado, e a rotina de operação da Zera pode apontá-lo depois, sem outro e-mail. Essa rotina também pode apontar, depois que a conexão fecha, um endereço guardado antes dela, como o da ficha; nesse caso o código de verificação não aparece no bloco do webhook e fica no campo webhook_verify_token da exibição da credencial, que a tela desenha logo abaixo do token, com botão de copiar. Mesmo sem a conexão, salvar pede a sessão de dez minutos. São dez tentativas de salvar por hora, por conta, contando as recusadas pela trava da sessão.

Salvou com a conexão concluída e a tela disse Endereço guardado, mas não apontado na Meta? A Zera não chegou a chamar a Meta: o motivo mais comum é o aviso por e-mail ao dono não ter saído. Tente de novo em alguns minutos e, se repetir, escreva para a Zera. Se a resposta do salvamento não chegar à tela, ela diz A resposta não chegou até esta tela: recarregue e confira a linha de estado antes de salvar de novo, porque o endereço pode ter sido gravado e apontado.

Depois de salvar, o bloco ganha uma linha de estado, com o que a releitura na Meta devolveu. Ela diz uma destas coisas: Apontado na Meta, com data e hora; A Zera está aplicando este endereço na Meta agora; Guardado aqui, ainda não apontado na Meta, que é também o que aparece enquanto a conexão do número não foi concluída; A Meta está entregando em outro endereço; A Meta não confirmou este endereço, com o código ao lado, que não quer dizer recusa, porque o erro pode ter vindo da releitura depois de uma escrita que valeu; A Meta não respondeu, ou respondeu com uma falha do lado dela; o aviso de que o endereço passa dos 200 caracteres, recusa nossa que nem chega à Meta; ou a frase de falha nossa. A Zera está aplicando este endereço só aparece quando o último apontamento confirmado tem menos de cinco minutos: fora disso, uma escrita em andamento aparece como falha nossa, então atualize a página em um minuto antes de concluir. Apontado na Meta é o que ficou gravado do último apontamento que deu certo, e a tela não relê a Meta quando você a abre: depois de uma reconexão do número, ou de uma sobreposição feita fora do painel, a linha pode continuar dizendo isso sem valer mais, como Receber mensagens explica. Ela só aparece embaixo do endereço que a Meta confirmou: um endereço novo que ainda não foi apontado, por exemplo depois de um aviso ao dono que não saiu, aparece como Guardado aqui, ainda não apontado na Meta. Quando o salvamento que gera o código de verificação é o mesmo que fecha o apontamento, a resposta traz esse código num bloco com botão de copiar, uma vez só. Se ele foi gerado antes, ele não volta aqui: sai pela exibição da credencial, que o desenha logo abaixo do token, com rótulo e botão de copiar próprios. O passo a passo inteiro está em Receber mensagens.

Cobrança

Duas coisas, em dois cartões. O seu meio de pagamento diz por onde a assinatura da Zera é cobrada, e O que você paga abre a conta fechada: Plano, Números contratados, Valor por número, Valor total, Parcelas quando existem, Próxima cobrança e Acesso pago até.

• A bandeira e os quatro últimos dígitos só aparecem quando o servidor os manda. No caminho normal eles não existem, porque o cartão fica guardado no gateway e a Zera nunca os recebe. A tela escreve isso, em vez de desenhar quatro asteriscos.
• O cadastro e a troca do cartão acontecem numa página do próprio gateway, então o número do seu cartão não passa pela Zera em momento nenhum.
• A troca de cartão só é oferecida enquanto a assinatura está na fase em que ela realmente funciona. Fora dessa fase, a tela manda escrever para a Zera, em vez de deixar você digitar cartão para tomar erro no fim.
• Não existe botão de remover o meio de pagamento, e a tela explica por quê: a assinatura precisa de um para continuar. Para parar de pagar, o caminho é cancelar, em Ajustes.
• Quem já pediu o cancelamento não lê convite para cadastrar cartão nesta tela, e sim que não haverá nova cobrança.

É por aqui que você vê quanto paga para a Zera, e por onde.

Faturas

A lista do que a Zera cobrou desta conta, em seis colunas: Fatura, Vencimento, Valor, Situação, O que fazer e Comprovante. A coluna O que fazer, a quinta, é a razão de esta tela existir: ela responde, linha por linha, se você precisa agir.

• O comprovante é um botão, e não um link: ele pede o documento e só então abre. Enquanto o pagamento não é confirmado, a tela diz que ele aparece depois.
• A lista traz as 100 cobranças mais recentes e não tem setas de página, porque a leitura não pagina. Seta que não leva a lugar nenhum é controle falso.
• O que a Meta cobra de você não passa por aqui. São dois fornecedores e duas faturas: a assinatura da Zera é esta tela, e as mensagens são cobradas pela Meta, no cartão que está na conta dela.

É por aqui que você acha o comprovante de uma cobrança da Zera.

Usuários

Uma tabela com quem tem acesso a esta conta, em seis colunas: Nome, E-mail, Papel, Situação, Acesso e Ações. O papel é Dono da conta ou Convidado, e a conta tem um dono só, que é quem contratou. A coluna Acesso mostra a data de entrada só para quem já entrou; enquanto o convite não é aceito, ela mostra o rótulo sem data. Os botões ficam na coluna Ações, ao lado: Reenviar, para quem ainda não entrou, e Remover. Quem entra como convidado não vê nenhum dos dois botões em linha nenhuma, porque quem convida e remove é o dono: no lugar dos botões, a coluna mostra sem ação para você.

Você pode convidar outras pessoas. O convite vai por e-mail, serve uma vez só e vale por 72 horas. Enquanto a pessoa não clicar, ela não tem acesso a nada, e a coluna Situação mostra isso: Convite aberto antes do clique, Com acesso depois dele.

O convidado é de leitura. Ele acompanha os seus números, o andamento da conta e o histórico dela. Ele não exibe a credencial da Meta, não mexe no meio de pagamento, não cancela a assinatura, não altera cadastro nenhum e não salva o endereço do webhook. O bloco do webhook aparece para ele, mas salvar ali recebe so_o_dono, HTTP 403, e nada é gravado. Quem convida, remove e altera é o dono.

Remover tira o acesso na hora. Não é um pedido que entra numa fila: no mesmo instante a sessão daquela pessoa cai em todos os aparelhos em que ela tenha entrado, e o convite dela, se ainda não tiver sido usado, deixa de valer.

Quem atende no dia a dia não precisa deste painel: a equipe de atendimento é cadastrada dentro da plataforma de conversas, que tem os usuários dela.

É por aqui que você confere e controla quem tem acesso a esta conta.

Ajustes da conta

Seis cartões, de cima para baixo.

• Dados do cliente. Nome, Empresa, E-mail, CNPJ ou CPF mascarado, País, Moeda da cobrança, Idioma dos e-mails e a data em que a conta foi criada. Nada disso é editável aqui, e a tela explica o motivo: a sua cobrança já foi emitida com esses dados, e trocar só de um lado deixaria o cadastro do meio de pagamento diferente do seu.
• Acesso e senha. Quanto tempo vale o acesso guardado em cada navegador, o caminho para definir ou trocar a sua senha, e o botão Sair de todos os aparelhos. Ele é o que você usa quando desconfia que a sua senha vazou: os seus outros aparelhos saem na hora, os links de acesso por e-mail que ainda não foram usados param de valer, as pessoas que você convidou saem junto, e você também sai deste aparelho e entra de novo. Nada da sua conta é apagado. Quem entrou como convidado não vê o caminho da senha, porque o convidado não tem senha nesta conta: o acesso dele vem do link do convite.
• Notificações. Não existe escolha de quais avisos você recebe, então não há interruptor desenhado. O cartão conta o que a Zera manda hoje: link de acesso, cobrança e mudanças no seu número.
• Termos aceitos. Situação, versão e data, com os links dos Termos de Uso e da Política de Privacidade. Quando o texto integral do aceite está guardado, ele fica recolhido num bloco que você abre: é a sua prova do que estava escrito na tela no dia.
• Histórico da conta. O que mudou nesta conta e quem mudou.
• Cancelar a assinatura. Sem multa, sem fidelidade e sem ligação de retenção. O motivo é obrigatório, o comentário é opcional, e o cancelamento vale ao fim do ciclo já pago. Quem já pediu para sair não encontra o botão de novo: encontra o próprio pedido registrado, com a data.

É por aqui que você cancela, sem precisar falar com ninguém.

Quando um dado aparece como ausente

Decisão do Albert (05/09/2026): quando existe um rótulo curto para a ausência, é ele que fica na tela, dentro da célula ou do rótulo, e a frase inteira vai para o title (e um span só para leitor de tela, ligado por aria-describedby) do elemento que ficou, além desta página. Onde ainda não existe rótulo curto, a frase inteira continua na tela, e o único lugar em que isso muda é a lista de Canais, que mostra só a primeira frase quando não encontra um rótulo mapeado. Isto ajusta, sem contradizer, a explicação já registrada no código (a doutrina de sempre dizer POR QUE um dado falta continua valendo por inteiro): muda só ONDE mora a frase inteira quando existe rótulo curto.

Os oito códigos de dado ausente

Toda leitura que a Zera faz na Meta pode voltar sem valor, com um código de um vocabulário fechado, o mesmo em Canais, na tela de um canal e em Faturas. Muda só a frase, ajustada ao que aquela coluna representa; o código é sempre um destes oito.

Além destes oito, existem rótulos curtos que não vêm de vazio_porque, e sim de frases prontas de cada tela. Na lista de Canais: sem autorização guardada, quando o número foi conectado antes de a Zera passar a guardar a autorização (o que fazer: reconectar o número). Na aba Detalhes, cartão Ajustes de API: no par O seu webhook, os rótulos descritos no próximo parágrafo. E no cartão Credencial da Cloud API, credencial não disponível aqui, para quando a tela não tem nem a credencial nem um código de recusa para explicar o motivo. Os demais estão descritos mais abaixo em O que saiu da tela e mora aqui.

[Decisão de 06/09/2026] O par Chave de API deixou de existir nesta tela: até 06/09/2026 ele aparecia, no cartão Ajustes de API, só para quem tinha caixa de entrada, com chave própria ainda não existe e peça em [email protected]. Com o ZeraSync passando a incluir a API do WhatsApp, todo plano passou a ver o cartão Credencial da Cloud API no lugar dele.

"Reconecte o número": as sete frases irmãs

Quando o motivo é a autorização (nunca guardada, vencida ou revogada pela Meta), cada tela escreve a própria frase, ajustada ao que ela faz ali, e todas terminam pedindo para reconectar.

• Credencial, quando nunca foi guardada: "Este número foi conectado antes de a Zera passar a guardar a autorização, então não existe credencial para exibir. Reconecte o número."
• Credencial, quando venceu: "A credencial guardada deste número já venceu, e exibir ela agora entregaria uma chave morta. Reconecte o número."
• Estado na Meta, quando a autorização foi revogada: "A sua autorização na Meta parou de valer para este número. Reconecte para a Zera voltar a ler o estado." O botão desta tela chama-se Reconectar o número.
• Perfil, sem autorização guardada: "A autorização deste número não está guardada aqui. Reconecte o número para poder editar o perfil."
• Perfil, autorização revogada: "A sua autorização com a Meta foi revogada, então ela recusou a alteração. Reconecte o número."
• Modelos, sem autorização guardada: "A autorização deste número não está guardada aqui, então não dá para falar com a Meta por ele. Reconecte o número."
• Modelos, autorização revogada: "A sua autorização na Meta parou de valer para este número, então o modelo não foi enviado. Reconecte e tente de novo."

Em todas, o que fazer é o mesmo: reconectar o número. O telefone continua o mesmo e as conversas não se perdem, como já descrito na tabela de situações, mais acima nesta página.

Em Faturas, o mesmo código de autorização revogada tem uma frase própria da tela, sem botão de reconectar ali: "A autorização para ler as suas cobranças não vale mais." O caminho é a aba Detalhes do canal.

É por aqui que você entende o rótulo curto que a tela mostrou, sem precisar adivinhar o resto da frase.

O que saiu da tela e mora aqui

A passada de 05/09/2026 (painel enxuto) tirou vários parágrafos explicativos da superfície visível, deixou uma frase curta ou um botão no lugar, e guardou o texto por extenso no title do elemento que ficou e num span só para leitor de tela, ligado a ele por aria-describedby (porque célula e parágrafo não recebem foco e celular não tem hover). É o padrão único de acessibilidade desta entrega: nunca o sr-only dentro de um botão, de um link ou de um h2, sempre irmão do elemento que ficou visível. Esta seção reúne esses textos, copiados do código.

Detalhes, Ajustes de API: o webhook

[Decisão de 06/09/2026] O par Chave de API que existia aqui, com chave própria ainda não existe e peça em [email protected], saiu da tela: o ZeraSync passou a incluir a API do WhatsApp, e quem tem caixa de entrada passou a ver o cartão Credencial da Cloud API (descrito logo abaixo) em vez dessa explicação de ausência.

No par O seu webhook, quando não há endereço guardado, a célula mostra um destes rótulos, conforme o seu plano: não precisa (usa a plataforma), para quem tem a caixa de entrada da Zera; ou sem endereço configurado, para quem está no plano da API e ainda não informou um endereço (o mesmo rótulo cobre também o instante em que a tela ainda não sabe qual é o seu plano). As frases inteiras:

• Com caixa de entrada: "Você não informou um endereço de webhook. Quem atende pela plataforma da Zera não precisa de um: ela já recebe as mensagens."
• Sem caixa de entrada, no plano que pode configurar: "Você ainda não informou um endereço de webhook, e sem ele o seu sistema não recebe as mensagens. Informe o endereço no bloco do webhook desta aba: com a conexão do número concluída, salvar aponta o endereço na Meta. O passo a passo está em docs.zeracompany.com/docs/receber." Hoje essa célula não chega a ser desenhada para esse plano, porque ele ganha o bloco inteiro de edição, descrito logo abaixo.
• Quando a resposta não trouxe o seu plano, o que a rota do canal de hoje não faz, porque ela sempre manda o campo: "Você não informou um endereço de webhook, e esta leitura veio sem o seu plano, então a tela não sabe qual caminho vale para este número. Recarregue a página; se continuar assim, escreva para [email protected]. O caminho de cada plano está em docs.zeracompany.com/docs/receber." Até 23 de setembro de 2026 ela mandava sobrepor o endereço na Meta com a sua credencial, e a tela não tinha como saber se o número tinha a caixa de entrada, que essa sobreposição derrubaria.

Quando a célula pode mesmo trocar o endereço, ao lado do rótulo curto nasce um link real para Receber mensagens, apontando direto para o endereço que a frase escondida cita.

Para quem pode mesmo trocar o endereço, o bloco de edição do webhook mostra uma nota curta, com a frase inteira em title e num span só para leitor de tela. São duas versões, conforme o número:

• Com a conexão concluída: "Salvar aponta este endereço na Meta; a linha abaixo diz o que ela confirmou." A frase inteira: "Salvar aqui avisa o dono da conta por e-mail e aponta este endereço na Meta, no número. A linha de estado abaixo do endereço diz o que a Meta confirmou."
• Com a conexão ainda por concluir: "Por enquanto salvar só guarda: conclua a conexão do número e salve de novo." A frase inteira: "Este número ainda não concluiu a conexão com a Meta, então salvar aqui só guarda o endereço: nada é apontado e nenhum e-mail sai. Conclua a conexão e salve o endereço de novo para ele ser apontado."

Existe uma terceira, que só aparece se a escrita na Meta estiver desligada do nosso lado, e que foi a única até 23 de setembro de 2026: "O endereço fica guardado aqui; a entrega na Meta é configurada por você." Com a escrita ligada, que é o estado de produção, ela não aparece.

O título do cartão Credencial da Cloud API leva, pelo mesmo mecanismo, a frase: "É com ela que o seu sistema fala com a Meta por este número." [Decisão de 06/09/2026] Para quem tem caixa de entrada, a mesma frase escondida ganha uma segunda oração: "A caixa de entrada usa esta mesma credencial: ela serve para o seu sistema enviar; o recebimento continua na caixa."

Perfil: por que não existe um botão para o Gerenciador da Meta

O botão Editar o perfil carrega, em title e num span só para leitor de tela, a frase: "Não existe aqui um botão para abrir este número no Gerenciador da Meta. Entre por business.facebook.com com o mesmo acesso que autorizou a conexão."

Modelos: as cinco notas sob a tabela

Das notas que ficavam por extenso abaixo da tabela de modelos, quatro saíram da tela e passaram a viver no title e no span de leitor de tela do link "Ler a documentação" para Modelos de mensagem, uma atrás da outra no mesmo texto; nenhuma delas tem rótulo visível na tela. Só a nota que muda a leitura do dado (quantos modelos a leitura trouxe) continua por extenso na tela. As frases inteiras, na ordem em que entram nesse texto:

• Quando há modelo recusado: "Modelo recusado não bloqueia os outros: corrija e reenvie para aprovação no Gerenciador da Meta. Modelo pausado é aviso de qualidade baixa, e é desativado se continuar assim."
• Quando há modelo recusado sem o motivo na leitura: "Esta leitura voltou sem a coluna do motivo da recusa, então ela não aparece na tabela acima. Não quer dizer que a Meta não informou o motivo."
• Sempre: "Você cria um modelo de texto no cartão abaixo e a Zera envia ele para aprovação na Meta. Editar, apagar e criar modelo com cabeçalho, botão, mídia ou rodapé é no Gerenciador da Meta (business.facebook.com)."
• Sempre: "Estes modelos são da conta WhatsApp deste número. Se você tiver mais de um número na mesma conta, eles servem para todos."
• Sempre: "Entregues, taxa de leitura e cliques não aparecem aqui. Esses números vêm de uma leitura por modelo que a Zera ainda não faz."

Métricas: o banner e os subtítulos

O banner do topo da aba, que juntava título e parágrafo em duas linhas, virou a linha "A Meta cobra o envio direto de você. Este número é aproximado; vale a fatura da Meta.", com a frase inteira em title e num span só para leitor de tela: "Quem cobra o envio é a Meta, direto de você. A Zera não intermedia esse pagamento e não põe margem nele. Os números desta aba, custo incluído, são a analítica aproximada da Meta. Para a contabilidade vale a fatura dela, nunca este painel."

O título da tabela de custo e mensagens por categoria leva, no mesmo mecanismo, a frase: "A Meta cobra por categoria, e aqui dá para ver qual puxa o valor. São só as cobráveis, então o total não bate com o de enviadas acima."

O gráfico de barras leva, em title do próprio desenho, a frase que antes ficava escrita ao lado: "A barra mais alta deste gráfico vale {n} mensagens em um intervalo."

Faturas: a coluna O que fazer

O rótulo curto de cada situação é fiel à ação, e não repete a coluna Situação: Sai sozinha no cartão (em aberto); Nada a fazer (paga, recebida, estornada, cancelada); Cartão recusado (não passou); Fale com o suporte (contestada e situação não reconhecida). Quando há um botão (Atualizar o cartão, ou Falar com o suporte), ele fica nesta mesma coluna.

A fatura vencida é a exceção: a célula mostra só o botão Atualizar o cartão, sem o rótulo ao lado. A explicação "O cartão não pagou esta cobrança." vira title e um span só para leitor de tela ao lado do botão, ligados por aria-describedby.

Cobrança: o seu meio de pagamento

Quando o cartão não pode ser trocado direto por aqui, o cartão mostra o botão Ver as faturas e, ao lado dele, as duas explicações ficam visíveis, porque o painel não sabe em qual caso você está: "Com fatura em aberto, abra a fatura na aba Faturas e pague com o cartão novo. O gateway passa a cobrar nele nos próximos ciclos." e "Sem fatura em aberto, a troca passa pelo suporte: escreva para [email protected] que trocamos com você."

Onde não existe botão de remover o meio de pagamento, o rótulo curto muda conforme o motivo, e a frase inteira vai junto: sem troca a fazer quando a assinatura está encerrando ("Não há troca a fazer: a assinatura está encerrando e não haverá nova cobrança."); sem botão de remover: já está cancelado, também para quem está encerrando ("Não há botão de remover: o cancelamento já pedido encerra a cobrança."); e sem botão de remover: cancele em ajustes, para os demais casos ("Não há botão de remover porque a assinatura precisa de um meio para continuar. Para parar de pagar, cancele em Ajustes, sem multa." ou, para quem tem mais de um meio de cobrança, "Não há botão de remover porque remover não pararia a cobrança. Para parar de pagar, cancele a assinatura em Ajustes, sem multa.").

Ajustes, Acesso e senha

Os dois botões deste cartão carregam a explicação em title e num span só para leitor de tela, atrás de uma frase curta visível:

• Cada sessão dura 30 dias, no botão Definir ou trocar a senha: "Cada navegador guarda um acesso por 30 dias. O botão Sair, no alto da página, encerra o deste navegador."
• Derruba todos os acessos na hora, no botão Sair de todos os aparelhos: "Se a senha vazou, ou a conta ficou aberta em outro computador, derrube todos os acessos. Os aparelhos saem na hora, você também, e nada é apagado. Sendo o dono, isso alcança os links de acesso não usados, quem você convidou e o login com Google ou Facebook."

Os e-mails que a Zera manda

Em Ajustes, o cartão Notificações conta em uma frase o que a Zera manda para o seu e-mail hoje. Não existe uma lista de preferências para ligar ou desligar, porque nenhuma preferência fica guardada. Estes são os e-mails do funcionamento da conta:

• Link de acesso, quando você pede para entrar.
• A sua conta pronta, faltando conectar o número.
• A ficha do número pendente de resposta.
• O cadastro de cobrança foi alterado.
• O plano da sua conta mudou.
• Confirmação de um pedido de cancelamento.
• Convite para o painel, quando você convida alguém.
• Aviso para definir a sua senha.
• Aviso de que a credencial do número foi exibida no painel.
• Aviso de que o endereço de webhook de um número foi trocado ou apagado, antes de a Zera levar a troca para a Meta.

Para mudar o que a Zera manda, o caminho é escrever para [email protected].

O que o painel não faz

Estas ausências são de propósito, e a tela costuma explicar cada uma no lugar onde o botão faria falta. A lista completa, com as ausências do produto inteiro, está em O que a Zera não faz.

• Não compra número novo. O botão de adicionar abre uma explicação, e o caminho é ajustar a assinatura com a Zera.
• Convida usuário, com um papel só. O dono convida por e-mail em Usuários. O convidado acompanha números, andamento e histórico, e não altera nada: não existe um segundo papel nem permissão por seção.
• Aponta o webhook na Meta só no plano da API, e só no número. Quem está no plano da API salva o endereço na aba Detalhes, e, com a conexão do número concluída, o painel aponta esse endereço na Meta, no nível do número, e relê para mostrar o que ficou; antes da conexão, salvar só guarda. Quem atende pela caixa de entrada da Zera não tem o bloco de trocar: vê o campo com o rótulo não precisa (usa a plataforma), e a rota recusa a troca com plano_com_inbox. O painel não escreve endereço no nível da conta nem no do aplicativo.
• Escreve na Meta em três pontos só, além da própria conexão do número. O perfil público do número, pelo botão Editar o perfil; o envio de um modelo novo para aprovação; e o apontamento do endereço do webhook, pelo salvamento descrito acima, que a rotina de operação da Zera também pode refazer para um endereço já guardado. A conexão, por sua vez, inscreve o aplicativo da Zera na sua conta. Fora isso, todo botão de atualizar só lê e grava o que leu do lado da Zera.
• Não gera outra credencial e não revoga a atual. Quem faz as duas coisas é a Meta.
• Não tem saldo nem carteira. Você paga a Meta direto, no cartão da sua conta lá, e a Zera não revende mensagem.
• Não tem ambiente de teste. Não existe número de mentira, e o painel não simula nada.

É por aqui que você descobre o que não procurar, antes de perder a tarde procurando.