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

# Obtener acción durante la llamada

> Recupera información detallada sobre una acción durante la llamada concreta

<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 te permite recuperar información detallada sobre una acción durante la llamada concreta.

### Encabezados

<ParamField header="Authorization" type="string" required>
  Token Bearer para la autenticación
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Debe ser `application/json`
</ParamField>

<ParamField header="Accept" type="string" required>
  Debe ser `application/json`
</ParamField>

### Parámetros de ruta

<ParamField path="id" type="integer" required>
  El identificador único de la acción durante la llamada
</ParamField>

### Campos de respuesta

<ResponseField name="id" type="integer">
  El identificador único de la acción durante la llamada
</ResponseField>

<ResponseField name="name" type="string">
  El nombre de la acción durante la llamada
</ResponseField>

<ResponseField name="description" type="string">
  Explicación detallada de cuándo y cómo debe usar la IA esta acción durante la llamada
</ResponseField>

<ResponseField name="type" type="string">
  Tipo de acción durante la llamada: `http` o `automation`
</ResponseField>

<ResponseField name="endpoint" type="string">
  La URL del endpoint de la API que se llamará
</ResponseField>

<ResponseField name="method" type="string">
  Método HTTP (GET, POST, PUT, PATCH, DELETE)
</ResponseField>

<ResponseField name="body_format" type="string">
  Codificación del cuerpo de la solicitud: `json` o `form`
</ResponseField>

<ResponseField name="timeout" type="integer">
  Tiempo de espera de la solicitud en segundos (1-30)
</ResponseField>

<ResponseField name="headers" type="array">
  Encabezados HTTP que se enviarán con la solicitud

  <Expandable title="Propiedades de header">
    <ResponseField name="name" type="string">
      Nombre del encabezado
    </ResponseField>

    <ResponseField name="value" type="string">
      Valor del encabezado
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="static_fields" type="array">
  Pares clave/valor fijos que siempre se envían con la solicitud

  <Expandable title="Propiedades de static_fields">
    <ResponseField name="key" type="string">
      Clave del campo
    </ResponseField>

    <ResponseField name="value" type="string">
      Valor del campo
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="schema" type="array">
  Parámetros que la IA extraerá y enviará al endpoint

  <Expandable title="Propiedades de schema">
    <ResponseField name="name" type="string">
      Nombre del parámetro
    </ResponseField>

    <ResponseField name="type" type="string">
      Tipo de parámetro (string, number, float, boolean)
    </ResponseField>

    <ResponseField name="description" type="string">
      Descripción que ayuda a la IA a entender cómo extraer este parámetro
    </ResponseField>

    <ResponseField name="required" type="boolean">
      Indica si la IA debe recopilar este parámetro obligatoriamente
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created_at" type="string">
  Marca de tiempo ISO 8601 de cuándo se creó la acción durante la llamada
</ResponseField>

<ResponseField name="updated_at" type="string">
  Marca de tiempo ISO 8601 de cuándo se actualizó por última vez la acción durante la llamada
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "id": 1,
    "name": "get_weather",
    "description": "Use this tool to get the current weather in a specific city. Call this when the customer asks about weather conditions.",
    "type": "http",
    "endpoint": "https://api.openweathermap.org/data/2.5/weather?city={city}",
    "method": "GET",
    "body_format": "json",
    "timeout": 10,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      },
      {
        "name": "Authorization",
        "value": "Bearer sk_..."
      }
    ],
    "static_fields": [],
    "schema": [
      {
        "name": "city",
        "type": "string",
        "description": "The city name to get weather for",
        "required": true
      },
      {
        "name": "days",
        "type": "number",
        "description": "Number of forecast days",
        "required": false
      }
    ],
    "created_at": "2025-10-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T12:00:00.000000Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "message": "Tool not found"
  }
  ```
</ResponseExample>

### Asignar acciones durante la llamada a los asistentes

Para usar esta acción durante la llamada con un asistente, consulta:

* **[Crear asistente](/es/api-v1/assistants/create)** — Vincula acciones durante la llamada usando el parámetro `tool_ids`
* **[Actualizar asistente](/es/api-v1/assistants/update)** — Gestiona las asignaciones de acciones durante la llamada usando el parámetro `tool_ids`

<Tip>
  ¿Necesitas todo un conjunto de herramientas en lugar de crear acciones HTTP una por una? Conecta un **servidor MCP** externo: las herramientas se descubren automáticamente. Consulta [Servidores MCP](/es/api/tools-and-webhooks).
</Tip>