---
title: "Integração com Conta Azul"
description: "Saiba como funciona a integração com o Conta Azul."
url: https://ajuda.customerx.com.br/pt-br/articles/72-integracao-com-conta-azul
collection: "Integrações - Financeiro"
updated: 2026-11-09
language: pt-br
---

# Integração com Conta Azul

Saiba como funciona a integração com o Conta Azul.

Conta Azul é uma plataforma para gestão financeira de pequenas empresas.

### Neste artigo você encontra:

-   Quais dados podem ser integrados do Conta Azul?
    
-   Quais as informações necessárias para realizar a integração?
    

### Quais dados podem ser integrados do Conta Azul?

Devido a ausência de rotas para demais informações, apenas duplicatas do financeiro (vendas) podem ser importado. Os dados importados ficam disponíveis no menu “Financeiro” no CustomerX.

> **Warning:** Importante: devido a ausência de rotas para contratos, não é possível importar contratos do Conta Azul.

A atualização dos dados ocorre diariamente, sempre buscando os dados atualizados até o dia anterior.

### Quais as informações necessárias para realizar a integração?

Para integrar o Conta Azul com o CustomerX você precisará:

-   **Definir o campo de vínculo** entre plataformas (ID do cliente, CNPJ, e-mail do contato…).
    
-   **Client\_Id** e **Client\_Secret**: Para ter acesso a estas chaves é necessário seguir o passo a passo abaixo.
    

### Acessando o Client\_Id e Client\_Secret:

**Para ter acesso a estes dados você precisará criar uma aplicação.**

1.  Primeiro passo acesse o link: [https://portaldevs.contaazul.com/#/aplicacoes](https://portaldevs.contaazul.com/#/aplicacoes). Se nunca tiver acessado essa tela, ele irá pedir o Nome da empresa e Site.
    
2.  Nesse passo basta o cliente preencher com o nome e site da sua empresa.
    
3.  Ao gravar irá aparecer a opção para criar nova aplicação. Crie uma aplicação com os dados abaixo:
    

-   **Nome Aplicação**: CustomerX
    
-   **Descrição**: Integração CustomerX
    
-   **URI de Redirecionamento**:
    
    -   **Produção**: `https://api.customerx.com.br/v1/apps/conta_azul/authorize`
        

![](https://staticfiles.gleap.io/ghelparticle/YxU4ZsXB1HZWYjKD0Xx06RyvMl8zIKwNAKZOwoETedGE02Jk4OOZ6dFojiLCiSHs1UvIm4KQmxp.png)

-   **Tipo de Software**: Online/Nuvem
    
-   **Segmento de Software**: Outro
    
-   **Descreva o Segmento**: Customer Success
    

![](https://staticfiles.gleap.io/ghelparticle/Ir5I7nzemr1jjh13ss3CiiROJpzCq7iNe2lIfap6lvKemlB6Er12bQF4fAGpkOdaW49QFUODY0q.png)

-   Clique em **Salvar e finalizar**
    
-   Envie as chaves de acesso **client\_id** e **client\_secret** para o time da CustomerX
    

![](https://staticfiles.gleap.io/ghelparticle/G8ksQ1cW9FmSkz5ET9RrlyXMQnZpWHGsck2dLBbeFA4SAH4WAEErPAwm5uJFpP2ErznP9bxXxAW.png)

> **Info:** **Procedimento realizado pela equipe da CustomerX**
>
> Após recebido os dados do passo anterior, nosso time (CustomerX) irá criar a integração utilizando o **client\_id** e **client\_secret** gerados no Conta Azul. Com ela iremos gerar a **URL para Autorização (autenticação 2 fatores)** com base nesses dados e enviaremos um link a você para dar andamento na configuração.

Ao acessarem essa URL no navegador irá abir uma página semelhante a esta para realizar o login

![](https://staticfiles.gleap.io/ghelparticle/REJfF4UpJvfbenQmHcZ0OiHM4RjdLeEFoVwhtZWVAM3tfsvMb86nivgqlMkMKJDJMEa57YWyZP5.png)

Na sequência realize a autorização clicando em **Autorizar**:

![](https://staticfiles.gleap.io/ghelparticle/5iDBQ2DWpF6aGCz8adYQUKZHt1li5VrDQu5HU8UCXbbEywI4CIYKFbiDWoSRkRtHjClHlbkjgGS.png)

Se tudo estiver configurado corretamente irá retornar uma mensagem que a autorização foi realizada com sucesso. Em caso de falha reportar ao time da CustomerX.
