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

# Parâmetros do Bot

> Configuração do caso: identificação do contato, agrupamento, nome, produto e campos adicionais.

A aba **Parâmetros do Bot** de **Entrada de Campanha** define quais dados do arquivo de entrada são enviados ao bot e como os casos são organizados.

***

## Parâmetros gerais

Configuração do caso: agrupamento, nome, código e parâmetros do produto.

### ID do caso

Coluna do arquivo que identifica de forma única cada contato na campanha.

<img src="https://mintcdn.com/inceptia/s3peX8NLdE8PxYYV/images/parser/params-id-agrupacion/01-id-agrupacion.png?fit=max&auto=format&n=s3peX8NLdE8PxYYV&q=85&s=b140ff2175b2a68f379eeb989a2fbc69" alt="ID do caso e agrupamento de registros" width="855" height="825" data-path="images/parser/params-id-agrupacion/01-id-agrupacion.png" />

* Escreva o nome exato da coluna tal como aparece no seu arquivo (ex: `DNI`, `legajo`, `id_cliente`).
* Esta coluna **não pode ter valores vazios nem repetidos**, exceto quando alguma das opções de agrupamento descritas abaixo está ativada.
* Com o botão **Ações** você pode aplicar transformações sobre os valores desta coluna antes de processá-los.

### Agrupamento de registros

Ative se o seu arquivo tem várias linhas para o mesmo contato e você precisa consolidá-las em um único caso.

| Opção            | Quando ativar                                                                                                                   |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Por produto**  | O mesmo contato aparece em várias linhas com produtos diferentes. Ex: `cliente A — hipoteca` / `cliente A — empréstimo pessoal` |
| **Por telefone** | O mesmo contato aparece em várias linhas com telefones diferentes                                                               |

Você pode ativar as duas opções simultaneamente.

***

### Tratamento do nome e sobrenome

Configure em quais colunas do seu arquivo estão o nome e sobrenome do contato e como estão organizados.

<img src="https://mintcdn.com/inceptia/s3peX8NLdE8PxYYV/images/parser/params-nombre-apellido/01-nombre-apellido.png?fit=max&auto=format&n=s3peX8NLdE8PxYYV&q=85&s=3c5537d2f2d83aedcd72f7899dea3d19" alt="Configuração do nome e sobrenome" width="855" height="825" data-path="images/parser/params-nombre-apellido/01-nombre-apellido.png" />

**Formato**: define como o nome vem no arquivo.

| Opção                           | Descrição                                                            |
| ------------------------------- | -------------------------------------------------------------------- |
| Colunas separadas               | Nome e sobrenome em colunas distintas                                |
| Uma coluna: sobrenome primeiro  | A primeira palavra é considerada sobrenome, o resto como nome        |
| Uma coluna: nome primeiro       | As primeiras palavras são consideradas nome, a última como sobrenome |
| Uma coluna: tudo como sobrenome | Tudo nesta coluna é considerado sobrenome. O nome fica vazio         |

Depois de escolher o formato, preencha **Coluna do nome** e **Coluna do sobrenome** com os nomes exatos das colunas no seu arquivo.

***

### Produto e dívida

Mapeie os parâmetros de dívida e produto com as colunas correspondentes do seu arquivo. Ative apenas os que a sua campanha utiliza.

<img src="https://mintcdn.com/inceptia/s3peX8NLdE8PxYYV/images/parser/params-producto-deuda/01-producto-deuda.png?fit=max&auto=format&n=s3peX8NLdE8PxYYV&q=85&s=b3ade0c96df2f1da3ec92c0edaa600d3" alt="Parâmetros de produto e dívida" width="855" height="825" data-path="images/parser/params-producto-deuda/01-producto-deuda.png" />

| Parâmetro            | Tipo             | Descrição                                                                                       |
| -------------------- | ---------------- | ----------------------------------------------------------------------------------------------- |
| Valor devido         | `int` ou `float` | Valor da dívida do contato                                                                      |
| Código da dívida     | `str`            | Identificador específico da dívida                                                              |
| Produto              | `str`            | Nome ou identificador do produto                                                                |
| Subproduto           | `str`            | Subdivisão opcional do produto                                                                  |
| Vencimento da dívida | `date`           | Data de vencimento. Formatos suportados: `DD/MM/YYYY`, `YYYY-MM-DD`, `DD-MM-YYYY`, `YYYY/MM/DD` |

Com o botão **Ações** de cada parâmetro você pode aplicar transformações ou filtros adicionais sobre os valores antes de enviá-los ao bot.

***

## Adicionais

Campos extras do arquivo que o bot pode receber como parâmetros personalizados. É opcional.

<img src="https://mintcdn.com/inceptia/s3peX8NLdE8PxYYV/images/parser/params-adicionales/01-adicionales.png?fit=max&auto=format&n=s3peX8NLdE8PxYYV&q=85&s=b3997e84ceaa312ffc218a55edbac4b7" alt="Parâmetros adicionais" width="855" height="825" data-path="images/parser/params-adicionales/01-adicionales.png" />

Para cada campo adicional você configura:

| Campo                 | Descrição                                                                                     |
| --------------------- | --------------------------------------------------------------------------------------------- |
| **Nome do parâmetro** | Nome interno que o bot vai usar para se referir a este dado                                   |
| **Coluna do arquivo** | Nome exato da coluna no seu arquivo de entrada                                                |
| **Coluna criada**     | (Opcional) Se o valor é gerado a partir de uma transformação e não vem diretamente do arquivo |
| **Tipo**              | Tipo de dado: `str`, `int`, `float` ou `date`                                                 |

Com **Ações** você pode aplicar transformações sobre o valor de cada campo adicional.

Use **+ Adicionar parâmetro** para incluir novos campos.
