É preciso fornecer um nome de exibição ao registrar um número de telefone comercial. O nome de exibição aparece no perfil do WhatsApp do seu número de telefone comercial:

Esse nome também poderá aparecer no topo de conversas individuais e da lista de conversas se o número de telefone comercial for aprovado por meio da verificação de nome de exibição. Observe que, se um usuário editar seu nome de perfil no cliente do WhatsApp, o nome definido por ele será exibido em vez do seu.

Diretrizes para nomes de exibição

Consulte nosso artigo da Central de Ajuda Diretrizes para nomes de exibição na Plataforma do WhatsApp Business⁠ para saber mais sobre a nomenclatura.

Verificação do nome de exibição

Quando você atinge um limite de mensagens superior, o nome de exibição do seu número de telefone comercial será automaticamente submetido à verificação com base nas diretrizes para nomes de exibição⁠. Ao final do processo, um webhook phone_number_name_update e uma notificação do Meta Business Suite são disparados.

Caso seu nome de exibição seja aprovado, o webhook terá decision definido como APPROVED e o campo name_status no seu número de telefone comercial será definido como APPROVED.

Se o nome de exibição for rejeitado, o webhook terá decision definido como REJECTED e o campo name_status no seu número de telefone comercial será definido como DECLINED. Leia as diretrizes para nomes de exibição⁠ e edite o nome de exibição⁠ se necessário ou faça uma apelação via Suporte ao desenvolvedor ou Suporte para desenvolvedores empresariais.

Ver o nome de exibição no Gerenciador do WhatsApp

O nome de exibição do seu número de telefone comercial é exibido na coluna Nome no painel Gerenciador do WhatsApp⁠ > Ferramentas da conta > Números de telefone.

Receber o nome de exibição e o status do nome via API

Solicite os campos verified_name e name_status na identificação do seu número de telefone comercial do WhatsApp para receber o nome de exibição e o status dele. Para conferir uma lista de valores retornáveis e os respectivos significados, consulte a referência GET /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>.

O valor verified_name não indica se o nome de exibição foi aprovado. Ele representa a string do nome de exibição que passa pela verificação quando qualificado. O campo name_status indica o status de aprovação.

Exemplo de pedido

curl 'https://graph.facebook.com/v25.0/106540352242922?fields=verified_name%2Cname_status' \
-H 'Authorization: Bearer EAAJB...'

Exemplo de resposta

Caso o pedido seja bem-sucedido:

{
  "verified_name": "Lucky Shrub",
  "name_status": "APPROVED",
  "id": "106540352242922"
}

Atualizar nomes de exibição

Você pode alterar o nome de exibição dez vezes a cada período de 30 dias. Após a aprovação da alteração do nome de exibição, você terá 14 dias para registrar novamente o número de telefone. Se o prazo de 14 dias expirar sem o registro ser renovado, será necessário enviar novamente o nome de exibição para análise.

Observação: caso seu número de telefone comercial tenha o status de Conta comercial oficial, entre em contato com o Suporte Direto para alterar o nome de exibição.

Atualizar o nome de exibição via Gerenciador do WhatsApp

Para atualizar seu nome de exibição via Gerenciador do WhatsApp:

Acesse Gerenciador do WhatsApp⁠ > Ferramentas da conta > Números de telefone.

Selecione o número de telefone da empresa.

Clique na aba Perfil.

Na seção Nome de exibição, clique no botão Editar e complete o fluxo.

Após concluir o fluxo, seu nome de exibição passará pelo processo de verificação novamente. Após a aprovação do nome de exibição, registre novamente o número de telefone. Não terá efeito se você fizer um novo registro antes da aprovação.

Essas informações também estão disponíveis no artigo da Central de Ajuda Como alterar seu nome de exibição no WhatsApp Business⁠.

Atualizar o nome de exibição via API

Use o campo new_display_name do ponto de extremidade <WHATSAPP_BUSINESS_PHONE_NUMBER_ID>POST / para atualizar seu nome de exibição via API.

Exemplo de pedido

curl -X POST 'https://graph.facebook.com/v25.0/106540352242922?new_display_name=Lucky%20Shrub' \
-H 'Authorization: Bearer EAAJB...'

Exemplo de resposta

Em caso de sucesso:

{
  "success": true
}

Em caso de sucesso, seu nome de exibição passará pelo processo de verificação. Para conferir o status da verificação, solicite os campos new_display_name e new_name_status na identificação do seu número de telefone comercial:

Exemplo de pedido

curl 'https://graph.facebook.com/v25.0/106540352242922?fields=new_display_name,new_name_status' \
-H 'Authorization: Bearer EAAJB...'

Exemplo de resposta

Em caso de sucesso:

{
  "new_display_name": "New Lucky Shrub",
  "new_name_status": "PENDING_REVIEW",
  "id": "106540352242922"
}

Quando o nome de exibição atualizado for aprovado, os campos verified_name e name_status do número de telefone comercial serão atualizados para refletir o novo nome e o respectivo status de exibição. Além disso, os webhooks phone_number_name_update serão disparados. Depois, será preciso registrar novamente o número de telefone. Não terá efeito se você fizer um novo registro antes da aprovação.

Fazer novo registro após a aprovação do nome de exibição

Depois de atualizar o nome de exibição por meio do Gerenciador do WhatsApp ou da API, você deverá registrar novamente seu número de telefone para solidificar o novo nome nos servidores do WhatsApp.

Aguarde o webhook phone_number_name_update com decision definido como APPROVED.

Ligue para POST /<PHONE_NUMBER_ID>/register a fim de registrar novamente o número de telefone. Confira Registrar um número de telefone comercial para ver detalhes sobre o ponto de extremidade.

Importante: aguarde a aprovação da alteração do nome de exibição antes de fazer o registro novamente. Não terá efeito se você fizer um novo registro antes da aprovação.

Você pode fazer o registro novamente de forma programática por meio da API. Não é necessário enviar a empresa pelo cadastro incorporado outra vez.

Exemplo de pedido

curl 'https://graph.facebook.com/v25.0/106540352242922/register' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "pin": "212834"
}'

Exemplo de resposta

Em caso de sucesso:

{
  "success": true
}

Saiba mais

Os artigos a seguir da Central de Ajuda fornecem mais informações sobre nomes de exibição.

Sobre o nome de exibição do WhatsApp Business⁠

Como alterar o nome de exibição no WhatsApp Business⁠

Você achou esta página útil?