--- title: Módulo 3: Criando Fluxos slug: modulo-3-criando-fluxos description: Learn how to configure flows and integrations between systems to enhance productivity, minimize errors, and optimize efficiency in your processes. This comprehensive guide outlines the step-by-step process of accessing the platform's Canvas, seamlessly in icon: {"faIcon":"fa-solid fa-graduation-cap"} docTags: createdAt: 2023-09-26T22:13:07.780Z --- ## Entendendo os Fluxos Um [Fluxo](docId\:WTZWYEZQPk5bX-oJ0t938), que pode ser composto por múltiplos [passos](docId\:L87LOzWYx4DwESkNsOPvI), [Rules](docId\:lgqSmyrXokYm9hGjtOtKL), e mapeamentos de dados [De/para](docId\:VOQdaUkjjknbSWVRHbzQW), é essencial para que diferentes sistemas se comuniquem de maneira eficiente e integrada. Essa integração é fundamental para empresas e projetos que buscam aumentar a produtividade, reduzir erros e melhorar a eficiência em seus processos. Vamos explorar juntos como configurar fluxos e integrações entre sistemas? ## Passo 1: Acesso ao Canvas - Primeiro, acesse o [Canvas](docId:1q9GPDJoZXjsKAaG7_b2P) da plataforma, isso pode ser feito de duas formas, a primeira delas através do início rápido localizado na [Dashboard](docId\:rKCZbtfhIHbkvThpFZQHt) demonstrada abaixo: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/Rj2ySGDVKBh_uKlx2SwEF_animation1.gif) - A segunda forma é através do menu de Fluxos como mostraremos a seguir: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/9MYimD-9mFkyJULAmfgsl_animation2.gif) ## Passo 2: Adicionar um passo com um conector HTTP Dentro do [Canvas](docId:1q9GPDJoZXjsKAaG7_b2P) iremos criar um fluxo simplificado. Ele será composto de apenas um [passo](docId\:fj3eoMx0UlDO0WvxJXsLG) e portanto apenas um conector, neste caso, o [HTTP](docId:-IX6fj1xXMa6nvQnOl8Mx). Para tanto iremos localizá-lo dentre os conectores disponíveis na lateral esquerda da tela e arrastá-lo para o centro do [Canvas](docId:1q9GPDJoZXjsKAaG7_b2P). ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/OyuuHwvxzLwWvfXKQwuMx_animation3.gif) ## Passo 3: Configurar o passo do conector HTTP Com o passo do Conector [HTTP](docId:-IX6fj1xXMa6nvQnOl8Mx) adicionado, você precisará configurá-lo. Para isso, selecione o passo que arrastamos para o [Canvas](docId:1q9GPDJoZXjsKAaG7_b2P) no passo anterior. Com o passo selecionado, vamos configurar 3 campos. São eles: - Renomear o passo - Definir método como "GET". - Inserir a URL da API: [`https://random-data-api.com/api/v2/users`](https://random-data-api.com/api/v2/users.) ### Nomeando um passo A partir da atualização mais recente, cada [passo](docId\:fj3eoMx0UlDO0WvxJXsLG) pode ter dois nomes distintos: - **Identificador do Passo:** - Nome técnico, usado internamente e em referências dentro dos fluxos. - Deve ser único, sem espaços ou caracteres especiais. - Exemplo: `consultaPedidos`, `enviarNotificacao`. - **Nome de Visualização do Passo:** - Nome opcional que aparece no editor visual. - Destinado a melhorar a legibilidade para o usuário. - Se não for informado, o identificador será exibido por padrão. - Exemplo: `Consulta de Pedidos`, `Enviar Notificação`. ### Renomeando um passo :::hint{type="warning"} Note que o passo arrastado para o [Canvas](docId:1q9GPDJoZXjsKAaG7_b2P) sempre virá com seu **identificador **padrão. Neste caso, como é o primeiro passo que arrastamos, será **passo-1. **Sempre que um identificador de passo for alterado o sistema mostrará a seguinte informação: ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/GPU4Z9eQDVEaWRh1hNhYT_image.png" size="50" width="955" height="912" position="center" darkWidth="800" darkHeight="764" showCaption="false"} Esta mensagem existe para minimizar erros em seus [Fluxos](docId\:xXUJHPIOdzUgyXWt8Rahi). Abordaremos esse tema de forma mais detalhada em módulos futuros. ::: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/ajTv27549aAchyXlci7EO_nomear.gif) ### Selecionando o verbo ou método Com o nome do passo definido, vamos selecionar o **verbo/método. **Um **verbo/método** definirá a ação executada neste passo. Neste caso precisaremos fazer um [GET](docId:7kR50cRQV67FwcDjaR3AW). ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/8H4ZI2QOuRPLllpIVsYrJ_animation5.gif) ### Inserindo a URL da API de testes Para que isso ocorra, vamos informar a URL em que o passo [HTTP](docId:-IX6fj1xXMa6nvQnOl8Mx) encontrará os dados necessários. Para este exemplo usaremos a [`https://random-data-api.com/api/v2/users`](https://random-data-api.com/api/v2/users). Vamos inserir esta URL no campo correspondente. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/ZUaHTB0Il9CPrGH2AmqRg_animation6.gif) :::hint{type="info"} É importante lembrar que podemos salvar um passo parametrizado em [Meus Modelos](docId\:aH1ORHI25aV1dsH6w9JjT). Desta forma, caso esteja utilizando um passo múltiplas vezes e queira economizar tempo ao parametrizá-lo, ele ficará disponível em sua biblioteca de modelos configurado da forma em que foi salvo. Para acessá-lo basta selecioná-lo na aba "Meus modelos" como ilustrado abaixo: ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/D6BAOjSEGVnoUxMWoaIAO_image.png" size="50" width="449" height="299" position="center" darkWidth="800" darkHeight="533" showCaption="false"} ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/hP9PnXHn2xWHYNt1Ah_0-_image.png" size="50" width="857" height="327" position="center" darkWidth="800" darkHeight="305" showCaption="false"} ::: ## Passo 4: Testando o passo HTTP Antes de prosseguir, é uma boa prática testar o passo do Conector [HTTP](docId:-IX6fj1xXMa6nvQnOl8Mx) para garantir que ele esteja funcionando corretamente. Isso permitirá que você veja os dados que estão sendo retornados pela API. Para isso vamos seguir da seguinte forma: - Conectar o passo ao gatilho (representado pelo botão verde de *play*) - Disparar o teste do fluxo ### Conectando o passo ao gatilho Para conectar o passo ao gatilho de disparo é muito simples, basta clicar na parte indicada e arrastar até que se conecte com o passo como demonstrado a seguir: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/fEapmzSVXrIwz-C4J-NSs_animation7.gif) :::hint{type="info"} Eem caso de diversos passos, basta repetir o processo quantas vezes for necessário. Sempre respeitando a ordem da esquerda para a direita. ::: ### Disparando o teste do fluxo Para testar o fluxo recém criado, iremos clicar no gatilho, nos será apresentada a opção de usar um payload, neste exemplo iremos realizar o teste sem informar um payload. :::hint{type="info"} Ao iniciar o teste, caso o seu [Fluxo](docId\:WTZWYEZQPk5bX-oJ0t938) ainda não tenha sido renomeado, você receberá uma mensagem sugerindo que atribua um nome. É uma prática recomendada nomear seus [Fluxos](docId\:xXUJHPIOdzUgyXWt8Rahi) de maneira significativa para facilitar a gestão futura. Neste exemplo chamei o nosso [Fluxo](docId\:WTZWYEZQPk5bX-oJ0t938) de **fluxo-de-teste.** ::: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/QQAyipErZNUfbPzM0Sltt_animation8.gif)