Guias & Recursos
Como usar o discador
Faça chamadas de WhatsApp direto do navegador — no painel da Hasos para testar, ou incorporado no seu produto via iframe.
Ao testar, ligue para o WhatsApp de outra pessoa (um número de terceiro). Ligar para o seu próprio número ou para outro número conectado à Hasos toca mas não tem áudio — o WhatsApp não estabelece mídia numa chamada para si mesmo. Não é bug: use um número de destino diferente.
Pelo painel (mais rápido para testar)
- Conecte um número em Dispositivos e aguarde o status ficar Conectado.
- Abra o dispositivo e clique em Discador.
- Autorize o microfone quando o navegador pedir — sem isso não há áudio.
- Digite o número de destino com DDI + DDD (ex.: 5511999999999) e clique em ligar.
Incorporado no seu produto (iframe)
- Emita um token do dispositivo pela API (o token autentica aquele número no navegador — trate-o como credencial).
- Cole o iframe abaixo no seu app. O atributo allow="microphone" é obrigatório.
- A página precisa estar em HTTPS — navegadores só liberam microfone em contexto seguro.
- Gere um token novo por sessão/usuário e não o exponha publicamente.
html
<!-- 1) emita um token (no seu servidor) -->
<!-- curl -X POST https://api.hasos.com.br/v1/instances/INSTANCE_ID/tokens \
-H "x-api-key: hs_live_sua_chave" -->
<!-- 2) incorpore o discador -->
<iframe
src="https://phone.hasos.com.br?token=SEU_TOKEN"
allow="microphone"
style="width:420px;height:640px;border:0;border-radius:8px"
></iframe>Fazendo uma chamada
- Formato do número: DDI + DDD + número, só dígitos (ex.: 5511999999999). Números do Brasil são normalizados automaticamente.
- Estados que você verá: “Chamando” (tocando) → “Conectado” (a pessoa atendeu e o áudio está fluindo).
- Durante a chamada dá para mutar o microfone e desligar pelos botões do discador.
- Cada chamada gera eventos por webhook (ringing/answered/ended) e uma gravação, como em qualquer chamada da API.
Requisitos e limitações
- Microfone autorizado + página em HTTPS são obrigatórios para haver áudio.
- Ligue para o número de outra pessoa (seu cliente). Ligar para o seu próprio número — ou para outro número conectado à Hasos — não estabelece áudio (o WhatsApp não completa uma chamada “para si mesmo”).
- Receber chamadas pelo discador está em beta; o fluxo estável hoje é fazer chamadas de saída.
- Um número por dispositivo: para discar de vários números, emita um token para cada um.