# Primeiros passos Como adicionar uma ação do PDF Blocks a um fluxo do Power Automate e conectá-la à sua conta com uma chave de API. O PDF Blocks é um conector para Power Automate, Power Apps e Azure Logic Apps. Este guia se concentra no Power Automate, mas você pode aplicar quase tudo ao Azure Logic Apps também. ## Requisitos Para começar a usar o PDF Blocks, você precisa de: - Um plano pago do Power Automate, por usuário ou por fluxo. - Uma conta do PDF Blocks. Se você não tiver uma, [crie uma conta gratuita](https://accounts.pdfblocks.com/signup): o plano Free não pede cartão de crédito. ## Sua chave de API Você pode obter sua chave de API no seu [dashboard](https://accounts.pdfblocks.com). Essa chave de API dá a quem a possui (por exemplo, sua conta do Power Automate) acesso apenas ao serviço do PDF Blocks. Quem tem a chave de API não consegue acessar seus documentos nem seus dados de entrada privados, porque não armazenamos seus documentos nem seus dados. Ainda assim, guarde-a em segurança e não a publique. Você pode revogar uma chave e gerar outra a qualquer momento pelo dashboard. ## Etapa 1: escolha o PDF Blocks Em um fluxo do Power Automate, adicione uma nova ação. No painel **Add an action**, procure PDF Blocks. <Frame caption="Busca por PDF Blocks no painel Add an action."> <img src="/images/power-automate/getting-started/search-for-pdf-blocks.png" alt="Busca por PDF Blocks no painel Add an action do Power Automate" /> </Frame> A busca nem sempre coloca o PDF Blocks em primeiro lugar, então role os resultados até chegar ao grupo **PDF Blocks**. Se você não encontrar a ação que quer, selecione **Ver mais** (*See more*) nesse grupo para listar todas as ações do PDF Blocks e escolha a de que precisa. ## Etapa 2: crie uma conexão Na primeira vez que você adiciona uma ação do PDF Blocks a um fluxo, o Power Automate pede alguns parâmetros para criar uma conexão: <Frame caption="Criação de uma conexão no Power Automate."> <img src="/images/power-automate/getting-started/create-a-connection-global.png" alt="O painel de criação de conexão do Power Automate com o servidor padrão" /> </Frame> Parâmetros da conexão: - Em **Connection name**, escreva o texto que você quiser usar como nome da conexão. No exemplo acima, usamos “PDF Blocks Default”. - Em **API Key**, escreva sua chave de API do PDF Blocks. Conforme você digita, ela é mascarada por pontos, como qualquer outra senha. - Em **Server Hostname**, deixe em branco para usar o servidor padrão (`api.pdfblocks.com`). Pressione **Criar** (*Create new*) para criar sua conexão. Depois que a conexão estiver criada, você já pode começar a usar o PDF Blocks em qualquer um dos seus fluxos. ### Processar documentos em uma região específica Deixe **Server Hostname** em branco e o PDF Blocks roteia cada requisição para a infraestrutura mais próxima, em busca da menor latência. Para manter o processamento em uma jurisdição específica, informe o nome de host daquela região. Por exemplo, para processar exclusivamente em servidores europeus, escreva `eu.api.pdfblocks.com` no campo **Server Hostname** antes de criar a conexão: <Frame caption="Use eu.api.pdfblocks.com para processar documentos na UE."> <img src="/images/power-automate/getting-started/create-a-connection-eu.png" alt="O painel de criação de conexão do Power Automate com o nome de host do servidor da UE" /> </Frame> As regiões disponíveis, e o nome de host que você informa para cada uma, dependem do seu plano: | Região | Server Hostname | Disponível em | | -------------------- | ------------------------- | --------------------------------- | | Global (padrão) | _Deixe em branco_ | Todos os planos | | Brasil | `br.api.pdfblocks.com` | Business | | Estados Unidos | `us.api.pdfblocks.com` | Starter e Business | | União Europeia | `eu.api.pdfblocks.com` | Starter e Business | | Reino Unido | `uk.api.pdfblocks.com` | Business | | Canadá | `ca.api.pdfblocks.com` | Business | | Austrália | `au.api.pdfblocks.com` | Business | | Japão | `jp.api.pdfblocks.com` | Business | | Índia | `in.api.pdfblocks.com` | Business | | HIPAA Estados Unidos | `hipaa.api.pdfblocks.com` | Business (requer um BAA assinado) | Consulte [Regiões e residência de dados](/docs/api/regions-and-data-residency) para todos os detalhes de cada endpoint. ## Obter ajuda Precisa de ajuda? Abra um ticket de suporte em **Support**, no seu [dashboard](https://accounts.pdfblocks.com). Descreva o problema (você pode anexar arquivos) e responderemos no mesmo tópico, com notificações por e-mail conforme a conversa avançar. Se você não conseguir acessar seu dashboard, escreva para [support@pdfblocks.com](mailto:support@pdfblocks.com).