> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Conexões de agregador

> Conecte o Matcher aos agregadores de open finance Pluggy ou Belvo, vincule a conta do titular pela janela de consentimento do fornecedor e configure o webhook do fornecedor.

A tela **Agregadores** no módulo Matcher do Lerian Console gerencia as suas conexões com agregadores de open finance. Uma conexão de agregador liga o Matcher à Pluggy ou à Belvo, para que o Matcher possa puxar dados de conta. Os dados começam a chegar depois que o titular da conta conclui o consentimento na própria janela do fornecedor.

Para o workflow pela API, veja [Conexões de agregador](/pt/products/matcher/integrations/matcher-aggregator-connections).

## Acessando a página Agregadores

***

Vá para **Configurações → Agregadores**.

## Tabela de conexões

***

| Coluna | Descrição |
| - | - |
| **Fornecedor** | **Pluggy** ou **Belvo** |
| **Nome** | O nome da conexão |
| **URL base** | O endereço da API do fornecedor |
| **Referência da conta** | A referência do fornecedor para a conta vinculada. Ela fica vazia até você vincular uma conta |
| **Consentimento** | **Aguardando consentimento** ou **Vinculada**. Esta coluna também mostra o resultado de uma verificação de conectividade |
| **Ações** | O menu de ações da conexão |

A tabela mostra 20 conexões em cada página. Use **Anterior** e **Próximo** para navegar entre as páginas.

## Criando uma conexão

***

1. Clique em **Nova conexão**. O painel **Nova conexão de agregador** abre.

2. Preencha os campos:

   | Campo | Descrição |
   | - | - |
   | **Fornecedor** | **Pluggy** ou **Belvo** |
   | **Nome da conexão** | Um nome para a conexão. Cada conexão precisa de um nome diferente |
   | **URL base** | O endereço da API do fornecedor, por exemplo `https://api.pluggy.ai` |
   | **Referência da conta** | A referência do fornecedor para a conta (opcional). Deixe em branco para vincular a conta depois com **Conectar** |
   | **Client ID** | O client ID que o fornecedor deu a você |
   | **Segredo** | O segredo que o fornecedor deu a você |

3. Clique em **Criar conexão**.

Depois de salvar, a caixa de diálogo **Token de webhook criado** abre. Para o próximo passo, veja [Configurando o webhook do fornecedor](#setting-up-the-vendor-webhook).

## Vinculando uma conta

***

Uma conexão nova sem referência de conta mostra **Aguardando consentimento**. Para vincular a conta:

1. Abra o menu **Ações** da linha e clique em **Conectar**. A janela de consentimento do fornecedor abre.
2. O titular da conta conclui o consentimento na janela do fornecedor.
3. O Matcher salva a referência da conta que o fornecedor devolve. A linha então mostra **Vinculada**.

Se o titular da conta fechar a janela antes do fim, nada muda. Para uma conexão vinculada, o menu mostra **Reconectar**. Essa opção roda o consentimento de novo para a mesma conta.

Se o Matcher não puder salvar a referência da conta, a caixa de diálogo **Concluir o vínculo desta conta?** abre. Clique em **Salvar referência** para tentar de novo.

<h2 id="setting-up-the-vendor-webhook">
  Configurando o webhook do fornecedor
</h2>

***

O fornecedor envia notificações ao Matcher por um webhook. Abra o menu **Ações** de uma linha e clique em **Gerar token de webhook**. A caixa de diálogo **Token de webhook criado** abre.

1. Copie a **URL do webhook** da caixa de diálogo.
2. Cole a **URL do webhook** no dashboard do fornecedor.
3. Clique em **Concluir**.

## Testando uma conexão

***

Abra o menu **Ações** de uma linha e clique em **Testar credenciais**. O Matcher roda uma verificação de conectividade, e a coluna **Consentimento** mostra o resultado. Esta ação aparece apenas quando o Matcher pode testar a conexão. Ela exige uma conexão **Pluggy** que mostre **Vinculada**.

## Editando uma conexão

***

Abra o menu **Ações** de uma linha e clique em **Editar**. O painel **Editar conexão de agregador** abre.

Você não pode alterar o **Fornecedor**. Para usar outro fornecedor, exclua a conexão e crie uma nova. Deixe **Referência da conta** em branco para manter a referência armazenada. Clique em **Salvar alterações** para aplicar a alteração.

## Excluindo uma conexão

***

Abra o menu **Ações** de uma linha e clique em **Excluir**. Na caixa de diálogo **Excluir conexão?**, clique em **Excluir**. O Matcher remove a conexão, e você pode usar o nome dela em uma nova conexão. Você não pode desfazer esta ação.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.