# Add Webchat ID

A operação Adicionar Webchat ID permite associar um ID de uma sessão de webchat a um registro de pessoa existente na Hablla. Esta ação é o ponto central para conectar um visitante, muitas vezes anônimo, do seu site com um perfil de contato conhecido no seu CRM.

Quando um visitante inicia uma conversa no webchat, ele recebe um ID único de sessão. Se, durante a conversa, esse visitante se identifica (por exemplo, fornecendo um e-mail), você pode usar esta operação para vincular permanentemente aquela sessão de chat ao perfil do contato.

Isso enriquece o perfil da pessoa com todo o histórico de conversas e permite que os atendentes tenham uma visão completa do cliente em interações futuras.

#### Como Configurar

1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação.
2. No campo "Operação", selecione a opção "Adicionar Webchat ID".
3. No campo "ID da Pessoa" (`personId`), insira o identificador do contato ao qual o webchat ID será associado.
4. No campo "Webchat ID", insira a variável que contém o ID da sessão de chat.
5. No campo "Conexão", selecione qual das suas conexões de webchat está sendo usada.

***

### Parâmetros

| Campo                   | Tipo            | Obrigatório? | Descrição                                                                                 |
| ----------------------- | --------------- | ------------ | ----------------------------------------------------------------------------------------- |
| ID da Pessoa            | Texto           | ✅ Sim        | O ID único da pessoa (contato) que será vinculada à sessão de chat.                       |
| Webchat ID              | Texto           | ✅ Sim        | O identificador único da sessão de webchat, geralmente fornecido pelo gatilho do chatbot. |
| Conexão (`connections`) | Lista de Opções | ✅ Sim        | A conexão de webchat específica que originou a conversa.                                  |

Exportar para as Planilhas

***

### Estrutura (Usando JSON)

O corpo da requisição JSON deve conter o `webchat_id` da sessão e a `connection` correspondente.

JSON

```
{
  "webchat_id": "session_uuid_a1b2c3d4e5",
  "connections": [
    "connection_id_xyz987"
  ]
}
```

***

### 🚀 Exemplo de Caso de Uso

Objetivo: Quando um visitante anônimo no webchat informa seu e-mail para um chatbot, identificar o contato na Hablla e associar a conversa ao seu perfil.

1. O fluxo do chatbot é programado para pedir o e-mail do visitante em um determinado ponto da conversa.
2. Quando o e-mail é fornecido, o chatbot dispara um gatilho de "Evento Customizado" na Hablla, enviando o `webchat_id` da sessão e o `email` coletado.
3. O fluxo na Hablla começa com este gatilho.
4. Use a operação "Buscar Pessoa por E-mail" para encontrar o `personId` correspondente ao e-mail recebido.
5. Adicione uma Condição (If) para verificar se uma pessoa foi encontrada.
6. Se sim, adicione o bloco "Pessoas" com a operação "Adicionar Webchat ID".
   * ID da Pessoa: Use o ID encontrado na busca (`{{steps.4.result.id}}`).
   * Webchat ID: Use o ID vindo do gatilho (`{{trigger.body.webchat_id}}`).
   * Conexão: Selecione a conexão de webchat do seu site.

Com este fluxo, você transforma uma interação anônima em um ponto de contato registrado no histórico do cliente, permitindo que qualquer atendente que assuma a conversa tenha o contexto completo do relacionamento daquele cliente com sua empresa.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/add-webchat-id.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.