# Conversão
## Conversões
A tela **Conversões** centraliza os *eventos operacionais e de marketing* disparados na Hablla — criação/atualização de cadastros, mudanças de status, ações em cartões, entre outros.\
Ela funciona como um **log auditável** para observabilidade e troubleshooting: você acompanha a linha do tempo, aplica filtros e pode inspecionar o **payload bruto (JSON)** de cada evento.
> ⚠️ A lista de eventos evolui continuamente. Novos tipos podem ser adicionados e alguns nomes podem mudar conforme melhorias do produto.
### Como ler a timeline
Cada linha exibe:
* **Tipo do evento** (ex.: *Conversão*, *Criou uma pessoa*).
* **Contexto/entidade** (ex.: pessoa, cartão, usuário, organização).
* **Mensagem resumida** com o que aconteceu.
* **Data e hora** *(carimbo temporal)*.
* **Ações**:
* **JSON** → abre o payload completo do evento.
* **Ver dados atualizados** / **Dados antigos** → quando houver comparação entre antes/depois.
***
### Filtros
Use o botão **Filtros** (canto superior direito) para refinar a timeline por:
* **Tipo de evento**
* **Período (data e hora)**
* **Origem** (quando aplicável)
* **Entidade** (pessoa, cartão, etc.)
#### Período (Data e Hora)
Permite restringir os eventos por intervalo temporal **preciso**, combinando data e horário.
Campos:
* **Data inicial** e **Hora inicial**
* **Data final** e **Hora final**
Comportamento:
* O intervalo é **inclusivo**: eventos com carimbo exatamente na **hora inicial/final** também entram no resultado.
* Se você **não** preencher as horas:
* **Hora inicial** assume `00:00`
* **Hora final** assume `23:59`
* Validação impede **data/hora final anterior** à inicial.
* O fuso utilizado é o **fuso configurado no workspace**.
Exemplos rápidos:
* “Hoje, das 09:00 às 12:00” → encontre picos matinais de conversões.
* “Ontem, 18:00 até Hoje, 09:00” → monitore efeitos de campanhas noturnas.
* “Últimos 7 dias completos” → **Data inicial** = hoje−7, **Hora inicial** = `00:00`; **Data final** = hoje, **Hora final** = `23:59`.
> Dica: combine **Tipo de evento + Período** para acelerar diagnósticos em campanhas e integrações.
***
### Tipos de eventos (exibidos nesta tela)
Abaixo, os eventos informados para esta página. Novos eventos podem aparecer ao longo do tempo.
| Evento | O que significa na prática | Quando usar |
| ----------------------- | --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| **Conversão** | Registro de uma conversão (ex.: formulário, fluxo, short-link com UTM) vinculado a uma pessoa/lead. | Medir performance, atribuição de campanha e jornada de aquisição. |
| **Criou uma pessoa** | Um novo contato foi adicionado à base. | Confirmar ingestão de leads (planilha, API, formulário, webhook etc.). |
| **Alterou os dados de** | Dados cadastrais/atributos de uma pessoa foram atualizados. | Auditar origem de atualizações e entender *quando* e *quem* mudou um campo crítico. |
| **Excluiu uma pessoa** | Um contato foi removido. | Rastrear limpezas de base, LGPD/consentimento ou ajustes em lotes. |
| **Bloqueou** | Pessoa/entidade marcada como bloqueada para algum fluxo/canal. | Investigar por que um contato parou de receber comunicações. |
| **Desbloqueou** | Remoção do status de bloqueio. | Restabelecer elegibilidade para campanhas e fluxos. |
> Outras mensagens que você pode ver (dependendo do seu workspace): **atualizou/moveu cartão**, **tarefa criada**, **removeu tag**, **dados do dicionário atualizados**. Esses eventos seguem a mesma lógica: resumo + horário + ação para abrir o JSON.
***
### Inspecionando o JSON do evento
Clique em **JSON** para abrir o payload bruto. Isso é essencial para:
* Validar **variáveis** e **IDs** usados em fluxos/integrações.
* Checar **antes/depois** de um update.
* Reproduzir cenários em ambientes de teste.
> Boas práticas: ao abrir o JSON, procure por `id`/`external_id`, `origin`, `timestamp`, `before`/`after` e campos sensíveis de negócio (ex.: `stage`, `labels`, `owner`).
***
### Casos de uso recomendados
* **Atribuição de campanha**: valide se uma *Conversão* veio de um short-link com UTM correta.
* **Qualidade de dados**: audite atualizações em massa (ex.: “Alterou os dados de”).
* **Suporte e CX**: explique por que um contato **bloqueou/desbloqueou** e quando isso ocorreu.
* **Operação comercial**: acompanhe *movimentações de cartões* e *criação de tarefas* vinculadas à pessoa.
***
### Limitações e evolução
* A nomenclatura e o conjunto de eventos podem mudar com novas releases.
* Alguns eventos dependem de permissões e de integrações habilitadas no workspace.
***
#### Resumo
A tela **Conversões** é seu **painel de auditoria** para marketing conversacional e operações.\
Use **filtros** para isolar o que interessa, **abra o JSON** para ver granularidade técnica e garanta rastreabilidade ponta a ponta — da origem da conversão ao status do contato.
---
# 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/hablla/marketing/conversao.md?ask=
```
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.