---
title: Entidades
slug: helper/entidades
createdAt: 2026-11-19T14:26:40.053Z
---

Enquanto a *intenção* diz **o que** o cliente quer, a **entidade** captura os **dados** dentro da mensagem: um CPF, um número de pedido, o nome de um produto, um valor. Assim o robô não só entende o pedido como já pega as informações para resolver.

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/lwm9LZBc-OW0-zJ8axE6h_40f737f7f87bc9568d9a6d28b5378513.jpg" alt="Entidades do tipo sistema e lista" caption size="160" width="1600" height="911"} *Entidades do tipo sistema e lista*

## Dois tipos de entidade

| Tipo    | Como funciona                                   | Exemplos                                      |
| ------- | ----------------------------------------------- | --------------------------------------------- |
| Sistema | Reconhece formatos conhecidos automaticamente   | CPF, CNPJ, e-mail, telefone, CEP, data, valor |
| Lista   | Você define os valores possíveis, com sinônimos | produto = cartão, conta, pix                  |

## Criar uma entidade

1. Na tela **Entidades**, escolha o **assistente** no topo.
2. Escolha o tipo (**Lista** ou **Sistema**) e dê um nome (ex.: `produto`).
3. Clique em **Criar**.

### Entidade de sistema

Basta escolher o **padrão** (ex.: CPF). A plataforma já sabe reconhecer o formato — não precisa listar nada. É determinístico: ou o formato aparece na mensagem, ou não.

### Entidade de lista

1. Adicione os **valores possíveis** (ex.: cartão, conta, pix).
2. Para cada valor, adicione **sinônimos** (ex.: "cartãozinho", "cartao").
3. Ligue o **Fuzzy** para a IA reconhecer variações por semelhança, sem você precisar listar todas.

## Testar a extração

Use **Testar extração**: escreva uma frase como *"meu cpf é 123.456.789-09 e quero bloquear o cartão"* e veja o que a plataforma capturou (o CPF e o produto).

## Onde as entidades são usadas

O que a entidade captura vira uma **variável** da conversa. Você usa isso no fluxo:

- em **mensagens**, para personalizar (ex.: "Confirmando o produto: `{{produto}}`");
- em **condições**, para seguir caminhos diferentes (ex.: "se produto = cartão → …").
