← Blog

·

Nome de exibição na API do WhatsApp: regras, aprovação e reprovação

Atualizado em 25/10/2026

O nome de exibição do WhatsApp é o nome da empresa que aparece no perfil do número na API e, depois de aprovado pela Meta, também no topo das conversas e na lista de chats. Ele é obrigatório para registrar o número e precisa seguir as diretrizes da Meta: representar a empresa de forma clara, ter relação evidente com o nome legal ou a marca e não conter termos genéricos, “Oficial”, “Verificado”, nomes de produtos da Meta, promoções nem endereços de site. Nomes reprovados podem ser editados e reenviados, ou contestados pelo suporte.

Onde o nome de exibição aparece

Segundo a documentação de nomes de exibição da Meta:

  • o nome é informado no registro do número e aparece no perfil do WhatsApp do número;
  • ele também pode aparecer no topo das conversas e na lista de chats, mas só depois de aprovado na verificação do nome de exibição;
  • se o usuário salvou ou editou o nome da empresa no próprio WhatsApp, vale o nome que ele definiu.

Nome de exibição não é selo verde. O selo depende de outro processo, explicado em selo verde no WhatsApp.

Quando a Meta analisa o nome

A verificação do nome de exibição começa automaticamente quando o portfólio sobe para um limite de mensagens maior, de acordo com a documentação para desenvolvedores. A Central de Ajuda da Meta para Empresas também informa que, concluída a verificação da empresa, começa a análise do nome de todos os números da conta. Por isso, o nome costuma ser avaliado junto com outras etapas do projeto, como a verificação da empresa no Meta Business e o aumento dos limites de mensagens.

Ao fim da análise, a Meta envia uma notificação no Meta Business Suite e o webhook phone_number_name_update. A documentação não informa prazo para a análise.

Diretrizes da Meta para o nome de exibição

As diretrizes para nomes de exibição da Central de Ajuda da Meta se resumem em quatro princípios. Os exemplos abaixo foram adaptados para empresas brasileiras.

1. Cumprir as políticas

O nome não pode violar a Política de Mensagens Comerciais do WhatsApp. Uma loja de artigos esportivos pode usar “Esportes da Sara”, mas não um nome que destaque um departamento de produto proibido pela política de comércio.

2. Representar a empresa de forma clara

O nome deve representar uma empresa, ou um serviço, produto ou departamento dela. Contas de teste e demonstração são aceitas se mantiverem a ligação com a empresa.

AceitoNão aceitoPor quê
Padaria Pão DouradoPadariaTermo genérico
Pão Dourado AtendimentoSão PauloLocalização geográfica genérica
Pão Dourado MoemaPão Dourado Oficial“Oficial” e “Verificado” sugerem um selo que a empresa não tem
Pão DouradoPão Dourado WhatsAppNão pode citar a Meta nem seus apps (WhatsApp, Facebook, Instagram)
Pão DouradoPão Dourado – 20% de descontoSem linguagem promocional
Pão Douradopaodourado.com.brSem formato de site ou e-mail

Se o nome é de uma pessoa, a atividade precisa estar clara em fontes externas, como o site. “Dra. Ana Lima Odontologia” tende a funcionar quando o site e as redes mostram a clínica com esse nome.

3. Ter relação clara com o nome legal

O nome precisa ter relação evidente com o nome legal da empresa. Quando a marca não é óbvia, a Meta sugere indicar a relação com “by” (em português, algo como “Café Grão por Pão Dourado”), desde que essa ligação apareça em fontes externas, como o site da empresa.

Agências, distribuidores e parceiros que usam o nome de um cliente precisam que a relação entre as duas empresas esteja clara no site. Esse é um motivo comum de reprovação em projetos montados por agências.

4. Manter a marca consistente

O nome deve bater com a marca usada no site, na comunicação ou no nome legal verificado. Abreviações da marca são aceitas (“PD Pães Artesanais”), assim como acrescentar a cidade ou um departamento. Um nome que não aparece em nenhuma fonte externa, ou uma palavra genérica, não passa.

Motivos de reprovação

O webhook phone_number_name_update traz a decisão e, quando há reprovação, o motivo:

{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "WABA_ID",
    "time": 1761400000,
    "changes": [{
      "field": "phone_number_name_update",
      "value": {
        "display_phone_number": "5511999999999",
        "decision": "REJECTED",
        "requested_verified_name": "Pão Dourado Oficial",
        "rejection_reason": "NAME_FORMAT_UNACCEPTABLE"
      }
    }]
  }]
}

Os valores possíveis, segundo a referência do webhook:

rejection_reasonO que significaComo corrigir
NAME_FORMAT_UNACCEPTABLEFormato não aceitoTire termos genéricos, “Oficial”, promoções, site ou e-mail
NAME_NOT_CONSISTENTNão bate com a marca da empresaUse o nome que aparece no site e nas redes, ou atualize o site
NAME_ENDCLIENT_NOTRELATEDContém o nome de uma empresa sem relação aparenteMostre no site a relação entre as empresas, ou use o nome próprio
NAME_INDIVIDUAL_ISSUE / NAME_EMPLOYEE_ISSUEContém nome de pessoa ou identificação de funcionárioUse o nome da empresa; se for nome próprio, deixe a atividade clara
UNKNOWNMotivo não informadoFale com o suporte

O campo decision pode vir como APPROVED, REJECTED, PENDING ou DEFERRED (decisão adiada). Um handler simples para registrar o resultado:

export function tratarNomeDeExibicao(change, db) {
  if (change.field !== 'phone_number_name_update') return;
  const { display_phone_number, decision, requested_verified_name, rejection_reason } = change.value;
  db.salvarStatusNome(display_phone_number, { nome: requested_verified_name, decisao: decision, motivo: rejection_reason });
  if (decision === 'REJECTED') {
    db.criarAlerta(`Nome "${requested_verified_name}" reprovado: ${rejection_reason ?? 'sem motivo'}`);
  }
}

Se o nome foi reprovado, a Meta orienta revisar as diretrizes e editar o nome, ou abrir uma apelação pelo suporte para desenvolvedores.

Como consultar o status pela API

Na Graph API, o nome atual e o status da análise ficam nos campos verified_name e name_status do número:

curl "https://graph.facebook.com/v26.0/PHONE_NUMBER_ID?fields=verified_name,name_status" \
  -H "Authorization: Bearer TOKEN"
{ "verified_name": "Pão Dourado", "name_status": "APPROVED", "id": "PHONE_NUMBER_ID" }

O verified_name é só o texto enviado, não indica aprovação. Quem diz se foi aprovado é o name_status (campo em beta, que pode não estar disponível para todas as contas), com os valores APPROVED, AVAILABLE_WITHOUT_REVIEW, DECLINED, PENDING_REVIEW, EXPIRED ou NONE, segundo a documentação de números de telefone. Para gerar um token de produção, veja token permanente com usuário do sistema.

Como alterar o nome de exibição

Pelo WhatsApp Manager

Acesse WhatsApp Manager > Ferramentas da conta > Números de telefone, escolha o número, abra a aba Perfil e clique em Editar ao lado do nome de exibição.

Pela API

Envie o novo nome no campo new_display_name:

curl -X POST "https://graph.facebook.com/v26.0/PHONE_NUMBER_ID?new_display_name=P%C3%A3o%20Dourado%20Moema" \
  -H "Authorization: Bearer TOKEN"

E acompanhe a análise com os campos new_display_name e new_name_status, que fica PENDING_REVIEW enquanto a Meta avalia.

Regras da alteração

  • Limite: até 10 alterações a cada 30 dias.
  • Registrar de novo: depois que o novo nome é aprovado, é preciso registrar o número novamente para aplicar o nome nos servidores do WhatsApp, com POST /{PHONE_NUMBER_ID}/register informando messaging_product e o PIN de duas etapas. Registrar antes da aprovação não tem efeito.
  • Prazo: há 14 dias após a aprovação para fazer o novo registro. Depois disso, o nome precisa passar por análise de novo.
  • Conta comercial oficial: quem tem selo de conta oficial precisa pedir a alteração ao suporte.
  • Sem refazer o cadastro: não é necessário repetir o Cadastro Incorporado.

Checklist antes de enviar o nome

  • O nome aparece igual (ou como abreviação clara) no site e nas redes da empresa.
  • Não tem palavras genéricas sozinhas, cidade sozinha, “Oficial” ou “Verificado”.
  • Não cita WhatsApp, Facebook, Instagram ou Meta.
  • Não tem promoção, slogan, site ou e-mail.
  • Se é marca de outra empresa (agência, distribuidor), a relação está no site.
  • Se é nome de pessoa, a atividade está clara em fontes externas.

Nome de exibição na Vectalk

Na Vectalk, o nome de exibição é definido durante a conexão do número pelo Cadastro Incorporado da Meta e analisado pela própria Meta. Pela API da Vectalk, você consulta o nome atual com GET /api/phone-numbers?fields=verified_name e faz o novo registro do número após uma alteração aprovada com POST /api/phone-numbers/register, enviando o pin. Os dois usam token de instância, que já identifica o número. Detalhes na documentação de números de telefone.

Se você está começando, veja como conseguir acesso à API do WhatsApp, a explicação da WhatsApp Cloud API e o guia completo da API oficial do WhatsApp. Dúvidas sobre a conta podem ir para a Central de Ajuda.

Perguntas frequentes

Posso usar o número enquanto o nome de exibição está em análise?

O número aparece com o nome no perfil, mas o nome só aparece no topo das conversas e na lista de chats depois da aprovação. Para a análise de uma alteração, o nome antigo continua valendo até a aprovação e o novo registro do número.

Quantas vezes posso trocar o nome de exibição?

Até 10 vezes a cada 30 dias, segundo a documentação da Meta.

Por que meu nome com “Oficial” foi reprovado?

As diretrizes proíbem termos como “Oficial” e “Verificado”, porque sugerem um status de verificação que a empresa pode não ter.

Nome de exibição aprovado é o mesmo que selo verde?

Não. A aprovação do nome faz ele aparecer nas conversas. O selo de conta comercial oficial é outro processo, com critérios próprios.

Uma agência pode usar o nome do cliente?

Pode, desde que a relação entre a agência e o cliente esteja clara no site. Sem isso, a reprovação mais comum é NAME_ENDCLIENT_NOTRELATED.


Fontes oficiais consultadas em 25/10/2026: Nomes de exibição, Diretrizes para nomes de exibição na Plataforma do WhatsApp Business, Sobre o nome de exibição do WhatsApp Business, Webhook phone_number_name_update, Números de telefone, Política de Mensagens Comerciais do WhatsApp, Documentação da Vectalk.

Integre o WhatsApp oficial ao seu sistema

A Vectalk entrega a Cloud API da Meta com os mesmos payloads e webhooks, um token para todas as contas e documentação completa.