> ## Documentation Index
> Fetch the complete documentation index at: https://talk-docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget de chat

> Adicione um widget de chat ao seu site para atender clientes diretamente.

O widget de chat é um componente embutível que você pode adicionar ao seu site para conectar visitantes diretamente ao Talk AI.

## Como funciona

O widget é acessado por uma chave pública única associada à sua unidade. Os visitantes do site podem iniciar conversas diretamente no seu site.

## Configuração

1. Acesse **Canais > Widget de chat** no Dashboard
2. Ative o widget para a unidade desejada
3. Copie o código de incorporação
4. 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

<AccordionGroup>
  <Accordion title="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**.
  </Accordion>

  <Accordion title="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**.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

<Note>
  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.
</Note>

## 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.

<Note>
  O widget usa autenticação via chave pública (diferente da API que usa `pyp_live_`). Cada unidade tem sua própria chave.
</Note>