Skip to content
Para o administrador da conta › Para quem integra
Para quem integra

REST API: enviar pelo WhatsApp QR

O endpoint que manda mensagem pela sessão conectada por QR — texto, mídia, contato e localização.

3 min de vídeo 11 imagens Painel do administrador
Aula gravada na plataforma real. O cursor, as legendas e o destaque existem só no vídeo.

A REST API manda mensagem pelo WhatsApp conectado por QR. É o caminho de quem já tem um sistema — loja, ERP, agendamento — e quer avisar o cliente sem ninguém abrir o painel.

Tela da REST API
Desenvolvedor › REST API.
Pré-requisito
Exige uma instância WhatsApp QR ativa.
QR é diferente de Cloud APIEsta API usa a sessão pareada por QR Code. Para enviar pela Meta Cloud API — com template aprovado e número oficial — os endpoints são outros: Conversational API e Template API.

O token

Token de acesso
O token fica oculto até você clicar em Mostrar.
Gerar token
Gerar novo token invalida o anterior.

Como a chamada é montada

Parâmetros obrigatórios
Os parâmetros que toda chamada precisa.
Parâmetros na URL
Tudo vai na URL — sem corpo em JSON.
Escape o textoComo a mensagem viaja na URL, acentos, espaços e quebras de linha precisam ser codificados. Praticamente toda linguagem tem uma função pronta para isso — em JavaScript, encodeURIComponent.

Os tipos de mensagem

Tipos de mensagem
Cada tipo pede parâmetros próprios.
Lista de tipos
Texto, imagem, vídeo, áudio, documento, contato e localização.
  • Texto — só a mensagem.
  • Imagem / vídeo / documento — URL do arquivo e legenda opcional.
  • Áudio — URL do arquivo.
  • Contato — os dados do cartão de contato.
  • Localização — coordenadas, nome e endereço do ponto.

A resposta

Respostas da API
Um JSON dizendo sucesso ou erro.
Sucesso não é entregaA resposta confirma que a Heyoo aceitou o envio. Se o número não existe, se o aparelho está sem internet ou se o WhatsApp bloqueou, isso aparece depois — no inbox e nos logs, não na resposta imediata.

Conferir o que passou

Logs da API
Desenvolvedor › Logs: cada chamada registrada.
Busca nos logs
Busca por endpoint, ID da mensagem, status ou conteúdo.
  1. Conecte uma instância WhatsApp QR em Canais.
  2. Abra Desenvolvedor › REST API e clique em Gerar token.
  3. Guarde o token no servidor da sua aplicação.
  4. Monte a URL com os parâmetros obrigatórios e os do tipo escolhido.
  5. Faça a chamada e leia o JSON de resposta.
  6. Confira o resultado em Desenvolvedor › Logs.