# Filtro {% embed url="" %} {% hint style="info" %} Filtro é a etapa do fluxo responsável por avaliar as informações da conversa e poder direcionar a conversa para um caminho diferente no fluxo. Estas informações podem ser do usuário ou do contexto da conversa, seja através de objeto personalizado ou alguma variável de contexto. Vamos ao passo a passo! {% endhint %} 1 - Dentro do fluxo clique na opção Filtro: ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61002375313/original/EqDh0UswJxCIu9xoLN_iXnqIzBfTAL_F_Q.gif?1591941566) 2 - Utilize o contexto ou campo definidos na mensagem que você quer filtrar para criar a condição, e coloque a condição que o campo ou contexto deve ter: ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61002375316/original/yyaUTOzlTDsnVmb3nPZxYVYLQ328rGsJNA.gif?1591941579) {% hint style="info" %} OBS#: Campo: referente a um campo relacionado ao usuário ou a uma informação de contexto. **Condição**: Operação que será usada para avaliar o campo selecionado. **Valor**: Representa o valor de referência para avaliação da operação e do campo selecionado. Este valor está diretamente relacionado ao tipo do campo selecionado. Portanto se o campo for do tipo "Opções", o valor poderá ser apenas uma das opções cadastradas para este campo. {% endhint %} 3 - Ao criar o Filtro, ele te dará dois direcionamentos, Sim: caso o resultado dos critérios definidos (ou conjunção) seja "Verdadeiro", o fluxo seguirá adiante na vertical. Não: caso o resultado dos critérios definidos (ou conjunção) seja "Falso", o fluxo tomará o caminho a direita: ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61002375287/original/zY7__QmRK7A6QPQwHHaFktCdqns4K3yp2A.gif?1591941433) 4 - Agora é só criar a ação que deve ocorrer para cada uma das opções: ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61002375298/original/QmcSQss_3UKJk12iY-qkYP6qEtDfhMp0dg.gif?1591941456) ## Exemplos de Utilização de Filtro {% hint style="info" %} Nesse exemplo usaremos um bot que os usuários informam as opções que desejam e através dos Filtros são direcionados para o assunto desejado e também daremos algumas dicas de utilização dos filtros Siga os passos a seguir, vamos lá! {% endhint %} 1 - No Fluxo de Boas Vindas , após a mensagem que dará boas vindas, insira a Mensagem que ⠀⠀ ⠀perguntará se o usuário é aluno, professor ou ex-aluno: ![](/files/Y0efHSfezTpQDImhALib) 2 - Salve a mensagem como contexto ou com o campo de sua preferência: ![](/files/ixxHC3Q6RSpv9A9ifX12) {% hint style="info" %} Dica 1#: Quando quiser interligar as opções de uma mensagem à um filtro salve-a como contexto e utilize o nome do contexto para fazer essa conexão. Definindo quais opções serão válidas: {% endhint %} 3 - Crie um Filtro para definir que as únicas opções aceitas como válidas serão as ⠀⠀⠀ ⠀⠀ ⠀⠀ ⠀⠀⠀ disponibilizadas na mensagem; 4 - Para conectar o filtro às opções da mensagem utilize o contexto ou campo que foi criado na ⠀⠀⠀ mensagem: ![](/files/ecL5yNRAk1cZaI0oRAW3) {% hint style="info" %} Dica 2#: Para interligar o filtro com as opções da mensagem utilize o nome do contexto que foi criado na etapa de Mensagem. {% endhint %} 5 - Crie a mensagem que o usuário receberá, caso ele não responda uma opção válida: ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61000707784/original/tJqdlEbrad6NJAUi6iiL2ox4stBNu76JJw.gif?1585857793) 6 - Crie a etapa que direcionará ele para escolher novamente às opções: ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61000707795/original/s8GG4h_FkTR0CTPGyVAqe7ksz3vrNmPmcg.gif?1585857823) 7 - Crie um filtro para a primeira opção: ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61000707819/original/dNEtpaKq7MBAvN_PIehL3k7KSwxFu6w4qA.gif?1585857933) 8 - Crie um filtro para a segunda opção: ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61000707877/original/VH_Tf9ewUKKLTOQwUlfpvNtmndmLa2pkJA.gif?1585858266) 9 - E um para a terceira opção: ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61000707885/original/JbZgu_rSlKxKGGsEvl9C6r9dl9TZOS36jA.gif?1585858291) {% hint style="info" %} Dica 3#: Quando quiser criar mais de uma opção para o usuário e filtrar ela, será necessário criar um filtro para cada uma ligada ao contexto ou ao campo definido. {% endhint %} 10 - Agora utilizando às Etapas é só ligar os Filtros aos Fluxos ou que eles devem direcionar: ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61000707900/original/OkURJFnBswzXDWYCL1VSBUyFq3h39dW_jA.gif?1585858411) {% hint style="info" %} Vamos testar e ver como ficou? Primeiro vamos ver o que acontece quando colocamos uma opção que não é valida e testar o filtro que valida as opções: {% endhint %} ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61000708024/original/MZR130UnUacDn-v3Qv5ossm7KDKTN4sY-g.gif?1585859255) {% hint style="info" %} Agora vamos testar o direcionamento do filtro escolhendo uma opção válida: {% endhint %} ![](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/61000708052/original/XIsH501mRTg4hFw9Zsn-EHdUpkSd4O8khA.gif?1585859539) {% hint style="info" %} Observações: Nesse exemplo utilizamos os Filtros para colocar condições em mais de uma informação voltadas ao bot exemplo, mas você pode executar outros exemplos de Filtros. {% endhint %} --- # 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://help.cosmobots.io/help/bot-builder/fluxo-da-conversa/filtro.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.