Pular para o conteúdo principal

​
Introdução

O serviço Robbu Verify API oferece a funcionalidade de verificar se um número de telefone está ativo no WhatsApp, tornando-se uma solução essencial para sistemas que exigem a validação da presença no WhatsApp antes de realizar qualquer interação com o usuário. Para utilizar este serviço, é necessário entrar em contato com a equipe comercial da Robbu para habilitá-lo na sua conta.

​
Integração

Para usar a API, você deve realizar uma requisição POST para o endpoint /verify, enviando um array de números de telefone no corpo da requisição.

​
Regras para os números de telefone

  • Os números devem ser enviados no formato DDI + Número de Telefone.
    • Exemplo: +5511999999999 para um número no Brasil.
  • O array pode conter até 1000 números por chamada.
  • Todos os números devem ser únicos, ou seja, não podem haver repetições no mesmo array.

​
Regras de concorrência

  • Não é permitido realizar chamadas simultâneas para este endpoint utilizando o mesmo PrivateToken.
  • Se uma requisição estiver em andamento para um determinado PrivateToken e outra requisição for feita antes da conclusão da primeira, a segunda será bloqueada e retornará o seguinte status HTTP
423 Locked

​
Base Url

https://api.robbu.global/v1/verify

​
Autenticação

Para acessar os endpoints da API da Robbu, você precisa autenticar suas requisições utilizando dois tipos de token:
  1. PrivateToken: Um token de acesso privado fornecido pela Robbu.
  2. Authorization: Um token no formato Bearer que valida sua identidade.
Ambos os tokens devem ser incluídos como cabeçalhos na requisição HTTP.
Clique aqui para obter o Private Token do seu ambiente.

​
Modelo de Requisição

Headers
​
PrivateToken
string
obrigatório
29d08afc-a349-42b8-995a-562242999
​
Authentication
string
obrigatório
Bearer MEU_TOKEN
Body
​
PhoneNumbers
array
obrigatório
Lista de números de telefone para validação. Deve conter no máximo 1000 números, todos no formato DDI + Número e sem repetições. | ["+5511941709999", "+5511999999999"]
Exemplo
curl --location 'https://api.robbu.global/v1/verify' \
--header 'Content-Type: application/json' \
--header 'PrivateToken: teste' \
--header 'Authorization: Bearer MEU_TOKEN' \
--data '{
    "PhoneNumbers": [
        "14128880043",
        "56971332420",
        "17077878069",
        "18176475163",
        "50431999232",
        "51941700660",
        "18057965469",
        "18402846702",
        "15097929172"
    ]
}
request.json
{
    "PhoneNumbers": [
        "+5511941709999",
        "5511941709999",
        "11941709999",
        "941709999",
        "11999999999"
    ]
}

​
Modelo de Resposta

response.json
{
    "numbersVerified": [
        {
            "exists": true,
            "jid": "[email protected]",
            "name": "Mauricio da Silva",
            "number": "+5511941709999"
        },
        {
            "exists": true,
            "jid": "[email protected]",
            "name": "Joao Teste",
            "number": "5511941709999"
        },
        {
            "exists": false,
            "jid": "[email protected]",
            "number": "11941709999"
        },
        {
            "exists": false,
            "jid": "[email protected]",
            "number": "941709999"
        },
        {
            "exists": false,
            "jid": "[email protected]",
            "number": "11999999999"
        }
    ]
}
ParâmetroTipoDescriçãoExemplo
numbersVerifiedarrayLista de números verificados contendo os detalhes de cada número enviado.Ver descrição abaixo
numbersVerified[].existsbooleanIndica se o número está ativo no WhatsApp.true ou false
numbersVerified[].jidstringIdentificador do número no WhatsApp no formato JID (Jabber ID)."[email protected]"
numbersVerified[].namestringNome associado ao número no WhatsApp (caso exista)."Usuario Teste"
numbersVerified[].numberstringNúmero de telefone no formato enviado."+5511941709999"

​
HTTP Status Codes

StatusDescrição
200Sucesso. A requisição foi processada corretamente.
400Erro no request. Verifique os parâmetros enviados na requisição.
401Não autorizado. O token de autenticação é inválido ou está ausente.
403Sem permissão. O cliente não possui autorização para acessar este recurso.
423Não é permitido realizar chamadas simultâneas para este endpoint utilizando o mesmo PrivateToken.
500Erro interno. Entre em contato com o suporte.

​
⁉️ Perguntas Frequentes (FAQ)

O Robbu Verify é um serviço que permite verificar se um número de telefone está ativo no WhatsApp, ideal para sistemas que precisam confirmar a presença no WhatsApp antes de interagir com o usuário.
Você precisa entrar em contato com o seu Gerente de Contas da Robbu para ativar o serviço na sua conta.
Entre em contato com a equipe comercial da Robbu para detalhes sobre custos e planos disponíveis.

​
Consulte se um número tem WhatsApp