--- title: Conta Azul slug: conta-azul description: Improve business management for small companies with the powerful Conta Azul connector. Simplify processes, avoid errors, and save manual work through seamless integration. Configure flows and establish connections effortlessly, with real-time insights an docTags: createdAt: 2023-07-14T17:01:00.425Z --- ## Objetivo/Resumo O conector da Conta Azul é uma solução poderosa que visa simplificar a gestão empresarial para pequenas empresas. Com esse conector, as empresas podem integrar seus sistemas e processos, aproveitando os recursos e funcionalidades abrangentes oferecidos pela plataforma. O objetivo principal do conector da Conta Azul é fornecer uma conexão direta entre a Conta Azul e outros sistemas ou aplicativos utilizados pela empresa. Isso permite que os dados sejam compartilhados de forma automática e precisa, evitando erros e retrabalho manual. ### Criando um fluxo utilizando o conector Conta Azul Para criar um fluxo utilizando o conector Conta Azul é preciso criar uma conexão e em seguida configurar o fluxo. ### Criando conexão Conta Azul Primeiramente acesse sua aplicação na conta azul atravéz do link oficial da plataforma [https://portaldevs.contaazul.com/#/aplicacoes](https://portaldevs.contaazul.com/#/aplicacoes). Em seguida, selecione **Nova aplicação** se deseja criar, ou selecione uma aplicação já existente para ultilizar na Fluid. Independente se for criar ou usar uma existe, a URI de Redirecionamento terá que ser setada com o seguinte valor: [`https://console.fluidapi.io`](https://console.fluidapi.io). Isso forcenerá o consentimento para que a Fluid consiga ter acesso as credenciais da Conta Azul. Após isso crie uma conexão na Fluid, fornecendo parametros requisitados OBS: [Clique aqui](docId:1pCVN0mJbFKUjHMhj86K-) e acesse nosso passo a passo para saber como criar uma conexão. Estes são os seguintes parâmetros de configuração da conexão Conta Azul que serão requisitados na criação: - **Nome**: parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão (campo obrigatório); - **Descrição**: parâmetro padrão e opcional em qualquer criação de uma conexão, aqui você pode relatar detalhadamente para que fins servirá sua conexão; - **ID do Cliente**: informe o client\_id da aplicação (campo obrigatório); - **Chave Secreta do Cliente: **informe o client\_secret da aplicação (campo obrigatório)**;** Após preencher os campos, clique no botão **Login OAuth2 **para autorizar o consentimento da aplicação. ### Configurando fluxo Conta Azul Crie um fluxo e arraste o conector Conta Azul para o canvas. OBS: [Clique aqui](docId\:OcJTBFHi9Rerkr2d6OwIP) e acesse nosso passo a passo para saber como criar um fluxo. Selecione o conector e na aba de `Parametrização` preencha os seguintes parâmetros de configuração: - **Recurso**: entidade para qual será realizada a ação. No momento o conector dispões somente do recurso Cliente; - **Operação**: ação que será realizada para o recurso selecionado. - Operações disponiveis para recurso ***Cliente***: - **Criar cliente**: requer um corpo com o objeto cliente, podendo ser eviado utilizando [De/para](docId\:VOQdaUkjjknbSWVRHbzQW) ou [Template](docId\:TReaJH8tvdyh6uKYEAQZP); - **Atualizar cliente**: requer o ID do cliente e um corpo com o objeto do cliente contendo as informações a serem atualizadas, podendo ser enviado utilizando [De/para](docId\:VOQdaUkjjknbSWVRHbzQW) ou [Template](docId\:TReaJH8tvdyh6uKYEAQZP); - **Listar contatos do cliente**: requer ID do cliente que será usado para busca dos contatos, sendo opcional a informação da Página e da Quantidade de Itens por página; - **Obter cliente por ID**: requer o ID do cliente; - **Excluir cliente: **requer o ID do cliente; - **Inativar cliente: **requer o ID do cliente; Na aba `Propriedades` selecione a conexão desejada, dê um nome ao passo e se necessário detalhe uma descrição. ## Na prática Neste tópico criaremos um exemplo de um fluxo utilizando o conector da Conta Azul. O fluxo terá apenas um passo que será responsável pela criação de um cliente no sistema da Conta Azul. Enviaremos um payload de entrada que passará por uma transformação em nosso [De/para](docId\:VOQdaUkjjknbSWVRHbzQW), para assim enviarmos o objeto esperado pela API com os dados do cliente a ser criado. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/hHgl9nvOOCwGkdc35AR-u_image.png) ### Passo 'create' Assim ficará a `Parametrização` do nosso primeiro e único passo: ![](https://chat.google.com/u/0/api/get_attachment_url?url_type=FIFE_URL\&content_type=image%2Fpng\&attachment_token=AOo0EEW15d0Zx0bKVU%2B13zW8Ft%2FOZwxwVYOIYK6h%2BM0t7yIw0dvApkiDlPuZD2Su3%2FbjB%2FIQt3MAIBg1ymeJ75IXXAnaoXkOaHjhkk7xLiJDI5Kz%2BLfLOHnjpioUSoIvc4I8%2B%2B0YbEs3v2S857sa6WuBaQL9nUmygS5FUYYjno5VLo7rsUXaHnbFgGeXZqbJ2EJ80mmbJxdAPZTZ%2FGEjH9LXDP4Cp0RNCSoayz8mU2S9Lk9xc2rfc26VB3gi46kKoSnhSR1mYhQSkdEZA7DSso6jY3cx5kSxmdAquada8PmBZDBJgjCoxY3fbxGtp2%2B0A%2FPg3Rb2KjiGFFnU4aPeTjhSQlXFmnqgHapWctWWh0nOXXD3dtzJ8UqU%2FnM%2BbuEKSbsDch765gbi1twXgOJvB5GNGPIUdc9jI706%2BOSybBqceKB%2BNp%2B8t%2B6tpzatv3yz3RIXrRiNCxCOlYrW7caBOpJt%2BoOUvAWG%2FAb34R6RUsi4vjfoOZm1TLYsddKLBFuixQ4mYAwXaIux5LBWfX3OmWCvsPcArJHqG3WyLbNAPU5sNE2h7sCg2OY0Nd5L85kbonHQokDACuwLfr19HcGH3WuqbpemPPduhndnjsBoJQ%3D%3D\&allow_caching=true\&sz=w512) Para tratar os dados recebidos do payload de entrada usamos o [De/para](docId\:VOQdaUkjjknbSWVRHbzQW). E assim ficou nosso De/Para: ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/0jmkCcqFQateeLryX1dxw_image.png" size="70" width="597" height="527" position="center" darkWidth="597" darkHeight="527" showCaption="false"} *Para mais informações sobre como tratamos de/paras clique em *[saiba mais](docId\:VOQdaUkjjknbSWVRHbzQW)*.* Na aba `Propriedades` informamos o nome do passo e a conexão criada para a Conta Azul: ::Image[]{src="https://app.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/xDY8ktzDCyogG6ATLMaOc_image.png" size="60" width="355" height="658" position="center" darkWidth="355" darkHeight="658" showCaption="false"} ### Conclusão Com o passo configurado basta disparar o fluxo informando o payload de entrada: ```json { "name": "John C.", "company_name": "John Company", "email": "john.company@johncompany.com", "business_phone": "99 99999-9999", "mobile_phone": "99 99999-9999", "person_type": "NATURAL", "document": "00011122233", "identity_document": "00011122233", "state_registration_number": "00011122233", "state_registration_type": "NO_CONTRIBUTOR", "city_registration_number": "00011122233", "date_of_birth": "1988-12-23T08:32:10.118-05", "notes": "Important customer, always wears a green hat", "contacts": [ { "name": "John C.", "business_phone": "99 9999-9999", "email": "John.C@johncompany.com", "job_title": "Developer" } ], "address": { "zip_code": "79106-330", "street": "Rua Parma", "number": "224", "complement": "Apartamento 2058", "neighborhood": "Jardim Itália" } } ``` *Este é um payload teste disponibilizado pela propria API da Conta Azul. *[Clique aqui](https://developers.contaazul.com/)* para mais informações sobre a API Conta Azul.* ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/AoY064v6HpnxeiVyUAbjZ_image.png) Após o disparo, o resultado do fluxo aparecerá em realtime no canvas: ![](https://chat.google.com/u/0/api/get_attachment_url?url_type=FIFE_URL\&content_type=image%2Fpng\&attachment_token=AOo0EEUtAGNTbHMWC51vX2TKdBsriMQhH4VLpp3ia9BSwXFoJ1H7gaFbF%2BT8o%2FifiqE5MKqrtw2FgTGhOUXiMOf%2BoUKMvybZNoLLa5ZycUvnPi6UjCODJcJ3jWOMaS9Nm9xxQNrI%2FtQmeB37NqeA5b8KquPwmzS3JdUCrzPCNoM5um3RH7diG4YvteEWPkjfsfnkNToBoBkEJjv4S63o3N%2BbZLMX7scotTcqr9E5z1hH9k1T4RtnCu9HeLGMqxeBB7tG2lEwS4%2B9ExvMp4AHb%2FBdT4UTNxZHiJ9UXnHf9xvlbeJhmfX%2Bx%2BDIygh4o03z3nvizHAHWsnFc%2BqN7gSKm1JY5RPPXVQ1OwFMI%2BARxpeAonWqeQET6Ddw2axvSfwGR69jwfhRy%2BZx25GNd6W0OT%2FlMWhBz0aKDss2h92%2Fyxua%2Fk3hbOUr1QAMjHszkg3g286CUf1jztfT59DNVEnrgqilRVE0JrZY75anDC5dOiNnNKXUK9P0jlp9Bts1WhjntI1LrRZ%2BQQm%2B%2FU2tUgVs4CYUEOVYZfphpTujO2xUlDYwfT36zyX4ZrLkRhMpLlURFbZHQHeMqdSBtWlwwqKAK0gC7stRlUj10R%2Bw8VKzkkJu8AE%3D\&allow_caching=true\&sz=w512) Ao clicar em detalhes, temos a requisição e a resposta retornada pela Conta Azul: ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/13JFnLwPtIzt0h-ZS_9PZ_image.png)