Using the dashboard

Crie um widget web no painel

Configure um widget de clique para falar no seu site pela página Widgets Web — sem necessidade de chamadas de API.

A página Widgets da Web (/dashboard/web-widgets) cria e gerencia as chaves publicáveis que alimentam o widget de voz incorporável do ThunderPhone. Tudo o que a versão via API deste guia faz com cURL, esta página faz com um formulário — além de gerar o código de incorporação para você.

Criar um widget#

1. Clique em Novo widget e escolha um modo
   • Modo de agente — o widget sempre executa um agente escolhido por você no menu suspenso. A configuração mais simples.
   • Modo de webhook — em cada sessão do widget, o ThunderPhone chama seu URL de webhook, e seu servidor retorna a configuração do agente para esse visitante (roteamento por página, usuários autenticados, lançamentos graduais). Deixe o URL em branco para usar o webhook padrão da sua organização; ao inserir um novo URL, você também pode defini-lo como o padrão da organização.
2. Liste os domínios permitidos

   As chaves publicáveis são bloqueadas por origem: é necessário informar pelo menos um domínio, e o widget funciona apenas nos nomes de host listados. Caracteres curinga de subdomínio, como *.example.com, são permitidos (eles correspondem a subdomínios, não ao domínio sem subdomínio); curingas simples, como *, são rejeitados. localhost e 127.0.0.1 são sempre permitidos, portanto o desenvolvimento local funciona sem precisar listá-los.

3. Dê um nome, ative e crie

   O controle Ativar widget define se a chave aceita sessões — você pode criar um widget desativado e ativá-lo no lançamento.

Obter o código de incorporação#

Logo após a criação (ou pelo botão Incorporar de cada linha), uma janela de incorporação gera código pronto para colar com sua chave publicável preenchida:

• React — um snippet <ThunderPhoneWidget /> para aplicativos com bundler.
• Tag de script — um par de <script> de CDN + folha de estilos para qualquer site.

A janela também mostra uma prévia das opções básicas de aparência — título, cor primária, posição no canto e tema claro/escuro — e inclui suas escolhas no snippet. Para a referência completa de props, hooks de estilização e a opção headless, consulte a documentação do SDK do widget.

Gerenciar widgets pela lista#

Cada linha é editada no próprio lugar:

• Modo / Agente — alterne entre o modo de agente e o modo de webhook ou redirecione o agente usando seletores em linha.
• Domínios — adicione ou remova domínios permitidos como chips.
• Ativar/desativar — um controle por widget; widgets desativados deixam de aceitar sessões imediatamente.
• Transferir para organização — copie ou mova o widget para outra organização da qual você faz parte (mover o remove daqui).
• Excluir — revoga a chave publicável; o widget deixa de funcionar imediatamente em todos os domínios. Isso não pode ser desfeito.

As sessões do widget aparecem no histórico de chamadas com a mesma transcrição, gravação e avaliação das chamadas telefônicas.

Próximas etapas#