Skip to main content
GET
/
api
/
contacts
/
check-exists
Verificar se o número de telefone está registrado no WhatsApp
curl --request GET \
  --url https://{host}/api/contacts/check-exists \
  --header 'apikey: <api-key>'
{
  "exists": true,
  "jid": "5511999999999@s.whatsapp.net",
  "isInWhatsapp": true
}

​
Descrição

Este endpoint verifica se um número de telefone específico está registrado e ativo no WhatsApp. Útil para validar números antes de enviar mensagens.

​
Query Parameters

​
sessionId
string
required
ID da sessão autenticada
​
phone
string
required
Número de telefone a ser verificado (formato internacional, apenas números). Exemplo: 5511999999999
{
  "exists": true,
  "jid": "5511999999999@s.whatsapp.net",
  "isInWhatsapp": true
}

​
Códigos de Status

  • 200 - Verificação realizada com sucesso
  • 400 - Parâmetros inválidos
  • 401 - Sessão não autorizada
  • 404 - Sessão não encontrada

​
Exemplo de Uso

curl -X GET "https://api.wappfy.com.br/api/contacts/check-exists?sessionId=my-session&phone=5511999999999"

Authorizations

​
apikey
string
header
required

Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)

Query Parameters

​
phone
string
required

O número de telefone para verificar

Response

200 - application/json
​
numberExists
boolean
required
​
chatId
string
Example:

"Chat id for the phone number. Undefined if the number does not exist"