> For the complete documentation index, see [llms.txt](https://docs.pixcord.shop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pixcord.shop/servidor/produtos/campos/texto.md).

# Texto

Em um campo do tipo "texto", o cliente poderá escrever qualquer coisa.

## Configurações

<figure><img src="https://3175619338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F86xa55E73t2fTqzuVaZS%2Fuploads%2FoGyOJb63hZtZlal0S3PH%2Fimage.png?alt=media&amp;token=68a589b7-3d87-4fe9-9767-7b14fa82913b" alt=""><figcaption><p>Configurações de um campo de texto</p></figcaption></figure>

O nome do seu campo só é usado internamente. Você pode o definir para qualquer texto de até 16 caracteres.

A descrição do seu campo é o nome do campo que é exibido para o cliente.&#x20;

<figure><img src="https://3175619338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F86xa55E73t2fTqzuVaZS%2Fuploads%2F5oD29pB9NLvLzxQdyN7c%2Fimage.png?alt=media&amp;token=d598578f-d44e-41fc-baed-04cd70f960df" alt=""><figcaption><p>Descrição do campo no pop-up de compra</p></figcaption></figure>

## Limite de caracteres

O campo de texto geralmente tem um mínimo de 1 caractere e máximo de 4096, mas estes valores são personalizáveis.

## Remover a obrigatoriedade

Nas opções do seu campo, também é possível desmarcar a obrigatoriedade de que o campo seja respondido pelo cliente. Nesse caso, as ações que usarem o campo como parte da sua resposta não serão executadas.

<figure><img src="https://3175619338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F86xa55E73t2fTqzuVaZS%2Fuploads%2FG805XniDqFjQEj3EC072%2Fimage.png?alt=media&amp;token=c70346e5-1ccf-43b4-87e2-0d1b6c6b2e8c" alt=""><figcaption></figcaption></figure>

## Retorno interno

Usando a [Placeholders](/informacoes/placeholders.md)`{fields.`*`nome do seu campo`*`}` em uma ação, você irá obter o texto especificado pelo seu cliente, ou `undefined` caso o campo não seja obrigatório e o cliente não responda nada.

## Exemplo

Configurando um campo de texto com o nome de "text", que não é obrigatório, e recebe um texto com tamanho de 16 a 32 caracteres.

<figure><img src="https://3175619338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F86xa55E73t2fTqzuVaZS%2Fuploads%2Fc9KFWmeqUz2eloKzgflB%2Fimage.png?alt=media&amp;token=f091a1d3-7e4f-4f06-9005-513fa9bfecee" alt=""><figcaption><p>Configurações de um campo de texto com nome "text"</p></figcaption></figure>

<figure><img src="https://3175619338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F86xa55E73t2fTqzuVaZS%2Fuploads%2FTdWa4azQKUnrk7AIWXiv%2Fimage.png?alt=media&amp;token=38676e05-eca9-4368-9b5f-cc46efe3001d" alt=""><figcaption><p>Cliente digitando em um campo de texto no pop-up de compra</p></figcaption></figure>

Com o cliente informando o texto, a placeholder `{fields.text}` será definida para exatamente o que o cliente digitou.

<figure><img src="https://3175619338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F86xa55E73t2fTqzuVaZS%2Fuploads%2FsRBNB5SdD3tE6iBQ1pF1%2Fimage.png?alt=media&amp;token=36a4cef7-b11a-420e-8fb4-12a2b4f3e289" alt=""><figcaption><p>Ação que fará o Pixcord Bot enviar uma mensagem com exatamente o mesmo conteúdo digitado pelo cliente em um canal específico </p></figcaption></figure>

<figure><img src="https://3175619338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F86xa55E73t2fTqzuVaZS%2Fuploads%2FZjLLs52MGodnUKUUWiHU%2Fimage.png?alt=media&amp;token=ff4e0a7f-68b9-4dd5-8560-d66aec4e5a2c" alt=""><figcaption><p>Ação que também fará o Pixcord Bot enviar uma mensagem, mas utilizando a placeholder do campo, possibilitando que mais texto (pré definido ou de outros campos de texto) seja enviado</p></figcaption></figure>

Nas ações, é possível utilizar o valor puro do campo, ou um texto predefinido que também contém o valor do campo (através da placeholder). No caso deste exemplo, o texto digitado no campo "text" será enviado pelo Pixcord Bot em uma mensagem. Se o cliente não especificar nenhum texto nesse campo, por ele não ser obrigatório, ações que usarem o campo não serão executadas na compra do produto. No segundo caso, porém, pela ação conter mais informações além desse campo, a placeholder retornará `null`.
