> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Aplicar plantilla de automatización

> Crea una automatización de Famulor a partir de una plantilla lista para usar y compruébala con una ejecución de prueba real.

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint crea una automatización a partir de una plantilla (consulta [Listar plantillas de automatización](/es/api-v1/automations/list-templates)), ejecuta una prueba real y —en el caso de las plantillas de eventos de asistente— vincula la automatización al asistente una vez que la prueba se supera. Devuelve el mismo formato de respuesta que [Crear automatización](/es/api-v1/automations/create).

<Warning>
  Las plantillas marcadas con `side_effects: true` realmente envían mensajes o inician llamadas durante su ejecución de prueba: aplicarlas requiere `confirm_side_effects: true`, y la prueba se dirige a los valores reales que has proporcionado. Nunca apliques una plantilla con valores de ejemplo o inventados.
</Warning>

### Parámetros de ruta

<ParamField path="key" type="string" required>
  La clave de la plantilla (obtenida de [Listar plantillas de automatización](/es/api-v1/automations/list-templates)). Una clave desconocida devuelve un `404`.
</ParamField>

### Cuerpo de la solicitud

<ParamField body="params" type="object">
  Los parámetros de la plantilla como pares clave-valor; consulta la lista `params` de la plantilla para saber qué necesita cada uno. Los parámetros obligatorios que falten devuelven un `422` (`missing_params`) con el detalle exacto de lo que se necesita. Máx. 64 KB.
</ParamField>

<ParamField body="assistant_id" type="integer">
  El asistente al que se vincula la automatización resultante. Obligatorio para plantillas con `requires_assistant: true`.
</ParamField>

<ParamField body="name" type="string">
  Un nombre personalizado para la automatización (máx. 255 caracteres); por defecto usa el nombre de la plantilla
</ParamField>

<ParamField body="confirm_side_effects" type="boolean">
  Obligatorio (`true`) para plantillas marcadas con `side_effects: true`
</ParamField>

### Respuesta

El mismo formato de [Crear automatización](/es/api-v1/automations/create): `automation_id`, `webhook_url` (para plantillas activadas por webhook, como `lead-intake-webhook` y las de consulta durante la llamada; `null` para plantillas de eventos de asistente), `status` (`active` / `active_untested` / `test_failed`), `test` (`run_status` + resultado por paso), `response`, `binding`. Devuelve `201` cuando la automatización está activa y `200` cuando su ejecución de prueba falla.

Una plantilla cuya ejecución de prueba se detiene en un paso de Retraso (p. ej. `post-call-callback`) reporta `run_status: "PAUSED"`; eso es un éxito, no un fallo: todos los pasos anteriores al retraso se ejecutaron, y la ejecución se reanuda en el momento previsto.

### Códigos de error (422)

Los fallos graves devuelven `{"message": "...", "error": "<code>", "params": ...}` y no se crea nada. Códigos destacados:

| error                                                             | Significado                                                                                                                                                     |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `missing_params`                                                  | Faltan parámetros obligatorios: el array `params` de la respuesta indica sus especificaciones completas.                                                        |
| `invalid_param_choice`                                            | Un parámetro hace referencia a un recurso (p. ej. una hoja de cálculo) que no existe en tu cuenta conectada; el mensaje enumera las opciones reales por nombre. |
| `needs_connection` / `needs_reconnection`                         | Falta una conexión de cuenta obligatoria, o está rota; el mensaje contiene los pasos exactos para solucionarlo en la app de Famulor (una sola vez).             |
| `side_effects_require_confirmation`                               | La plantilla envía datos de verdad: vuelve a intentarlo con `confirm_side_effects: true`.                                                                       |
| `assistant_required` / `assistant_not_found` / `binding_conflict` | Igual que en [Crear automatización](/es/api-v1/automations/create).                                                                                             |

<ResponseExample>
  ```json 201 Created (test passed and attached) theme={null} theme={null}
  {
    "automation_id": "aB3xYz01MnOpQrStUvWxY",
    "webhook_url": null,
    "status": "active",
    "test": {
      "run_status": "SUCCEEDED",
      "steps": []
    },
    "response": null,
    "binding": {
      "type": "post_call",
      "assistant_id": 123,
      "bound": true
    }
  }
  ```

  ```json 422 Validation Error theme={null} theme={null}
  {
    "message": "These values are required: spreadsheet_id. Ask the user for them — never guess or reuse example values.",
    "error": "missing_params",
    "params": [
      {
        "key": "spreadsheet_id",
        "label": "Google Spreadsheet ID",
        "description": "The spreadsheet to append rows to.",
        "required": true,
        "example": "1AbCdEfGhIjKlMnOpQrStUvWxYz"
      }
    ]
  }
  ```

  ```json 404 Not Found theme={null} theme={null}
  {
    "message": "No template with that key — call the template list first.",
    "error": "template_not_found",
    "params": null
  }
  ```
</ResponseExample>

<Tip>
  Páginas relacionadas: [Listar plantillas de automatización](/es/api-v1/automations/list-templates), [Crear automatización](/es/api-v1/automations/create), y [Autenticación](/es/api-v1/authentication).
</Tip>