Validação de WhatsApp

Esta API realiza a validação de números de telefone com identificação de registro no WhatsApp. O sistema consulta em tempo real a disponibilidade do número informado na plataforma, retornando o status de validação do telefone. A resposta fornece dados da consulta, identificação do usuário solicitante e confirmação se o número possui registro ativo no WhatsApp. É uma ferramenta essencial para validação cadastral, enriquecimento de dados, automação de contatos e prevenção a fraudes em processos de onboarding e comunicação digital. <Note> Indicada para enriquecimento de bases de contato, automação de comunicação via WhatsApp, validação de canal de atendimento, prevenção a fraudes em onboarding digital e confirmação de número ativo antes do envio de mensagens. </Note> ## TABELA DE CAMPOS DE REQUISIÇÃO | **Campo** | **Descrição** | **Formato** | **Obrigatório** | |-----------|---------------|-------------|-----------------| | **IdConsulta** | Identificador da consulta. Valor fixo: `627`. | string | Sim | | **Telefone** | Número de telefone no formato `55DDD999999999`. | string | Sim | ## TABELA DE CAMPOS DE RETORNO <AccordionGroup> <Accordion title="Cabeçalho da Resposta — CONSULTA"> | **Campo** | **Descrição** | **Formato** | |:----------|:--------------|:------------| | **CONSULTA.CODIGORESPOSTA** | Código de resposta da consulta. | string | | **CONSULTA.DATAHORA** | Data e hora da consulta. | string | | **CONSULTA.LOGON** | Logon do usuário que realizou a consulta. | string | | **CONSULTA.IDCONSULTA** | ID da consulta realizada. | string | | **RESPOSTA.CODIGO** | Código de status do retorno (`1` = sucesso, `2` = não encontrado, `3` = erro). | string | </Accordion> <Accordion title="💬 Resultado da Validação"> | **Campo** | **Valor** | **Descrição** | |:----------|:----------|:--------------| | **RESPOSTA.VALIDA_WHATSAPP.REGISTRO_1.WHATSAPP** | `TRUE` | O número possui registro ativo no WhatsApp. | | **RESPOSTA.VALIDA_WHATSAPP.REGISTRO_1.WHATSAPP** | `FALSE` | O número não possui registro no WhatsApp. | </Accordion> </AccordionGroup>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

Objeto de consulta com o número de telefone a ser validado no WhatsApp.

ConsultaobjectRequired

Response

Resposta da consulta: * Código `1`: Sucesso. * Código `2`: Dado não encontrado na base de dados. * Código `3`: Erro na consulta.

Errors

400
Bad Request Error
401
Unauthorized Error