Gerenciar números de telefone e certificados
Este guia fornece informações gerais sobre números de telefone para parceiros de soluções e clientes. Além disso, ele contém dados sobre processos caso os parceiros de soluções precisem gerenciar números de telefone e certificados de um cliente.
Informações preliminares sobre números de telefone
Há alguns detalhes a respeito de números de telefone e do Cadastro Incorporado que as empresam precisam saber.
Além disso, elas precisam ter um número exclusivo para usar o WhatsApp pelo cadastro incorporado. Se uma empresa tiver um número ativo registrado no WhatsApp Messenger ou no app WhatsApp Business, outro número deverá ser usado.
As empresas podem ter vários números de telefone associados à conta empresarial da Meta. Para isso, basta adicionar outro número e usá-lo no WhatsApp.
Não é possível se cadastrar usando o fluxo de cadastro incorporado com um número de telefone já registrado nas versões do WhatsApp para empresas ou para consumidores.
Para obter informações mais detalhadas sobre os números de telefone e a Plataforma do WhatsApp Business, consulte Números de telefone.
Para obter informações sobre como migrar um número já registrado no WhatsApp, consulte Migrar número de telefone.
Instruções para clientes
Esta seção destina-se a clientes do Cadastro Incorporado e fornece instruções sobre ações relacionadas a números de telefone.
Adicionar números de telefone a uma conta empresarial do WhatsApp
Há duas formas de adicionar números de telefone a uma WABA (conta empresarial do WhatsApp):
- [Recomendado] Passe pelo fluxo de cadastro incorporado, selecione o Gerenciador de Negócios e a WABA, adicione o número e verifique-o.
- No Gerenciador de Negócios, acesse a aba Números de telefone no Gerenciador do WhatsApp. Depois, selecione Adicionar número de telefone. Ao usar essa opção, o parceiro de soluções precisa verificar manualmente o número, pois esse recurso não está disponível no Gerenciador de Negócios. Por isso, recomendamos que as empresas sigam o fluxo cadastro incorporado para adicionar números.
Instruções para parceiros de soluções
Esta seção destina-se a parceiros de soluções e fornece instruções sobre o gerenciamento de números de telefone e certificados de clientes.
Registrar números de telefone para a API de Nuvem
Após concluir a verificação do fluxo de cadastro incorporado, o registro é concluído com uma chamada de API ao ponto de extremidade register. Para isso, forneça um code_method (sms | voice). Como o número de telefone já foi verificado, não é preciso se preocupar com o código de registro. A chamada de API verify não é necessária.
Como alternativa, é possível pré-verificar os números de telefone e oferecê-los aos clientes no novo fluxo de Cadastro Incorporado. Assim, eles não precisam entrar em contato com você para obter uma senha descartável durante o processo de integração. Consulte Números de telefone pré-verificados.
Registrar números de telefone na API Local
Após concluir a verificação do fluxo de cadastro incorporado, o registro é concluído com uma chamada de API ao ponto de extremidade account. Para isso, forneça um code_method (sms | voice). Como o número de telefone já foi verificado, não é preciso se preocupar com o código de registro. A chamada de API verify não é necessária.
Como alternativa, é possível pré-verificar os números de telefone e oferecê-los aos clientes no novo fluxo de Cadastro Incorporado. Assim, eles não precisam entrar em contato com você para obter uma senha descartável durante o processo de integração. Consulte Números de telefone pré-verificados.
É necessário cadastrar um número de telefone até 14 dias após o fluxo de cadastro incorporado. Se o número não for cadastrado nesse período, será preciso realizar o fluxo novamente antes de poder cadastrá-lo.
Obter o certificado e o status do número de telefone
O ponto de extremidade phone_numbers permite que você veja o status do nome de exibição de um número de telefone e recupere o certificado depois de alterar o nome. Para mais informações, consulte Ler números de telefone.
Exemplo de solicitação
No exemplo abaixo, use a identificação da WABA atribuída.
curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
?fields=
display_phone_number,
certificate,
name_status,
new_certificate,
new_name_status
&access_token={system-user-access-token}"Exemplo de resposta
{
"data": [
{
"id": "1972385232742141",
"display_phone_number": "+1 631-555-1111",
"last_onboarded_time": "2023-08-22T19:05:53+0000",
"certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
"new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
"name_status": "APPROVED",
"new_name_status": "APPROVED",
}
]
}
Parâmetros de resposta
| Nome | Descrição |
|---|---|
| O status de análise da atual solicitação de nome de exibição. Clique na seta da coluna à esquerda para ver as opções disponíveis. |
| O status da análise de uma solicitação de alteração do nome de exibição. Este campo retorna dados apenas se houver uma solicitação de alteração do nome de exibição. |
| Retorna o certificado atual do número de telefone. |
| O certificado de um novo nome de exibição, depois que a alteração foi aprovada. Este campo retorna dados apenas se a solicitação de alteração do nome de exibição tiver sido aprovada e ficará disponível até que o número de telefone tenha sido registrado com o novo certificado. |
Obtenha o status OTP do telefone
Para ver se um número de telefone foi verificado via OTP (senha descartável), confira o campo code_verification_status desse número. Primeiro, faça uma chamada GET para o ponto de extremidade /{whatsapp-business-account-id}/phone_numbers:
curl -i -X GET \
"https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
?access_token={your-access-token}"
A resposta inclui o code_verification_status com uma das opções a seguir: VERIFIED ou NOT_VERIFIED. Um exemplo de resposta é semelhante a:
[
{
"code_verification_status": "NOT_VERIFIED",
"id": "1754951608042154"
}
]
Como alternativa, obtenha o status fazendo uma chamada ao ID de um número de telefone:
curl -i -X GET \
"https://graph.facebook.com/v21.0/{phone-number-id}
?access_token={your-access-token}"
https://graph.facebook.com/v21.0/{whatsapp-business-account-ID}/phone_numbers. Substitua {whatsapp-business-account-ID} pela ID da conta do WhatsApp Business à qual o número de telefone pertence. Confira Obter todos os números de telefone para ver um exemplo.
Filtrar números de telefone pelo modo da conta
Consulte e filtre números de telefone com base em account_mode. Para a solicitação, use os parâmetros abaixo.
Parâmetros de solicitação
| Nome | Descrição |
|---|---|
| Contém o campo que está sendo usado para filtragem. Nesse exemplo, use |
| Contém o modo que você quer usar para filtrar as contas. Nesse exemplo, use |
| Contém o modo da conta que você está procurando. Clique na seta da coluna esquerda para ver os valores compatíveis. |
Exemplo de solicitação
No exemplo abaixo, use a identificação da WABA atribuída.
curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
?filtering=[{
"field":"account_mode",
"operator":"EQUAL",
"value":"SANDBOX"}]
&access_token={system-user-access-token}"
Exemplo de resposta
{
"data": [
{
"id": "1972385232742141",
"display_phone_number": "+1 631-555-1111",
"verified_name": "John’s Cake Shop",
"quality_rating": "UNKNOWN",
}
],
"paging": {
"cursors": {
"before": "abcdefghij"
"after": "klmnopqr"
}
}
}