Robbu Verify

O Robbu Verify é uma API que permite validar se um número de telefone está ativo no WhatsApp antes de iniciar qualquer interação.
Essa verificação aumenta a assertividade das comunicações, evita tentativas de envio para números inválidos e contribui para a eficiência das integrações.
Para utilizar o serviço, é necessário solicitar a habilitação junto à equipe comercial da Robbu.

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: [phone] 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.

Obteção de Tokens

Token Privado

Para consumir esta API, é necessário possuir o token privado da conta configurada no Invenio. Esse token pode ser localizado ao final da página de configurações da conta dentro do Invenio Center.

Para localizar as configurações da conta, siga o caminho:

Invenio Center → Configurações → Conta

Clique para acessar as Configurações da Conta

Authorization

Além do token privado, é obrigatória a inclusão de um token de autorização nas requisições.

Esse token de autorização deve ser obtido por meio da API de login e enviado no header da requisição para validação de acesso.

Abaixo estão as instruções para geração do token.

Endpoint de Login

Para gerar o token de autorização, realize a autenticação conforme o exemplo abaixo:

Método: POST URL: https://api.robbu.global/v1/login

Body

{
    "Company": "#####",
    "Username": "#####",
    "Password": "#####"
}

Parâmetros da Requisição

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Company	string	Sim	Nome da empresa no ambiente Invenio.	Robbu
Username	string	Sim	Nome de usuário para autenticação.	usuario_teste
Password	string	Sim	Senha associada ao usuário.	senha_secreta

Modelo de Requisição

Headers

PrivateToken · string · required

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Authentication · string · required

Bearer TOKEN

Body

PhoneNumbers · array · required

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. | ["[phone]", "[phone]"]

Exemplo

Curl

curl --location 'https://api.robbu.global/v1/verify' \
--header 'Content-Type: application/json' \
--header 'PrivateToken: teste' \
--header 'Authorization: Bearer TOKEN' \
--data '{
    "PhoneNumbers": [
        "14128880043",
        "56971332420",
        "17077878069",
        "18176475163",
        "50431999232",
        "51941700660",
        "18057965469",
        "18402846702",
        "15097929172"
    ]
}

request.json

{
    "PhoneNumbers": [
        "[phone]",
        "5511941709999",
        "11941709999",
        "941709999",
        "11999999999"
    ]
}

Modelo de Resposta

response.json

{
    "numbersVerified": [
        {
            "exists": true,
            "jid": "[e-mail]",
            "name": "Mauricio da Silva",
            "number": "[phone]"
        },
        {
            "exists": true,
            "jid": "[e-mail]",
            "name": "Joao Teste",
            "number": "5511941709999"
        },
        {
            "exists": false,
            "jid": "[e-mail]",
            "number": "11941709999"
        },
        {
            "exists": false,
            "jid": "[e-mail]",
            "number": "941709999"
        },
        {
            "exists": false,
            "jid": "[e-mail]",
            "number": "11999999999"
        }
    ]
}

Parâmetro	Tipo	Descrição	Exemplo
numbersVerified	array	Lista de números verificados contendo os detalhes de cada número enviado.	Ver descrição abaixo
numbersVerified[].exists	boolean	Indica se o número está ativo no WhatsApp.	true ou false
numbersVerified[].jid	string	Identificador do número no WhatsApp no formato JID (Jabber ID).	"[e-mail]"
numbersVerified[].name	string	Nome associado ao número no WhatsApp (caso exista).	"Usuario Teste"
numbersVerified[].number	string	Número de telefone no formato enviado.	"[phone]"

HTTP Status Codes

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

⁉️ Perguntas Frequentes (FAQ)

O que é o Robbu Verify?

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.

Como posso habilitar o Robbu Verify na minha conta?

Você precisa entrar em contato com o seu Gerente de Contas da Robbu para ativar o serviço na sua conta.

Existe algum custo para usar o Robbu Verify?

Entre em contato com a equipe comercial da Robbu para detalhes sobre custos e planos disponíveis.