Este endpoint permite capturar o QR Code de uma instância para autenticação no WhatsApp. Ele retorna a imagem no formato image/png
, permitindo exibi-la diretamente em uma tag <img />
no HTML, se necessário. Para acessar este recurso, é obrigatório fornecer um token de acesso, que pode ser passado no cabeçalho da requisição ou na query string.
Para utilizar este endpoint, é necessário fornecer um token de acesso válido. A forma recomendada é enviá-lo no cabeçalho da requisição. Opcionalmente, ele pode ser passado na URL como query string, mas isso expõe o token e não é recomendado.
⚠️ Importante: O uso do token na URL pode expô-lo em logs de servidores e históricos de navegadores, o que representa um risco de segurança. Sempre prefira a autenticação via cabeçalho HTTP.
🚀 Por que essa opção está disponível? A renderização do QR Code via query string foi criada para permitir que o cliente compartilhe o link diretamente com seu usuário final, usando um token temporário. Dessa forma, o usuário pode simplesmente abrir o link no navegador, visualizar o QR Code e conectar a instância. Essa funcionalidade pode ser útil em cenários onde o cliente final não tem acesso ao painel da API, mas precisa conectar a conta do WhatsApp rapidamente.
Se a instância já estiver conectada ou o QR Code não estiver disponível, a API retornará um erro:
Se deseja atualizar o QR Code em tempo real sem que seu usuário precise sair da sua plataforma, recomendamos utilizar os eventos da instância para acompanhar as atualizações.
Para isso, você pode configurar um webhook para escutar o evento instance.qrcode
. Sempre que o QR Code da sua instância for atualizado, seu sistema receberá uma notificação automática, permitindo que você atualize a exibição do QR Code em tempo real e garanta uma experiência fluida para o usuário.
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Obrigatório se instance_id
não estiver presente no body
.
Token de acesso
Success
The response is of type file
.
Este endpoint permite capturar o QR Code de uma instância para autenticação no WhatsApp. Ele retorna a imagem no formato image/png
, permitindo exibi-la diretamente em uma tag <img />
no HTML, se necessário. Para acessar este recurso, é obrigatório fornecer um token de acesso, que pode ser passado no cabeçalho da requisição ou na query string.
Para utilizar este endpoint, é necessário fornecer um token de acesso válido. A forma recomendada é enviá-lo no cabeçalho da requisição. Opcionalmente, ele pode ser passado na URL como query string, mas isso expõe o token e não é recomendado.
⚠️ Importante: O uso do token na URL pode expô-lo em logs de servidores e históricos de navegadores, o que representa um risco de segurança. Sempre prefira a autenticação via cabeçalho HTTP.
🚀 Por que essa opção está disponível? A renderização do QR Code via query string foi criada para permitir que o cliente compartilhe o link diretamente com seu usuário final, usando um token temporário. Dessa forma, o usuário pode simplesmente abrir o link no navegador, visualizar o QR Code e conectar a instância. Essa funcionalidade pode ser útil em cenários onde o cliente final não tem acesso ao painel da API, mas precisa conectar a conta do WhatsApp rapidamente.
Se a instância já estiver conectada ou o QR Code não estiver disponível, a API retornará um erro:
Se deseja atualizar o QR Code em tempo real sem que seu usuário precise sair da sua plataforma, recomendamos utilizar os eventos da instância para acompanhar as atualizações.
Para isso, você pode configurar um webhook para escutar o evento instance.qrcode
. Sempre que o QR Code da sua instância for atualizado, seu sistema receberá uma notificação automática, permitindo que você atualize a exibição do QR Code em tempo real e garanta uma experiência fluida para o usuário.
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Obrigatório se instance_id
não estiver presente no body
.
Token de acesso
Success
The response is of type file
.