Skip to main content
POST
https://api.enviaai.app
/
v1
/
contacts
/
check
Verificar Número
curl --request POST \
  --url https://api.enviaai.app/v1/contacts/check \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instanceId": "<string>",
  "phones": [
    {}
  ]
}
'
{
  "success": true,
  "data": [
    {
      "phone": "5511999999999",
      "exists": true,
      "jid": "[email protected]"
    },
    {
      "phone": "5511988888888",
      "exists": true,
      "jid": "[email protected]"
    },
    {
      "phone": "5511977777777",
      "exists": false,
      "jid": null
    }
  ]
}

​
Request Body

​
instanceId
string
required
ID da instância
​
phones
array
required
Lista de números para verificar (máx 100)

​
Response

​
data[].phone
string
Número verificado
​
data[].exists
boolean
Se está no WhatsApp
​
data[].jid
string
JID do WhatsApp (se existir)

​
Exemplo

const result = await client.contacts.check({
  instanceId: 'inst_abc123',
  phones: [
    '5511999999999',
    '5511988888888',
    '5511977777777'
  ]
});

result.data.forEach(({ phone, exists }) => {
  console.log(`${phone}: ${exists ? '✓ WhatsApp' : '✗ Não encontrado'}`);
});

{
  "success": true,
  "data": [
    {
      "phone": "5511999999999",
      "exists": true,
      "jid": "[email protected]"
    },
    {
      "phone": "5511988888888",
      "exists": true,
      "jid": "[email protected]"
    },
    {
      "phone": "5511977777777",
      "exists": false,
      "jid": null
    }
  ]
}
Use esta verificação antes de enviar mensagens para evitar erros de número inválido.