Pular para o conteúdo principal
Um token do WaGo é o identificador estável de uma sessão do WhatsApp. Crie o token uma vez, armazene-o no banco de dados da sua aplicação e use o mesmo token para conectar, escanear, enviar mensagens, receber webhooks e controlar chamadas. A criação de token é uma operação administrativa. Execute-a somente a partir do seu backend ou das suas ferramentas de implantação. Não exponha admintoken em código de navegador.

​
Quando criar um token

Crie um token quando:
  • Um novo cliente, workspace, equipe ou dispositivo precisar da própria conexão WhatsApp.
  • Você estiver provisionando sessões antes de mostrar um QR code no seu app.
  • Você excluiu uma sessão com /session/delete e precisa recriá-la.
Não crie um novo token toda vez que o usuário abrir seu app. Reuse o token existente e chame POST /session/connect para restaurar a sessão.

​
Requisição

curl -X POST http://localhost:1337/session/init \
  -H "Content-Type: application/json" \
  -H "admintoken: YOUR_ADMIN_TOKEN" \
  -d '{
    "Name": "customer-1",
    "Token": "customer-token-1",
    "Os": "linux"
  }'

​
Campos

CampoObrigatórioSignificado
NameSimNome legível para a linha local de usuário/sessão no WaGo. Mantenha-o único.
TokenSimToken de sessão que sua aplicação usará no header token. Espaços são removidos antes do armazenamento.
OsSimRótulo do ambiente do cliente, como linux, chrome, server ou o nome do seu produto.
Use tokens difíceis de adivinhar. Trate tokens de sessão como credenciais de API, porque qualquer pessoa com um token válido pode chamar endpoints de sessão dessa conta WhatsApp.

​
Resposta

A criação bem-sucedida retorna um envelope normal de sucesso do WaGo. O valor de data contém os detalhes do usuário criado: 
{
  "code": 200,
  "data": {
    "details": "user created successfully",
    "name": "customer-1",
    "token": "customer-token-1",
    "osName": "linux"
  },
  "success": true
}
Armazene o token no banco de dados da sua aplicação imediatamente após a criação. Sua aplicação precisará dele em todas as requisições de sessão posteriores.

​
Tokens duplicados

Se Name ou Token já existir, o WaGo retorna um erro parecido com: 
{
  "code": 500,
  "error": "token or name already exists",
  "success": false
}
Quando isso acontecer, não crie um segundo token para o mesmo usuário, a menos que você queira intencionalmente uma sessão WhatsApp separada. Procure o token existente no banco de dados da sua aplicação ou liste as sessões com GET /session/all a partir de um backend admin confiável.

​
Próximo passo

Depois de criar o token, conecte-o: 
curl -X POST http://localhost:1337/session/connect \
  -H "Content-Type: application/json" \
  -H "token: customer-token-1" \
  -d '{
    "Subscribe": ["Message", "ReadReceipt", "Presence", "Call"],
    "Immediate": true,
    "Phone": ""
  }'
Em seguida, busque /session/qr e mostre o QR code para o usuário. Veja Conectar e escanear para o fluxo completo.