> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/chat-center/componentes-do-fluxo/componente-fluxo-integracao.md).

# Componente fluxo: Integração

Este componente é utilizado para conectar o fluxo de atendimento a sistemas externos, permitindo que o robô busque ou envie informações automaticamente.

## Pré-requisitos

**Permissão necessária:** Adicionar, Editar e Remover Fluxos.\
Como o componente faz parte das configurações de fluxo, o usuário responsável por executar este tutorial [<mark style="color:$primary;">precisa ter ativa a permissão de gerenciamento de Fluxos</mark>](broken://pages/QNNAvdB6ZxF37fUngwE8). Caso essa opção não esteja disponível no seu perfil, solicite a liberação ao administrador da plataforma antes de prosseguir.

## Configurações do componente

<img src="/files/8OTXymqbArJAy0aAwuM2" alt="" height="554" width="556">

**Horários:** Permite [<mark style="color:$primary;">selecionar um</mark> <mark style="color:$primary;"></mark><mark style="color:$primary;">**Grupo de Horários**</mark>](/perguntas-frequentes/perguntas-frequentes-1/chat-center/grupos-de-horarios.md) (previamente criado em configurações) para definir quando este componente deve funcionar. Se o atendimento ocorrer dentro deste período, o componente é executado; caso contrário, ele é ignorado e o fluxo segue automaticamente para a próxima etapa.

**Exceção**: Define períodos em que este componente não deve ser executado, sendo aplicado em qualquer horário fora desse intervalo. Quando um período é configurado aqui, o fluxo ignora o componente e segue automaticamente para a próxima etapa.

**Integrações**: Campo de seleção onde você deve escolher o [<mark style="color:$primary;">aplicativo previamente ativado via</mark> <mark style="color:$primary;"></mark><mark style="color:$primary;">**Marketplace.**</mark>](/perguntas-frequentes/perguntas-frequentes-1/chat-center/marketplace-do-chat-center.md)

Ao selecionar a integração desejada, você vai notar que alguns campos do formulário serão preenchidos para atender à integração selecionada.

<img src="/files/RKbPcksB7ryBX16sTQmK" alt="" height="783" width="556">

**Argumentos**: Este campo é preenchido automaticamente após a seleção da integração. Nele são exibidos os parâmetros necessários para que a consulta seja executada corretamente, como **CPF, Token** ou **IDs**.

Preencha cada argumento utilizando as variáveis do seu fluxo (por exemplo: {{cpf}} ou {{cliente\_id}}). Assim, o sistema utilizará os valores capturados durante a execução do fluxo para realizar a consulta de forma dinâmica.

Ao passar o mouse sobre o nome de um argumento, é possível visualizar uma breve descrição informando o que ele representa e qual informação deve ser utilizada naquele campo.

{% hint style="warning" icon="lightbulb-exclamation-on" %}
**## Dica**

Nem sempre todas as informações necessárias estarão disponíveis no fluxo. Nesses casos, utilize o componente **Entrada de Dados** para solicitar o dado ao cliente, armazená-lo em uma variável e utilizá-la no campo **Argumentos**. Isso garante que a consulta seja executada com os dados corretos.&#x20;
{% endhint %}

**Nome**: Nome interno do componente para sua organização visual dentro do construtor de fluxo.

**Mensagem**: Texto que será exibido para o cliente enquanto a integração é processada.

**Ícone de Tag**: Permite inserir variáveis dinâmicas na mensagem de espera.

**Condições**: São as ramificações de saída baseadas no retorno da integração. Na imagem de exemplo, temos:

* **F (Encontrado)**: Caminho seguido quando a busca tem sucesso.
* **NF (Não encontrado)**: Caminho para quando o dado não existe no sistema externo.
* **FM (Vários encontrados)**: Caminho para quando a busca retorna mais de um resultado.

As condições podem ser ajustadas de acordo com as regras da sua operação. Os valores exibidos inicialmente são apenas uma configuração de referência, preenchida automaticamente para facilitar a criação do fluxo.&#x20;

{% hint style="info" %}
**##Importante**

Essas condições de retorno dependem da API do cliente. Para configurar essa seção, você deve consultar a documentação ou validar com o suporte da plataforma que está integrando, para entender como montar essas condições. O que é preenchido automaticamente aqui corresponde ao que o sistema espera, com base nas configurações padrão da plataforma selecionada na integração.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/chat-center/componentes-do-fluxo/componente-fluxo-integracao.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.