# Primeros pasos

Cómo añadir una acción de PDF Blocks a un flujo de Power Automate y conectarla con su cuenta mediante una clave de API.

PDF Blocks es un conector para Power Automate, Power Apps y Azure Logic Apps.
Esta guía se centra en Power Automate, pero casi todo se puede aplicar
también a Azure Logic Apps.

## Requisitos

Para empezar a usar PDF Blocks necesita:

- Un plan de pago de Power Automate, ya sea por usuario o por flujo.
- Una cuenta de PDF Blocks. Si no tiene una, [cree una cuenta
  gratuita](https://accounts.pdfblocks.com/signup): el plan Free no necesita
  tarjeta de crédito.

## Su clave de API

Puede obtener su clave de API en su
[dashboard](https://accounts.pdfblocks.com).

Esta clave de API solo da a quien la posea (por ejemplo, su cuenta de Power
Automate) acceso al servicio de PDF Blocks. Quien tenga la clave no puede
acceder a sus documentos ni a sus datos de entrada privados, porque no
almacenamos sus documentos ni sus datos. Aun así, guárdela bien y no la
publique.

Puede revocar una clave y generar otra en cualquier momento desde el
dashboard.

## Paso 1: elija PDF Blocks

En un flujo de Power Automate, añada una acción nueva. En el panel **Add an
action**, busque PDF Blocks.

<Frame caption="Busque PDF Blocks en el panel Add an action.">
  <img src="/images/power-automate/getting-started/search-for-pdf-blocks.png" alt="Búsqueda de PDF Blocks en el panel Add an action de Power Automate" />
</Frame>

La búsqueda no siempre coloca PDF Blocks en primer lugar, así que baje por
los resultados hasta llegar al grupo **PDF Blocks**. Si no ve la acción que
quiere, seleccione **Ver más** (*See more*) en ese grupo para listar todas
las acciones de PDF Blocks y elija la que necesite.

## Paso 2: cree una conexión

La primera vez que añade una acción de PDF Blocks a un flujo, Power Automate
le pide algunos parámetros para crear una conexión:

<Frame caption="Cree una conexión en Power Automate.">
  <img src="/images/power-automate/getting-started/create-a-connection-global.png" alt="El panel de creación de conexión de Power Automate con el servidor predeterminado" />
</Frame>

Parámetros de la conexión:

- En **Connection name**, escriba el texto que quiera usar como nombre de la
  conexión. En el ejemplo anterior usamos "PDF Blocks Default".
- En **API Key**, escriba su clave de API de PDF Blocks. A medida que la
  escribe, se oculta con puntos como cualquier otra contraseña.
- En **Server Hostname**, déjelo vacío para usar el servidor predeterminado
  (`api.pdfblocks.com`).

Pulse **Crear nuevo** (*Create new*) para crear su conexión. Una vez creada,
ya puede empezar a usar PDF Blocks en cualquiera de sus flujos.

### Procesar documentos en una región concreta

Si deja **Server Hostname** vacío, PDF Blocks dirige cada solicitud a la
infraestructura más cercana para obtener la latencia más baja. Para mantener
el procesamiento en una jurisdicción concreta, escriba en su lugar el nombre
de host de esa región. Por ejemplo, para procesar exclusivamente en
servidores europeos, escriba `eu.api.pdfblocks.com` en el campo **Server
Hostname** antes de crear la conexión:

<Frame caption="Use eu.api.pdfblocks.com para procesar documentos en la UE.">
  <img src="/images/power-automate/getting-started/create-a-connection-eu.png" alt="El panel de creación de conexión de Power Automate con el nombre de host del servidor de la UE" />
</Frame>

Las regiones disponibles, y el nombre de host que hay que escribir para cada
una, dependen de su plan:

| Región                  | Server Hostname           | Disponible en                      |
| ----------------------- | ------------------------- | ---------------------------------- |
| Global (predeterminada) | _Déjelo vacío_            | Todos los planes                   |
| Estados Unidos          | `us.api.pdfblocks.com`    | Starter y Business                 |
| Unión Europea           | `eu.api.pdfblocks.com`    | Starter y Business                 |
| Reino Unido             | `uk.api.pdfblocks.com`    | Business                           |
| Canadá                  | `ca.api.pdfblocks.com`    | Business                           |
| Australia               | `au.api.pdfblocks.com`    | Business                           |
| Japón                   | `jp.api.pdfblocks.com`    | Business                           |
| India                   | `in.api.pdfblocks.com`    | Business                           |
| Brasil                  | `br.api.pdfblocks.com`    | Business                           |
| HIPAA de EE. UU.        | `hipaa.api.pdfblocks.com` | Business (requiere un BAA firmado) |

Consulte [Regiones y residencia de
datos](/docs/api/regions-and-data-residency) para conocer todos los detalles
de cada endpoint.

## Obtener ayuda

¿Necesita ayuda? Abra un ticket de soporte desde **Support** en su
[dashboard](https://accounts.pdfblocks.com). Describa el problema (puede
adjuntar archivos) y le responderemos en el mismo hilo, con notificaciones
por correo a medida que avance la conversación.

Si no puede acceder a su dashboard, escríbanos a
[support@pdfblocks.com](mailto:support@pdfblocks.com).