Primeiros passos — conectar e credenciais
Conecte seu número de WhatsApp lendo o QR Code no painel da Rollin Host e descubra onde ficam sua URL base, token e nome da instância.
Em ~3 minutos você conecta seu número e fica com tudo o que precisa pra usar a API. Não precisa instalar nada.
Passo 1 — abrir o painel da sua instância
-
Entre em painel.rollinhost.com.br com seu login.
-
Vá em Meus serviços e clique no serviço WhatsApp API.
-
Clique no botão Gerenciar. É aqui que você conecta o número e vê suas credenciais.
Passo 2 — conectar seu número (QR Code)
-
No painel, clique em Conectar número. Um QR Code vai aparecer.
-
No celular com o número que você vai usar, abra o WhatsApp.
-
Toque em Aparelhos conectados → Conectar um aparelho (Android: três pontinhos no canto; iPhone: Configurações).
-
Aponte a câmera para o QR Code do painel.
-
Em alguns segundos aparece “WhatsApp conectado!”. Pronto — seu número está ativo na API.
Passo 3 — copiar suas credenciais
Ainda na tela Gerenciar, na seção Dados da API, você encontra as 3 informações que vai usar em toda integração:
| Campo | Para que serve | Exemplo |
|---|---|---|
| URL base | endereço da API | https://rollin.uazapi.com |
| Token | sua chave secreta (vai no header token) | a1b2c3d4-... (clique no olho 👁 para ver) |
| Nome da instância | identifica seu número (pode personalizar) | meu-atendimento |
Passo 4 — testar (enviar uma mensagem de teste)
Com a URL base e o token em mãos, esse comando manda um “Olá” para um número. Troque SEU_TOKEN e o número de destino:
curl -X POST https://rollin.uazapi.com/send/text \
-H "Content-Type: application/json" \
-H "token: SEU_TOKEN" \
-d '{
"number": "5511999999999",
"text": "Olá! Mensagem de teste pela WhatsApp API da Rollin."
}'Sem saber usar terminal? Vá direto para os guias visuais:
Eles fazem exatamente esse envio, clicando em botões.
Se chegar a mensagem no destino, está tudo certo. 🎉
Problemas comuns
| Sintoma | Causa provável | Solução |
|---|---|---|
| QR não conecta | demorou e expirou | clique em Gerar novo QR |
| Conecta e cai depois | mesmo número aberto no WhatsApp Web do PC | feche o WhatsApp Web; use número dedicado |
| Envio retorna erro de número | formato errado | use 5511999999999 (sem +/espaços) |
| Erro de autenticação (401) | token errado/copiado pela metade | copie de novo pelo botão de cópia |
| Mensagem não chega | número de destino não tem WhatsApp | confira o número; veja checar número |
Próximos passos
Última atualização:
