curl -X POST "https://api.oxenty.api.br/api/contacts/check" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "550e8400-e29b-41d4-a716-446655440000",
"numbers": ["5511999999999", "5511888888888", "5511777777777"]
}'
const results = await client.contacts.check(sessionId, {
numbers: ['5511999999999', '5511888888888', '5511777777777'],
});
for (const result of results) {
if (result.exists) {
console.log(`${result.number} está no WhatsApp: ${result.jid}`);
} else {
console.log(`${result.number} não está no WhatsApp`);
}
}
results = client.contacts.check(
session_id,
numbers=['5511999999999', '5511888888888', '5511777777777']
)
for result in results['results']:
if result['exists']:
print(f"{result['number']} está no WhatsApp: {result['jid']}")
else:
print(f"{result['number']} não está no WhatsApp")
{
"success": true,
"results": [
{
"number": "5511999999999",
"exists": true,
"jid": "5511999999999@s.whatsapp.net"
},
{
"number": "5511888888888",
"exists": true,
"jid": "5511888888888@s.whatsapp.net"
},
{
"number": "5511777777777",
"exists": false,
"jid": null
}
]
}
Contatos
Verificar Números
Verifica se números estão registrados no WhatsApp
POST
/
api
/
contacts
/
check
curl -X POST "https://api.oxenty.api.br/api/contacts/check" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "550e8400-e29b-41d4-a716-446655440000",
"numbers": ["5511999999999", "5511888888888", "5511777777777"]
}'
const results = await client.contacts.check(sessionId, {
numbers: ['5511999999999', '5511888888888', '5511777777777'],
});
for (const result of results) {
if (result.exists) {
console.log(`${result.number} está no WhatsApp: ${result.jid}`);
} else {
console.log(`${result.number} não está no WhatsApp`);
}
}
results = client.contacts.check(
session_id,
numbers=['5511999999999', '5511888888888', '5511777777777']
)
for result in results['results']:
if result['exists']:
print(f"{result['number']} está no WhatsApp: {result['jid']}")
else:
print(f"{result['number']} não está no WhatsApp")
{
"success": true,
"results": [
{
"number": "5511999999999",
"exists": true,
"jid": "5511999999999@s.whatsapp.net"
},
{
"number": "5511888888888",
"exists": true,
"jid": "5511888888888@s.whatsapp.net"
},
{
"number": "5511777777777",
"exists": false,
"jid": null
}
]
}
Verifica uma lista de números de telefone para identificar quais estão registrados no WhatsApp.
Este endpoint possui rate limit específico de 10 requisições/minuto devido a limitações do WhatsApp.
Request Body
string
required
ID da sessão.
string[]
required
Lista de números para verificar (com DDI).Máximo: 50 números por requisiçãoExemplo:
["5511999999999", "5511888888888"]Resposta
boolean
Se a operação foi bem-sucedida.
array
curl -X POST "https://api.oxenty.api.br/api/contacts/check" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "550e8400-e29b-41d4-a716-446655440000",
"numbers": ["5511999999999", "5511888888888", "5511777777777"]
}'
const results = await client.contacts.check(sessionId, {
numbers: ['5511999999999', '5511888888888', '5511777777777'],
});
for (const result of results) {
if (result.exists) {
console.log(`${result.number} está no WhatsApp: ${result.jid}`);
} else {
console.log(`${result.number} não está no WhatsApp`);
}
}
results = client.contacts.check(
session_id,
numbers=['5511999999999', '5511888888888', '5511777777777']
)
for result in results['results']:
if result['exists']:
print(f"{result['number']} está no WhatsApp: {result['jid']}")
else:
print(f"{result['number']} não está no WhatsApp")
{
"success": true,
"results": [
{
"number": "5511999999999",
"exists": true,
"jid": "5511999999999@s.whatsapp.net"
},
{
"number": "5511888888888",
"exists": true,
"jid": "5511888888888@s.whatsapp.net"
},
{
"number": "5511777777777",
"exists": false,
"jid": null
}
]
}
Boas Práticas
Use verificação em lote
Use verificação em lote
Envie múltiplos números em uma única requisição ao invés de verificar um por um.
Cache os resultados
Cache os resultados
Os resultados raramente mudam. Cache por pelo menos 24 horas para evitar verificações repetidas.
Respeite o rate limit
Respeite o rate limit
10 requisições/minuto é o limite para evitar bloqueios do WhatsApp.