Widget de Callback
O Widget de Callback é um pequeno formulário incorporável que permite aos visitantes do seu site deixarem o número de telefone e receberem uma chamada de volta do seu agente IA — normalmente em segundos. Em vez de pedir aos visitantes para ligarem, a conversa vai ter com eles.
Este é o quinto tipo de widget, ao lado dos widgets Floating, Pill, Pill Floating e Inline — mas funciona de forma muito diferente. Os outros widgets iniciam uma conversa de voz no browser. O Widget de Callback coloca em fila uma chamada telefónica real feita pelo seu agente através do seu número outbound.
Quando Usá-lo
| Cenário | Porque o Widget de Callback Encaixa |
|---|---|
| Landing pages de geração de leads | O visitante compromete-se com um número de telefone, o agente qualifica-o no minuto seguinte |
| Páginas de produto de alta intenção | "Fale com um especialista" sem obrigar o visitante a ligar |
| Sites mobile-first | Um toque na pill, sem pedido de permissão, sem auscultadores necessários |
| Cobertura fora de horário | O visitante deixa um número após o horário, o agente liga quando a fila abrir |
| Menos fricção do que formulários | Os visitantes submetem um único campo e obtêm uma resposta instantânea |
Elegibilidade
O Widget de Callback requer três coisas na sua conta antes de poder ser ativado:
| Requisito | Porquê |
|---|---|
| Plano pago (Starter ou superior) | Os minutos outbound consumidos durante o callback são faturados por minuto |
| Número de telefone outbound verificado atribuído ao agente | O agente precisa de um número real de onde marcar |
| Email verificado no seu workspace | Confirma a propriedade antes de as chamadas outbound serem desbloqueadas |
Se faltar algum destes, a secção do widget de Callback na aba Widgets do agente mostra um alerta a dizer-lhe exatamente o que corrigir. O widget permanece desativado até que os três estejam em vigor.
O Widget de Callback não está disponível no plano Free porque coloca chamadas telefónicas outbound. Todos os outros tipos de widget (Floating, Pill, Inline) permanecem gratuitos.
Configurá-lo
1. Ativar o callback no agente
- Abra o seu agente e vá à aba Widgets.
- Desça até à secção Callback widget.
- Ative "Enable callback widget".
- Configure:
- Retry attempts — quantas vezes o agente tenta novamente se o visitante não atender (1–5, padrão 3).
- Retry interval — minutos entre tentativas (1–30, padrão 5).
- Widget language — o idioma em que o formulário, as mensagens de estado e o seletor de país falam ao seu visitante (14 idiomas disponíveis — ver abaixo).
- Theme — esquema de cores para a pill flutuante e o diálogo (usa a mesma paleta de tema dos outros widgets).
- Guarde.
Uma pré-visualização ao vivo do widget aparece ao lado das definições para que possa ver as suas alterações imediatamente — sem necessidade de fazer deploy para testar o aspeto.
2. Copiar o snippet de incorporação
Na mesma secção, copie o snippet HTML:
<hanc-ai-callback agent-id="YOUR_AGENT_ID"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async type="text/javascript"></script>
Cole-o uma vez no seu site, normalmente logo antes de </body>. O widget aparece como uma pill flutuante no canto da página.
A tag @latest significa que o seu site adota automaticamente as novas versões do widget quando são lançadas. Fixe uma versão específica (ex.: hanc-webrtc-widgets@1.4.0) se quiser controlo total sobre as atualizações.
O Que o Visitante Vê
O widget conduz os visitantes por quatro estados:
| Estado | O Que o Visitante Vê |
|---|---|
| Form | Pill flutuante no canto. Clique para abrir. Seletor de país à esquerda, campo de telefone à direita, botão de submeter. |
| Queued | "Está na fila — cerca de N segundos até lhe ligarmos." Atualiza ao vivo. |
| Dialing | "Estamos a ligar-lhe agora." Permanece até a chamada estabelecer ligação ou falhar. |
| Completed / Failed | Uma breve confirmação ou um erro amigável com a dica "recarregue a página para fazer outro callback". |
O formulário valida automaticamente o número de telefone contra o formato nacional do país escolhido e recusa-se a submeter a menos que o número seja plausível.
Cobertura de países
O seletor de país cobre a Europa (UE + DACH + Reino Unido), a América do Norte (EUA + Canadá) e um conjunto curado de países adicionais amplamente suportados. Cada país mostra a sua bandeira, nome e um placeholder de exemplo no formato nativo para que o visitante saiba o que escrever.
Se um país que os seus visitantes usam não estiver listado, contacte support@hanc.ai — a cobertura é expandida regularmente.
Atributos HTML
O widget aceita estes atributos na tag <hanc-ai-callback>:
| Atributo | Obrigatório | Descrição |
|---|---|---|
agent-id | Sim | O identificador único do seu agente |
locale | Não | Sobrepõe o idioma da UI do widget para esta página (ex.: locale="de"). Útil se o seu site é multilingue e o locale da página não corresponde ao padrão do agente. |
theme | Não | Sobrepõe o tema de cor para esta página |
position | Não | Onde a pill flutuante ancora (bottom-right, bottom-left, top-right, top-left) |
Tudo o que deixar de fora recorre ao que configurou no agente no painel.
Exemplo: página alemã num site multilingue
<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>
O texto da pill, os rótulos do diálogo, o seletor de país e as mensagens de estado passam todos para alemão. O próprio agente continua a falar no idioma para que está configurado — locale só afeta o que o visitante lê na página.
Idioma do Widget
A UI do widget vem com 14 idiomas integrados:
| Código | Idioma |
|---|---|
en | English |
de | Deutsch |
fr | Français |
es | Español |
it | Italiano |
pt | Português |
pl | Polski |
cs | Čeština |
hu | Magyar |
tr | Türkçe |
kk | Қазақша |
zh | 中文 |
ru | Русский |
uk | Українська |
O agente escolhe o seu idioma de três lugares, por ordem de prioridade:
- O atributo
locale="…"na incorporação (prioridade mais alta) - O Widget language definido na aba Widgets do agente
- Inglês (padrão)
O idioma do widget só afeta o texto no ecrã que o visitante lê — rótulos, o seletor de país, mensagens de estado. A conversa de voz real acontece no idioma que o seu agente está configurado para falar.
Comportamento de Retry
Se o visitante não atender na primeira tentativa, o agente aguarda o intervalo configurado e marca novamente — até ao número configurado de tentativas.
- Tentativas: 1–5 (padrão 3)
- Intervalo: 1–30 minutos (padrão 5)
O widget mostra ao visitante o estado de cada tentativa. Depois de todas as tentativas falharem, o widget muda para o estado "não conseguimos contactá-lo" com uma mensagem educada.
Três tentativas em intervalos de cinco minutos funciona bem para a maioria das páginas de geração de leads — rápido o suficiente para que o visitante ainda esteja a navegar, gentil o suficiente para não parecer insistente. Aumente se o seu público tende a ignorar números desconhecidos.
Um Callback por Carregamento de Página
Assim que um visitante submete o seu número, o widget bloqueia-se durante o resto do tempo de vida dessa página:
- Fechar o diálogo recolhe a pill mas não repõe o formulário.
- Reabrir mostra o estado atual (em fila / a marcar / concluído / falhado), não um formulário novo.
- Para fazer um segundo callback, o visitante precisa de recarregar a página.
Isto previne submissões duplicadas acidentais enquanto uma chamada já está a caminho. Se o visitante cancelar explicitamente o seu callback em fila a partir do diálogo (o botão "Cancel" no ecrã de fila), o bloqueio é libertado e pode voltar a submeter imediatamente.
O que acontece se recarregar a meio de um callback?
Se um visitante recarregar a página enquanto o agente ainda está a tentar o seu número, o widget deteta que já existe um callback ativo para o mesmo número e religa-se silenciosamente a ele — sem marcação duplicada, sem segunda entrada na fila. O visitante apenas vê o seu estado existente retomar de onde parou.
Concorrência e Throughput
Um único agente pode ter até 10 callbacks em curso ao mesmo tempo. As submissões para além disso aguardam na fila e são marcadas à medida que a capacidade se liberta.
A fila escoa continuamente — a maioria dos visitantes é marcada em poucos segundos após submeter se não estiver perto do limite de concorrência.
Proteção Contra Spam e Abuso
O Widget de Callback coloca chamadas telefónicas reais, por isso tem salvaguardas integradas que impedem o tráfego mau de aumentar a sua fatura. Estas funcionam automaticamente — não há nada para configurar.
| Salvaguarda | O que o visitante experiencia |
|---|---|
| Verificação "Não sou um robô" | Quando a proteção contra abuso está ativada na plataforma, o visitante completa um rápido Google reCAPTCHA antes de o callback ser colocado em fila. Visitantes genuínos passam-no num segundo; os bots são parados. |
| Validação de número | O formulário recusa submeter um número que não seja uma correspondência plausível para o país escolhido, por isso erros de escrita e números lixo nunca são marcados. |
| Números de tarifa premium e fora de cobertura | As linhas de tarifa premium, algumas gamas VoIP e números fora da cobertura suportada não são chamados de volta por telefone. Se o browser do visitante o suportar, o widget oferece antes uma chamada de voz no browser; caso contrário, veem uma mensagem educada "não podemos ligar para este número". Isto impede que o widget seja abusado para marcar números premium caros. |
| Limite de submissões repetidas | O mesmo número só pode ser colocado em fila um número limitado de vezes por hora para um agente. Os visitantes que ultrapassem isto veem uma mensagem amigável "entraremos em contacto em breve" em vez do ecrã de fila. |
Estas proteções existem porque um formulário de callback público é um alvo óbvio de abuso — alguém poderia de outra forma apontá-lo para números de tarifa premium ou martelá-lo com bots para queimar os seus minutos outbound. As salvaguardas correm silenciosamente em segundo plano; os visitantes normais nunca dão por elas.
Pré-visualização ao Vivo no Painel
A aba Widgets mostra uma pré-visualização ao vivo do widget de callback ao lado das definições. Qualquer alteração que faça — tema, idioma, números de retry — atualiza a pré-visualização instantaneamente. Não tem de fazer deploy do seu site para ver como o widget ficará.
A pré-visualização usa um manifesto mock com a lista completa de países e elegibilidade de demo, por isso o widget renderiza mesmo em planos onde os callbacks outbound ainda não estão disponíveis.
Rastreio Incorporado
O widget emite os mesmos eventos call-start e call-end que os outros widgets. Escute-os em JavaScript se quiser disparar a sua própria analítica:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// Visitor's callback was just connected — track as conversion
});
widget.addEventListener('call-end', () => {
// Callback finished — track duration, outcome, etc.
});
Disponibilidade por Plano
| Plano | Widget de Callback |
|---|---|
| Free | Não disponível (requer chamadas outbound) |
| Starter / Pro / Business / Enterprise | Disponível |
Todos os planos pagos têm o mesmo conjunto de funcionalidades do widget. O custo por chamada segue a sua taxa outbound normal — veja Faturação.
Relacionados
- Widgets de Website — Tipos de widget Floating, Pill, Pill Floating e Inline para conversas no browser
- Definições — Definições de chamada ao nível do agente incluindo a Max Call Duration que também limita os callbacks
- Números de Telefone — Ligue o número outbound de onde o seu widget de callback vai marcar
- FAQ — Perguntas comuns e casos-limite