Widget de chat web
Chat com hóspedes,
no seu próprio site.
Uma única tag script coloca uma bolha de chat no seu site. Os hóspedes falam com você por ali e cada conversa cai na mesma caixa de entrada do Prohost que suas threads do Airbnb e do Vrbo, com sua IA respondendo primeiro.
O que o widget faz
É o mesmo chat com hóspedes que roda no seu site de reserva direta do Prohost, empacotado para qualquer site que você controla.
Fica no seu site
Cole uma tag script no rodapé do site ou na área de código personalizado. Sem plugin, sem etapa de build, nada para você hospedar.
Uma caixa de entrada para tudo
As conversas do chat web chegam na caixa do Prohost ao lado das threads das OTAs, então seu time responde tudo em um só lugar.
Sua IA responde primeiro
A mesma IA que cuida das suas mensagens com hóspedes responde aqui também, usando o conhecimento dos seus imóveis, e passa para uma pessoa quando for o caso.
Instale em três passos
Copie o trecho nas configurações do seu widget, cole no seu site e publique.
- Crie seu widget
Abra o app Widget de Chat com IA no Prohost e defina o nome, a saudação e o estilo do botão que seus visitantes vão ver.
- Copie seu trecho
Na seção Adicionar a outro site, copie o trecho. Ele já vem com o id do seu widget, sua chave de incorporação e as configurações do botão.
- Cole antes da tag body de fechamento
Coloque no rodapé geral do site ou na área de código personalizado e publique. O botão aparece no canto no próximo carregamento da página.
Troque WIDGET_ID e WIDGET_API_KEY pelos valores das configurações do seu widget, ou simplesmente copie o trecho pronto do app, que já preenche os dois. A chave de incorporação é pública e vale só para aquele widget: ela não dá nenhum acesso à sua conta. O Prohost esconde a chave depois da primeira exibição, então use Girar chave se precisar de um trecho novo para copiar.
Só o id do widget e a chave de incorporação são obrigatórios. Se você deixar os atributos do botão de fora, ele usa os próprios padrões — a bolha índigo e o ícone de chat — independentemente do que você escolheu no app. A janela em si continua seguindo suas configurações.
Funciona na maioria dos criadores de site: Webflow, WordPress, Squarespace e Wix têm um espaço para código personalizado no rodapé.
Referência de atributos
Todos os atributos data-* que o carregador lê. Qualquer outra coisa na tag script é ignorada.
| Atributo | Valores | Padrão | O que faz |
|---|---|---|---|
data-widget | O id do seu widget | Obrigatório | A qual widget a conversa pertence. |
data-api-key | Sua chave pública de incorporação | Obrigatório | A chave pública de incorporação daquele widget. Ela vale só para o widget e não dá acesso à conta. |
data-position | bottom-right · bottom-left | bottom-right | Em qual canto ficam o botão e a janela de chat. |
data-launcher-color | Cor hexadecimal | #4F46E5 | Cor de preenchimento da bolha do botão. |
data-accent | Cor hexadecimal | Nenhum | Nome antigo de data-launcher-color. Usado só quando data-launcher-color não está lá. |
data-launcher-icon | chat · lettermark | chat | O símbolo do botão: uma bolha de chat ou o monograma branco do Prohost. |
data-hide-mobile | Só presença | Desligado | Esconde o botão abaixo de 768px. A janela ainda pode ser aberta por um botão seu — veja abaixo. |
data-sound | on | Configuração do widget | Liga o som de resposta nesta incorporação, independente do que diz a configuração do widget. Veja abaixo. |
data-hide-mobile vale só pela presença: qualquer valor, inclusive uma string vazia, liga o atributo. Todos os outros são avaliados pelo valor, e data-sound em especial só reage ao valor exato em minúsculas on.
Como funciona o som de resposta
Um toque curto e discreto soa na janela de chat quando uma resposta chega e o visitante está olhando para outro lugar.
Tocar som para os hóspedes
O botão nas configurações do seu widget, e é ele que manda. Vale para este widget em todo lugar onde ele roda, inclusive no seu site de reserva direta hospedado no Prohost. Mude quando quiser, sem mexer no código.
data-sound="on"
Uma sobreposição explícita na tag script que você colou. Ela só consegue ligar o som: não existe um valor para desligar. Existe para que trechos colados antes de a configuração existir continuem funcionando, e para você forçar o som em um site específico.
Qualquer um dos dois basta
O toque soa se a configuração estiver ligada ou se o atributo tiver exatamente o valor on. O trecho que o app gera mantém os dois alinhados: inclui o atributo enquanto a configuração está ligada e o deixa de fora quando ela está desligada.
Para silenciar em todo lugar, desligue a configuração e cole o trecho de novo no seu site. Um atributo já colado continua passando por cima da configuração, e isso é de propósito.
- O visitante precisa interagir com a página antes
Os navegadores bloqueiam áudio até alguém clicar, tocar ou digitar. Abrir o botão conta, digitar na janela também — então quem mandou a mensagem que gerou a resposta vai ouvir. Se mesmo assim o navegador bloquear, nada quebra: o contador de não lidas no botão é o sinal principal e o som é um bônus.
- Nunca toca enquanto a pessoa está lendo
Sem toque enquanto a janela está aberta e a aba em primeiro plano: a resposta já está na tela. Ele toca com a janela fechada ou a aba em segundo plano. O contador de não lidas segue uma regra um pouco mais estreita: só aparece com a janela fechada.
- Várias respostas seguidas, um toque só
Várias mensagens chegando juntas geram um único aviso, e não um por mensagem.
Controle pelo seu próprio site
O carregador expõe um pequeno barramento de eventos em window.ProhostWebchat, então seu site pode abrir a janela e reagir ao que acontece dentro dela.
webchat_session_startedA conversa passou a existir: o visitante mandou a primeira mensagem. O payload traz o conversationId.webchat_message_sentO visitante mandou uma mensagem.webchat_host_messageChegou uma resposta do seu time ou da sua IA. É isso que alimenta o contador de não lidas e, quando ligado, o som.Útil junto com data-hide-mobile: esconda o botão padrão no celular e abra a janela a partir de um botão seu. Os eventos só são repassados quando vêm da incorporação do Prohost, nunca de outra origem.
Gerencie tudo pelo app
Nome, saudação, cor de destaque da janela e som de resposta ficam no app Widget de Chat com IA, e todo site que roda seu widget pega essas mudanças sozinho. Cor e ícone do botão são diferentes: eles ficam no trecho, então copie de novo depois de mudá-los, igual a quando você gira a chave de incorporação.