• Entrar
    • Documentação
      » Sessões / QR Code » Tratamento de WebHook » Enviar mensagens
  • Iniciar ou desligar sessões do WhatsApp

  • Status da conta conectada

  • QR Code renderizado em tempo real

  • Gerenciar sessões
  • Ver status da conta
  • QR code renderizado
  • Como iniciar uma sessão do WhatsApp

    Primeiramente, você precisa criar uma conta em "Contas do WhatsApp".
    Cada conta possui um token de identificação e é através deste token que você irá realizar todas as solicitações.

    Para realizar uma solicitação de QR Code, será necessário realizar um loop de requisições a cada 5 segundos. Desta forma, você irá capturar o status e base64 do qrcode em tempo real.

    Requisição GET para iniciar uma sessão

    GET https://api.winzap.com.br/start/token-da-sua-conta/
    Resposta em JSON
    Primeira requisição
    {"instance":"token da sua conta","status":"OFFLINE","phone":null,"picture":null,"battery":null,"platform":null,"webhook":"endereço-webhook","qrCode":null}

    Segunda requisição:
    Continuar com o loop até que o parâmetro qrCode seja atualizado com o código base64 do QR code do WhatsApp

    {"instance":"token da sua conta","status":"READY","phone":null,"picture":null,"battery":null,"platform":null,"webhook":"endereço-webhook","qrCode":"data:image/png;base64,..."}

    Após autenticar o aparelho com o qrCode:
    {"instance":"token da sua conta","status":"CONNECTED","phone":"número do telefone","picture":"foto do perfil","battery":"nivel da bateria","platform":"sistema operacional do aparelho","webhook":"endereço-webhook","qrCode":null}

    Se o token estiver incorreto:
    {"error":"autorização negada"}

    Encerrando uma sessão

    GET https://api.winzap.com.br/stop/token-da-sua-conta/
  • Informações sobre a conta conectada

    GET https://api.winzap.com.br/status/token-da-sua-conta/
    Resposta em JSON
    {"instance":"token da sua conta","status":"CONNECTED","phone":"número do telefone","picture":"foto do perfil","battery":"nivel da bateria","platform":"sistema operacional do aparelho","webhook":"endereço-webhook","qrCode":null}

    Se a conta ou o WhatsApp estiverem desconectados:
    {"error":"whatsapp offline"}
  • Requisição GET para exibir

    GET https://api.winzap.com.br/qrcode/token-da-sua-conta/
    Resposta HTTP quando a sessão estiver com status OFFLINE
    Resposta HTTP quando a sessão estiver com status READY e com qrCode null
    Resposta HTTP quando a sessão estiver com status READY e com qrCode preenchido com base64
    Resposta HTTP quando a sessão estiver com status CONNECTED