> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar e gerenciar uma integração

> Conecte uma integração, altere as configurações dela, verifique a conexão e desconecte-a.

Todas as integrações do Foliant são conectadas e gerenciadas da mesma forma: você as conecta em **Configurações › Integrações** e depois usa a página de cada uma para alterar configurações, acompanhar a atividade e desconectá-la. O Peppol e-invoicing tem uma página própria; veja [Configurar o Peppol e-invoicing](https://foliant-help.iforiti.com/pt-BR/integrations/peppol-e-invoicing.md).

![Cartões de integração na página Integrações](https://mintcdn.com/foliant-dev/AoWxppgqeHqT1nDZ/integrations/images/integrations-catalogue.png?fit=max\&auto=format\&n=AoWxppgqeHqT1nDZ\&q=85\&s=89c680acff341543f0941a9aaf6c9074)

## Antes de começar

A integração precisa estar incluída no seu plano. Se não estiver, o cartão dela mostra o plano ou o complemento que a inclui, e **Ver planos**. Veja [Integrações pausadas e faturamento](https://foliant-help.iforiti.com/pt-BR/integrations/paused-integrations-and-billing.md).

## Conectar uma integração

1. No Foliant, acesse **Configurações › Integrações**.
2. No cartão da integração, clique em **Conectar**. Você também pode abrir a página da integração e clicar em **Conectar** lá.
3. Em **Conectar** seguido do nome da integração, preencha o que for pedido (veja abaixo).
4. Clique em **Conectar** ou, nas integrações em que você faz login, em **Continuar para** o serviço.

Quando ela é conectada, o Foliant mostra uma mensagem, como "Webhooks conectado", e abre a página da integração.

### O que uma integração pede

| Tipo de integração | O que você faz |
| - | - |
| Login no outro serviço | "Você vai fazer login no" serviço "e escolher a conta a conectar." Clique em **Continuar para** o serviço, faça login lá e autorize. Você volta ao Foliant quando terminar. |
| Chave de API | Cole uma chave de API da sua conta no serviço. |
| Um formulário de configurações | Informe os dados pedidos e clique em **Conectar**. |
| Nada a preencher | Clique em **Conectar** para ativá-la na sua loja. |

Os campos obrigatórios precisam ser preenchidos antes de conectar: "Preencha este campo para continuar." Valores secretos, como chaves e segredos de assinatura, são armazenados de forma criptografada e nunca mais são exibidos.

Se a conexão falhar, o Foliant mostra o problema na janela, por exemplo "não foi possível conectar. Verifique os dados e tente novamente." Se você fez login no outro serviço e não funcionou, a página da integração mostra um banner informando que ela não foi conectada, com o motivo.

## A página da integração

Abra-a pelo cartão (**Gerenciar**) ou clicando no nome dela.

| Parte | O que mostra |
| - | - |
| Cabeçalho | A categoria, o nome da conta conectada, o status e um selo **Beta** se ela estiver em beta. **Artigo de ajuda** abre a página de ajuda dela, quando houver. |
| **Uso neste período** | Para integrações com franquia mensal: quanto você já usou. |
| **Configurações** | As configurações da integração. Um selo **Verificada** mostra quando o Foliant confirmou pela última vez que a conexão funciona. |
| **Atividade** | O que o Foliant enviou pela integração. Veja [Atividade da integração](https://foliant-help.iforiti.com/pt-BR/integrations/integration-activity.md). |
| **Conexão** | A conta conectada, o ID dela, o status, quando ela foi conectada e quando foi verificada pela última vez. |
| **Faturamento** | O que inclui a integração, o preço, a franquia mensal e o preço depois dela. |
| **Desconectar** | Desconecta a integração. |

## Alterar as configurações

1. Abra a página da integração.
2. Altere os campos em **Configurações**. Uma barra de salvamento aparece.
3. Clique em **Salvar**.

Deixe um campo secreto em branco para manter o valor salvo: ele mostra "Salvo. Deixe em branco para manter."

## Banners na página

| Banner | O que fazer |
| - | - |
| "Aguardando" o serviço "confirmar a conexão." | Nada. Ela fica conectada assim que o serviço confirmar. |
| **requer atenção** | Leia o motivo no banner e corrija. Clique em **Reconectar** para conectar de novo. |
| **está pausada** | A integração não envia nada até ser retomada. Veja [Integrações pausadas e faturamento](https://foliant-help.iforiti.com/pt-BR/integrations/paused-integrations-and-billing.md). |

O Foliant verifica cada conexão regularmente. Se uma verificação falhar, a integração mostra **Requer atenção** até voltar a funcionar.

## Desconectar uma integração

1. Abra a página da integração.
2. Em **Desconectar**, clique em **Desconectar** seguido do nome da integração.
3. Confirme com **Desconectar**.

O Foliant para de enviar trabalho para a integração. Seu plano e seus complementos continuam como estão, então você continua pagando por um complemento até removê-lo. Você pode conectar a integração de novo a qualquer momento.

## Artigos relacionados

* [Explorar integrações](https://foliant-help.iforiti.com/pt-BR/integrations/integrations-catalogue.md)
* [Atividade da integração](https://foliant-help.iforiti.com/pt-BR/integrations/integration-activity.md)
* [Integrações pausadas e faturamento](https://foliant-help.iforiti.com/pt-BR/integrations/paused-integrations-and-billing.md)
* [Enviar webhooks para o seu próprio sistema](https://foliant-help.iforiti.com/pt-BR/integrations/webhooks.md)
* [Salvar faturas emitidas no Google Drive ou no Dropbox](https://foliant-help.iforiti.com/pt-BR/invoices-and-numbering/cloud-archive.md)


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