# Inicio rápido: crear una plantilla

Este ejemplo guarda una plantilla que abre una URL proporcionada en tiempo de ejecución y devuelve la dirección final tras cualquier redirección. Ejecuta los fragmentos en orden en una misma sesión de Bash en macOS o Linux; en Windows, usa WSL. Necesitas el cliente de escritorio de MoreLogin V2.73.0 o posterior, curl 7.76 o posterior, jq y uuidgen. Conserva los archivos generados: el [ejemplo de ejecución](/es/browser-rpa/run-api-example) y la [recuperación de solicitudes](/es/browser-rpa/local-api#recuperaci%C3%B3n) los usan.

## 1. Consultar las capacidades y los contratos

Usa como puerto el de la Local API que muestra el cliente de MoreLogin. Los comandos trabajan en un directorio temporal privado, porque las respuestas reales de plantillas y ejecuciones pueden contener valores sensibles.

```bash
umask 077
RPA_BASE_URL='http://127.0.0.1:40000/api/rpa/browser/v1'
RPA_DIR="$(mktemp -d)" && cd "$RPA_DIR"
rpa_curl() {
  curl --fail-with-body -sS --max-time 30 "$@"
}
```

Si habilitaste la autenticación de la Local API, agrega el encabezado `Authorization` descrito en [Autenticación](/es/api-reference/getting-started/authentication) al comando `curl` de `rpa_curl`.

Comprueba que el cliente admita las operaciones que usa este ejemplo y registra la revisión del catálogo. Las solicitudes de escritura la vuelven a enviar en el encabezado `X-RPA-Catalog-Revision`.

```bash
rpa_curl "$RPA_BASE_URL/capabilities" -o capabilities.json &&
jq '.data | {operations, limits, docs}' capabilities.json &&
jq -e '.data.operations as $ops | ["listNodeTypes","getNodeType","validateWorkflow","createTemplate"] - $ops | length == 0' capabilities.json &&
RPA_CATALOG_REVISION="$(jq -er '.data.catalogRevision' capabilities.json)"
```

Lee los contratos de los cuatro tipos de nodo del ejemplo. El último comando solo se completa correctamente si, según cada contrato, el nodo se puede usar al crear flujos, es compatible en tiempo de ejecución, se puede ejecutar mediante la API y está completamente documentado. [Campos comunes y estructura del flujo](/es/browser-rpa/node-contract-guide) explica cada campo del contrato.

```bash
rpa_curl --get "$RPA_BASE_URL/node-types" --data-urlencode 'q=gotoUrl' -o node-types.json &&
rpa_curl "$RPA_BASE_URL/node-types/start" -o start.contract.json &&
rpa_curl "$RPA_BASE_URL/node-types/end" -o end.contract.json &&
rpa_curl "$RPA_BASE_URL/node-types/browser_gotoUrl" -o browser_gotoUrl.contract.json &&
rpa_curl "$RPA_BASE_URL/node-types/browser_getUrl" -o browser_getUrl.contract.json &&
jq -s -e 'all(.[]; .data | .authorable and .runtimeSupported and .externalRunnable and .documentationComplete)' *.contract.json
```

Los agentes de IA pueden empezar por las guías locales: `rpa_curl "$RPA_BASE_URL/llms.txt"` enumera la Skill (`/docs/SKILL.md`) y la guía de la API. Las rutas que empiezan por `/` se resuelven respecto a `http://127.0.0.1:<port>`.

## 2. Validar el candidato completo

Guarda el siguiente cuerpo como `create.json`. Asigna a cada nodo un título que describa lo que hace. El nodo `end` devuelve su `message` como `outputs.result` de la ejecución; aquí, el mensaje es la salida `data.value` del nodo `url_result`.

```json
{
  "title": "Return the final page URL",
  "description": "Visit the supplied page and return its final URL",
  "workflow": {
    "editorVersion": 2,
    "editorParametersVersion": 1,
    "variables": {
      "type": "object",
      "properties": {
        "targetUrl": {
          "type": "string",
          "description": "Absolute HTTP(S) URL to open"
        }
      },
      "required": [
        "targetUrl"
      ]
    },
    "nodes": [
      {
        "id": "start",
        "type": "start",
        "data": {
          "title": "Read the target URL parameter"
        }
      },
      {
        "id": "visit",
        "type": "browser_gotoUrl",
        "data": {
          "browserAction": "gotoUrl",
          "browserUi": {
            "inputs": {
              "url": "${targetUrl}",
              "postWaitMs": 0
            },
            "exception": {
              "timeout": 30000,
              "policy": "interrupt"
            }
          },
          "title": "Open the supplied page"
        }
      },
      {
        "id": "url_result",
        "type": "browser_getUrl",
        "data": {
          "browserAction": "getUrl",
          "browserUi": {
            "inputs": {
              "type": "href"
            },
            "exception": {
              "timeout": 30000,
              "policy": "interrupt"
            }
          },
          "title": "Read the final URL after navigation"
        }
      },
      {
        "id": "end",
        "type": "end",
        "data": {
          "inputsValues": {
            "status": {
              "type": "constant",
              "content": "success"
            },
            "message": {
              "type": "ref",
              "content": [
                "url_result",
                "data",
                "value"
              ]
            }
          },
          "title": "Report the final page URL"
        }
      }
    ]
  },
  "dependencies": []
}
```

```bash
jq '{purpose:"save",source:{kind:"inline",template:.}}' create.json > validate-save.json &&
rpa_curl "$RPA_BASE_URL/validations" -H 'Content-Type: application/json' \
  --data-binary @validate-save.json -o validation-save.json &&
jq '.data | {valid,issues,truncated,runtimeChecks}' validation-save.json &&
jq -e '.data.valid == true and .data.truncated == false' validation-save.json
```

Lee el informe de validación, incluidas las advertencias y las comprobaciones en tiempo de ejecución. Continúa solo cuando `valid` sea `true` y el informe no esté truncado. La validación no abre ningún navegador.

## 3. Guardar la plantilla y registrar la versión

```bash
([ -s create.key ] || uuidgen > create.key) &&
rpa_curl "$RPA_BASE_URL/templates" -H 'Content-Type: application/json' \
  -H "X-RPA-Catalog-Revision: $RPA_CATALOG_REVISION" \
  -H "Idempotency-Key: $(cat create.key)" \
  --data-binary @create.json -D created.headers -o created.json &&
head -n 1 created.headers &&
jq '.data | {id,version,revisionId,warnings}' created.json
```

HTTP 201 significa que la plantilla se guardó. Conserva la respuesta normalizada, que incluye el flujo de trabajo, el ID, la versión y el ID de revisión, y también el `ETag` de `created.headers`. La clave de `create.key` identifica esta intención de escritura: reutilízala solo para reintentar la misma solicitud y genera una clave nueva para cada escritura nueva. Si se agota el tiempo de espera de la solicitud, sigue los pasos de [recuperación de solicitudes](/es/browser-rpa/local-api#recuperaci%C3%B3n) antes de enviar otra escritura.

Cuando se actualice la lista de plantillas, la plantilla también aparecerá en **Plantillas personalizadas** del cliente de escritorio. Para modificarla más adelante, lee su versión más reciente, valida el candidato completo con `source.base` y envía la edición con su `If-Match` actual. Consulta [Editar una plantilla existente](/es/browser-rpa/local-api#editar-una-plantilla-existente).

Siguiente paso: [ejecutar la plantilla guardada con la API](/es/browser-rpa/run-api-example).