> ## 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.

# Ligar e gerir uma integração

> Ligue uma integração, altere as definições, verifique a ligação e desligue-a.

Todas as integrações do Foliant são ligadas e geridas da mesma forma: ligue-as em **Definições › Integrações** e, depois, use a página da integração para alterar as definições, acompanhar a atividade e desligá-la. A faturação eletrónica Peppol tem uma página própria; consulte [Configurar a faturação eletrónica Peppol](https://foliant-help.iforiti.com/pt-PT/integrations/peppol-e-invoicing.md).

![Cartões de integrações 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 tem de estar incluída no seu plano. Se não estiver, o cartão mostra o plano ou o suplemento que a inclui e **Ver planos**. Consulte [Integrações em pausa e faturação](https://foliant-help.iforiti.com/pt-PT/integrations/paused-integrations-and-billing.md).

## Ligar uma integração

1. No Foliant, aceda a **Definições › Integrações**.
2. No cartão da integração, clique em **Ligar**. Também pode abrir a página da integração e clicar em **Ligar** aí.
3. Em **Ligar** seguido do nome da integração, preencha o que for pedido (ver abaixo).
4. Clique em **Ligar** ou, nas integrações em que inicia sessão, em **Continuar para** o serviço.

Quando a integração fica ligada, o Foliant mostra uma mensagem, como "Webhooks ligado", e abre a página da integração.

### O que uma integração pede

| Tipo de integração | O que fazer |
| - | - |
| Iniciar sessão no outro serviço | "Vai iniciar sessão em" o serviço "e escolher a conta a ligar." Clique em **Continuar para** o serviço, inicie sessão aí e aprove. Quando terminar, regressa ao Foliant. |
| Chave de API | Cole uma chave de API da sua conta no serviço. |
| Um formulário de definições | Introduza os dados pedidos e clique em **Ligar**. |
| Nada a preencher | Clique em **Ligar** para a ativar na sua loja. |

Os campos obrigatórios têm de ser preenchidos antes de poder ligar: "Preencha este campo para continuar." Os valores secretos, como chaves e segredos de assinatura, são guardados encriptados e nunca voltam a ser mostrados.

Se a ligação falhar, o Foliant mostra o problema na janela, por exemplo "não foi possível ligar. Verifique os dados e tente novamente." Se iniciou sessão no outro serviço e não funcionou, a página da integração mostra uma faixa a indicar que não foi ligada, com o motivo.

## A página da integração

Abra-a a partir do cartão (**Gerir**) ou clicando no nome da integração.

| Secção | O que mostra |
| - | - |
| Cabeçalho | A categoria, o nome da conta ligada, o estado e um distintivo **Beta** se estiver em beta. **Artigo de ajuda** abre a respetiva página de ajuda, quando existe. |
| **Utilização neste período** | Nas integrações com uma quota mensal: o que já utilizou. |
| **Definições** | As definições da integração. Um distintivo **Verificado** mostra quando o Foliant confirmou pela última vez que a ligação funciona. |
| **Atividade** | O que o Foliant enviou através da integração. Consulte [Atividade das integrações](https://foliant-help.iforiti.com/pt-PT/integrations/integration-activity.md). |
| **Ligação** | A conta a que está ligada, o respetivo ID, o estado, quando foi ligada e quando foi verificada pela última vez. |
| **Faturação** | O que inclui a integração, o preço, a quota mensal e o preço a partir daí. |
| **Desligar** | Desliga a integração. |

## Alterar as definições

1. Abra a página da integração.
2. Altere os campos em **Definições**. Aparece uma barra para guardar.
3. Clique em **Guardar**.

Deixe um campo secreto em branco para manter o valor guardado: o campo mostra "Guardado. Deixe em branco para o manter."

## Faixas na página

| Faixa | O que fazer |
| - | - |
| "A aguardar que" o serviço "confirme a ligação." | Nada. Fica ligada assim que o serviço confirmar. |
| **requer atenção** | Leia o motivo na faixa e corrija-o. Clique em **Voltar a ligar** para ligar novamente. |
| **está em pausa** | A integração não envia nada até ser retomada. Consulte [Integrações em pausa e faturação](https://foliant-help.iforiti.com/pt-PT/integrations/paused-integrations-and-billing.md). |

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

## Desligar uma integração

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

O Foliant deixa de enviar trabalho para a integração. O seu plano e os seus suplementos mantêm-se, por isso continua a pagar um suplemento até o remover. Pode voltar a ligar a integração em qualquer altura.

## Artigos relacionados

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


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