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