Como verificar se um número usa o WhatsApp Business

Aprenda a verificar se um número de telefone usa o WhatsApp Business por meio de consultas em tempo real e em lote para apoiar fluxos de trabalho de comunicação e segmentação de público.

Para verificar se um número de telefone usa o WhatsApp Business, as organizações enviam o número em formato internacional para um serviço de verificação que suporte a detecção de perfil comercial. A verificação avalia o número no momento da solicitação, confirmando se uma conta está presente no WhatsApp e se ela está configurada como uma conta comercial. Esse sinal de presença de conta fornece contexto para fluxos de trabalho de comunicação, distinguindo contas comerciais de perfis pessoais padrão, sem verificar a identidade jurídica corporativa ou conceder permissão de mensagens.

Entendendo os sinais de conta WhatsApp Business

Uma verificação de conta WhatsApp Business confirma se um identificador está registrado no WhatsApp e se o perfil registrado está configurado como uma conta comercial.

Sinais de conta documentados

Ao avaliar números de telefone, os sistemas de verificação distinguem o registro padrão na plataforma de metadados de perfil específicos para empresas:

• Verificação de registro no WhatsApp (ws): Avalia se uma conta existe no WhatsApp para o número enviado no momento da verificação.
• Verificação de foto de perfil do WhatsApp (ws_avatar): Confirma a presença da conta e informa a disponibilidade da foto de perfil, juntamente com a URL do avatar, quando presente.
• Verificação de conta WhatsApp Business (ws_business): Retorna o sinal de presença da conta e indica se ela opera como um perfil WhatsApp Business.

Essas verificações fornecem sinais técnicos de presença de conta no momento da consulta.

Fluxo de trabalho de verificação em tempo real para identificadores únicos

A verificação em tempo real avalia números de telefone individuais ou pequenos lotes de forma síncrona. Essa configuração funciona bem para roteamento de leads recebidos, consultas em centrais de atendimento e validações imediatas de formulários.

Fluxo de solicitação única e de pequenos lotes

1. Formate o número: Padronize o identificador usando o formato internacional de telecomunicações públicas definido pela ITU-T Recommendation E.164, prefixando o número com seu código de país até um máximo de 15 dígitos.
2. Selecione o tipo de serviço: Especifique o serviço de verificação comercial (ws_business) para recuperar tanto o registro na plataforma quanto o status do perfil comercial.
3. Inicie a solicitação: Envie o identificador pelo painel da Web ou via POST /api/v1/check usando uma chave de API autorizada.
4. Avalie a resposta direta: O sistema entrega o resultado na resposta inicial. Uma verificação concluída retorna o status de registro e o sinalizador comercial.

Para requisitos de múltiplos números em pequena escala, o endpoint de lote síncrono (POST /api/v1/batch-check) aceita até 100 números por solicitação, retornando todos os resultados na mesma resposta. Alternativamente, a interface do painel da Web acomoda até 500 números colados para revisão instantânea.

Processamento assíncrono para listas em massa

Quando as organizações gerenciam grandes conjuntos de dados para segmentação de público ou higiene de banco de dados, as tarefas assíncronas em massa fornecem um manuseio estruturado de arquivos.

Fluxo de trabalho de envio de tarefas em massa

1. Prepare o arquivo de dados: Estruture o arquivo em formato TXT ou CSV com um identificador por linha. Arquivos em massa devem representar um único país. A validação de pré-verificação rejeita arquivos onde 10% ou mais dos identificadores pertencem a outros países.
2. Faça o upload do arquivo: Envie o conjunto de dados usando o serviço de massa comercial assíncrono (ws_business_batch) pelo painel da Web ou chamando POST /api/v1/bulk-tasks. Aplicam-se limites de volume por produto, que as equipes podem revisar na documentação atual da API.
3. Monitore o progresso: O envio inicial retorna um identificador de tarefa exclusivo. Os sistemas monitoram o progresso da tarefa via GET /api/v1/bulk-tasks/{id}.
4. Baixe os resultados concluídos: Uma vez processada, a plataforma gera um CSV para download contendo os indicadores de presença de conta e perfil comercial para cada linha enviada.

O processamento em massa opera sob limites geográficos específicos. Verificações de número único em tempo real suportam pequenos volumes na China continental (+86), Hong Kong (+852) e Macau (+853), mas as tarefas de arquivo em massa não suportam essas três regiões.

Configuração de conta e limites de conformidade

Integrar verificações de conta comercial ao roteamento operacional requer uma compreensão clara do comportamento de faturamento e da conformidade de mensagens.

Alocação e reconciliação de saldo

Tanto as verificações concluídas de números registrados quanto as de não registrados consomem saldo da conta. Para tarefas assíncronas em massa, a plataforma reserva o saldo da conta no envio do arquivo com base no número de registros enviados. Após a conclusão da tarefa, qualquer saldo reservado não utilizado retorna automaticamente para o saldo da conta. Se uma tarefa em massa falhar no processamento, todo o saldo reservado é liberado.

Considerações sobre regulamentação e política de mensagens

Um sinalizador de conta comercial confirma como uma conta está configurada na plataforma, mas traz limites operacionais:

• Consentimento de mensagens: A verificação não satisfaz os requisitos regulatórios ou de consentimento da plataforma. Sob a WhatsApp Business Messaging Policy, as organizações devem obter permissão clara de opt-in antes de entrar em contato com qualquer usuário.
• Minimização de dados: Sob o Artigo 5(1)(c) do GDPR, o processamento de dados pessoais deve permanecer adequado, relevante e limitado ao que é necessário para objetivos operacionais específicos.

Compreender esses limites garante que as organizações usem dados de presença de conta para informar o roteamento de fluxos de trabalho internos, mantendo a conformidade regulatória.

FAQ

Uma verificação de conta WhatsApp Business verifica o status legal de uma empresa?

Não. A verificação retorna um sinal de presença de conta e perfil específico da plataforma, indicando se a conta usa o WhatsApp Business no momento da consulta.

As equipes podem verificar números de telefone de qualquer país quanto ao status de conta comercial?

Verificações únicas em tempo real suportam números globais, incluindo China continental (+86), Hong Kong (+852) e Macau (+853) para pequenos volumes, embora a cobertura em Taiwan não esteja confirmada. O processamento de arquivos em massa não suporta números da China continental, Hong Kong ou Macau.

Qual é a diferença operacional entre uma verificação em tempo real e uma tarefa em massa?

Uma verificação em tempo real opera de forma síncrona, retornando o sinal de registro e comercial diretamente na resposta inicial. Uma tarefa em massa processa um arquivo de forma assíncrona, retornando um ID de tarefa após o envio e fornecendo um CSV de resultados para download assim que o processamento for concluído.

Identificar uma conta WhatsApp Business concede permissão para enviar mensagens ao destinatário?

Não. Identificar um tipo de conta fornece um sinal de alcance, mas não satisfaz o consentimento de mensagens. Sob a WhatsApp Business Messaging Policy, as empresas devem coletar permissão direta de opt-in antes de iniciar o contato.

Saiba mais

Escolha as informações do produto que se encaixam na próxima etapa do seu fluxo de trabalho.

• Veja a documentação do produto →
• Fale com a equipe →