Login Cadastre-se

Checar se número possui WhatsApp

Endpoint: GET https://croncrm.com/api/v2/tools/have-whatsapp

Header do request
Atributo Descrição Obrigatório Tipo

apiKey

Informe sua API Key gerada na interface do CRONCRM.

Sim

String
Query do request
Atributo Descrição Obrigatório Tipo

phone

Número no formato internacional.

Sim

String

 
GET /api/v2/tools/have-whatsapp?phone=559999999999
Response do request

Em caso de sucesso, retorna HTTP 200 com success true. Se o número não for encontrado no WhatsApp, ainda retorna HTTP 200 com success true e profile.status 404. Se phone não for informado, retorna 400. Método incorreto retorna 405; falhas inesperadas retornam 500.

Atributo Descrição Tipo

success

Informa se a operação teve sucesso ou não.

Boolean

msg

Mensagem de retorno.

String

profile

Dados retornados da consulta.

Object

profile.status

Status da consulta.

200 = número encontrado no WhatsApp; 404 = número não encontrado.

Integer

profile.wid

Identificador do WhatsApp retornado (WID/JID). Quando existir, pode ser usado como chat_wid em endpoints que exigem um identificador de conversa/contato.

Formatos comuns (o sufixo indica o tipo de conversa):

Boa prática: use o profile.wid exatamente como retornado (não tente “converter” para telefone).

String|null

profile.wuser

Parte do identificador antes do @ (quando disponível).

String|null

profile.wserver

Parte do identificador depois do @ (ex.: c.us).

String|null

profile.wbusiness

Indica se é conta comercial.

Boolean

 
Exemplo (número encontrado no WhatsApp)
{
  "success": true,
  "msg": "Consulta realizada com sucesso.",
  "profile": {
    "status": 200,
    "wid": "[email protected]",
    "wserver": "c.us",
    "wuser": "559999999999",
    "wbusiness": false
  }
}

Exemplo (número NÃO encontrado no WhatsApp)
{
  "success": true,
  "msg": "Consulta realizada com sucesso.",
  "profile": {
    "status": 404,
    "wid": null,
    "wserver": null,
    "wuser": null,
    "wbusiness": false
  }
}
 
<?php
$apiKey = 'SEU_API_KEY';
$baseUrl = 'https://croncrm.com/api/v2/tools/have-whatsapp';

$query = [
    'phone' => '559999999999',
];

$url = $baseUrl . '?' . http_build_query($query);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'apiKey: ' . $apiKey,
    ],
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);

if ($error) {
    throw new RuntimeException($error);
}

echo "HTTP {$httpCode}\n";
echo $response;
?>
curl -G \
  'https://croncrm.com/api/v2/tools/have-whatsapp' \
  -H 'apiKey: SEU_API_KEY' \
  --data-urlencode 'phone=559999999999'