> ## 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.

# Realizar una llamada

> Inicia una llamada telefónica saliente con un asistente de IA de Famulor específico mediante la API. Envía los datos del lead y desencadena conversaciones de voz automatizadas mediante programación.

<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 iniciar una llamada telefónica.

### Cuerpo de la solicitud

<ParamField body="phone_number" type="string" required>
  El número de teléfono del cliente en formato E.164 (p. ej. +1234567890)
</ParamField>

<ParamField body="assistant_id" type="integer" required>
  El ID del asistente con el que realizar la llamada
</ParamField>

<ParamField body="variables" type="object">
  Las variables que se pasarán al lead

  <Expandable title="Propiedades de las variables">
    <ParamField body="customer_name" type="string" default="<string>">
      El nombre del cliente
    </ParamField>

    <ParamField body="email" type="string" default="<string>">
      La dirección de correo electrónico del cliente
    </ParamField>
  </Expandable>
</ParamField>

### Respuesta

<ResponseField name="message" type="string">
  Mensaje de confirmación de que la llamada se inició correctamente
</ResponseField>

<ResponseField name="call_id" type="integer">
  El ID único de la llamada creada
</ResponseField>

<ResponseField name="status" type="string">
  El estado inicial de la llamada (p. ej. "initiated")
</ResponseField>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "message": "Call initiated successfully",
    "call_id": 480337,
    "status": "initiated"
  }
  ```

  ```json 400 Invalid Phone Number theme={null}
  {
    "message": "Invalid phone number format. Please use E.164 format (e.g. +1234567890)"
  }
  ```

  ```json 404 Assistant Not Found theme={null}
  {
    "message": "Assistant not found or does not belong to the authenticated user"
  }
  ```

  ```json 422 Insufficient Balance theme={null}
  {
    "message": "Insufficient balance to make call. Please top up your account."
  }
  ```
</ResponseExample>

<Tip>
  Páginas relacionadas: [Introducción](/es/api-v1/introduction) y [Guía de autenticación](/es/api-v1/authentication), y [Ejemplos de integración de la API](/es/api-v1/introduction).
</Tip>