# Usar um conector personalizado

Como importar o conector do PDF Blocks do GitHub como conector personalizado, para usar ações antes que elas cheguem ao conector publicado.

O conector **PDF Blocks** publicado no Power Automate é certificado pela
Microsoft, então novas ações e novos parâmetros chegam a ele no ritmo de
revisão da Microsoft, e não no nosso. Quando você precisa de um recurso que já
está na definição do conector, mas ainda não foi liberado no conector
publicado, como as ações de divisão e reordenação, a [seleção de
páginas](/docs/power-automate/extract-pages-from-pdf) ou as opções de
criptografia, você mesmo pode instalar a definição mais recente como um
**conector personalizado**, importando-a do GitHub.

A definição do conector é de código aberto e fica no repositório
[PowerPlatformConnectors](https://github.com/microsoft/PowerPlatformConnectors)
da Microsoft. O Power Automate consegue construir um conector personalizado
diretamente a partir dele, então você nunca copia arquivos à mão.

<Note>
  Um conector personalizado fica em um único ambiente do Power Platform e não é
  certificado. Ele funciona exatamente como o conector publicado, com as mesmas
  ações e a mesma chave de API, mas quem o mantém é você: importe de novo para
  pegar as atualizações seguintes. Quando o conector publicado alcançar essa
  definição, você pode devolver seus fluxos a ele.
</Note>

## Antes de começar

- Um plano pago do Power Automate (por usuário ou por fluxo), o mesmo requisito
  do conector publicado.
- Permissão para criar conectores personalizados no seu ambiente. Se você não
  vir **Conectores personalizados** (*Custom connectors*), fale com o
  administrador do Power Platform.
- Sua chave de API do PDF Blocks, pronta para quando você criar a conexão.
  Consulte [Primeiros passos](/docs/power-automate/getting-started) se não
  tiver uma.

## Importar o conector

<Steps>

<Step title="Abra Conectores personalizados">
  No [Power Automate](https://make.powerautomate.com), expanda o menu da
  esquerda, escolha **Mais** (*More*) e abra **Conectores personalizados**.
  (Você também chega à mesma página pelo portal do criador do Power Apps, em
  **Descobrir tudo → Conectores personalizados**.)
</Step>

<Step title="Comece um conector novo a partir do GitHub">
  Selecione **+ Novo conector personalizado** (*+ New custom connector*) e
  escolha **Importar do GitHub** (*Import from GitHub*).

  <Frame caption="Novo conector personalizado → Importar do GitHub.">
    <img
      src="/images/power-automate/use-a-custom-connector/01-new-custom-connector-menu.png"
      alt="O menu Novo conector personalizado mostrando a opção Importar do GitHub"
    />
  </Frame>
</Step>

<Step title="Selecione o conector PDF Blocks">
  Na caixa de diálogo **Importar do GitHub**:

  - Defina **Tipo de Conector** (*Connector Type*) como **Certified**: assim a
    leitura é feita na pasta de conectores certificados do repositório de
    código aberto, onde fica o PDF Blocks.
  - Escolha uma **Ramificação** (*Branch*). Use a ramificação que traz a
    atualização de que você precisa (por exemplo, `dev` para a mais recente ou
    uma ramificação de versão para uma versão fixada).
  - Defina **Conector** (*Connector*) como **PDF Blocks**.

  Selecione **Continuar** (*Continue*).

  <Frame caption="Escolha Certified, indique uma ramificação e selecione o conector PDF Blocks.">
    <img
      src="/images/power-automate/use-a-custom-connector/02-import-from-github-dialog.png"
      alt="A caixa de diálogo Importar do GitHub com Certified selecionado, a ramificação dev e o conector PDF Blocks"
    />
  </Frame>

  <Tip>
    Use o link **Click here to explore the open source repository** da caixa de
    diálogo para percorrer a definição exata antes de importar.
  </Tip>
</Step>

<Step title="Crie o conector">
  O Power Automate carrega a definição do conector no editor. Você não precisa
  mudar nada: percorra as guias **Geral** (*General*), **Segurança**
  (*Security*) e **Definição** (*Definition*) para revisá-la, se quiser, e
  depois selecione **Criar conector** (*Create connector*) no canto superior
  direito. Dê a ele um nome reconhecível (por exemplo, *PDF Blocks Next*) para
  distingui-lo do conector publicado.
</Step>

<Step title="Crie uma conexão">
  Na primeira vez que você adiciona a um fluxo uma ação do seu conector
  personalizado, o Power Automate pede os mesmos parâmetros de conexão do
  conector publicado: um **Connection Name**, sua **API Key** e um **Server
  Hostname** opcional. Consulte [Primeiros
  passos](/docs/power-automate/getting-started#etapa-2-crie-uma-conexão) para
  saber o que significa cada um.
</Step>

<Step title="Use as novas ações">
  Em um fluxo, adicione uma ação e procure o nome que você deu ao seu conector
  personalizado. As ações dele, incluindo as que ainda não estão no conector
  publicado, como [Dividir um PDF por número de
  páginas](/docs/power-automate/split-pdf-by-page-count) e [Reordenar as
  páginas de um PDF](/docs/power-automate/reorder-pages-of-pdf), aparecem ao
  lado de todas as outras, prontas para configurar.
</Step>

</Steps>

## Manter tudo atualizado

Um conector personalizado é um instantâneo da definição no momento da
importação. Quando publicarmos mais atualizações, repita **Importar do GitHub**
no mesmo conector (ou importe de novo e recrie o conector) para atualizá-lo.
Como o conector personalizado e o conector publicado são independentes, você
pode manter os dois instalados e migrar cada fluxo quando estiver pronto.

## Veja também

<CardGroup cols={2}>

<Card title="Primeiros passos" href="/docs/power-automate/getting-started">
  Configure sua primeira conexão do PDF Blocks e sua chave de API.
</Card>

<Card title="Mesclar documentos PDF" href="/docs/power-automate/merge-pdf-documents">
  Comece por uma ação essencial assim que seu conector estiver instalado.
</Card>

</CardGroup>