Como funciona
O widget é acessado por uma chave pública única associada à sua entidade. Os visitantes do site podem iniciar conversas sem precisar de WhatsApp.Configuração
- Acesse Canais > Widget de chat no Dashboard
- Ative o widget para a entidade desejada
- Copie o código de incorporação
- Cole no HTML do seu site
Funcionalidades
- Inbox dedicada — conversas do widget ficam em uma inbox separada
- Histórico de mensagens — mensagens anteriores são preservadas mesmo que o visitante feche o site e volte depois
- Handoff para humano — a IA pode transferir a conversa para um atendente humano quando necessário
- Personalização visual — adapte cores e textos ao visual do seu site
- Status de entrega — acompanhe se o visitante recebeu e visualizou suas mensagens
Status de entrega das mensagens
Cada mensagem enviada para o visitante (seja pela IA ou por um atendente humano) passa por 3 estados que você pode acompanhar no inbox:| Status | Significado |
|---|---|
| Enviada | A mensagem foi enviada, mas o visitante ainda não a recebeu (site fechado ou sem conexão). |
| Recebida | O visitante abriu o site e o widget carregou a mensagem no navegador. |
| Visualizada | O visitante abriu a janela do chat e visualizou a mensagem. |
Comportamento por cenário
Visitante com o site aberto
Visitante com o site aberto
A mensagem é entregue instantaneamente. O status atualiza para recebida assim que o widget processa a mensagem. Se a janela do chat estiver aberta, atualiza direto para visualizada.
Visitante com o site fechado
Visitante com o site fechado
A mensagem fica como enviada. Quando o visitante reabrir o site, o widget carrega automaticamente todas as mensagens pendentes e o status atualiza para recebida. Ao abrir a janela do chat, atualiza para visualizada.
Queda de conexão temporária
Queda de conexão temporária
Se o visitante perder a conexão, o widget reconecta automaticamente e busca todas as mensagens que chegaram durante a desconexão. Os status são atualizados normalmente.
O rastreamento de status se aplica apenas a mensagens enviadas para o visitante (da IA ou do atendente). Mensagens enviadas pelo visitante não possuem status de entrega.
Assinatura do atendente
Quando um atendente humano assume a conversa, o visitante vê uma notificação informando que o atendente entrou no chat. O nome exibido no widget é o nome de assinatura configurado pelo atendente no inbox. Se o atendente alterar sua assinatura durante a conversa, o widget atualiza automaticamente o nome exibido e mostra uma nova notificação.O widget usa autenticação via chave pública (diferente da API que usa
pyp_live_). Cada entidade tem sua própria chave.