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

# Crear conversación

> Inicia una nueva sesión de conversación con un chatbot de IA de Famulor mediante la API. Inicializa el contexto, los metadatos de usuario y el canal para WhatsApp, chat web o chat de voz.

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

Crea una nueva conversación con tu asistente de IA de Famulor. Usa este endpoint para iniciar una conversación de tipo widget o de prueba y recibir el historial inicial.

### Cuerpo de la solicitud

<ParamField body="assistant_id" type="string" required>
  UUID del asistente que debe gestionar la conversación
</ParamField>

<ParamField body="type" type="string" default="widget">
  Tipo de conversación. Opciones: `widget` (de pago) o `test` (gratis para desarrollo)
</ParamField>

<ParamField body="variables" type="object" optional>
  Variables personalizadas inyectadas en el contexto del asistente (accesibles mediante `{{variable_name}}`)

  <Expandable title="ejemplos de variables">
    <ParamField body="customer_name" type="string">
      Nombre para el saludo o la personalización
    </ParamField>

    <ParamField body="company" type="string">
      Nombre de la empresa para mencionar en las respuestas
    </ParamField>

    <ParamField body="source" type="string">
      Origen del tráfico o de la página (p. ej., `pricing_page`)
    </ParamField>
  </Expandable>
</ParamField>

### Ejemplos de solicitud

### Campos de la respuesta

<ResponseField name="status" type="boolean" required>
  Indica si la solicitud se realizó correctamente
</ResponseField>

<ResponseField name="conversation_id" type="string" required>
  UUID de la conversación creada; úsalo para los mensajes posteriores
</ResponseField>

<ResponseField name="history" type="array">
  Historial inicial de la conversación. Vacío si el asistente no tiene mensaje inicial.

  <Expandable title="elementos del historial">
    <ResponseField name="role" type="string">
      Rol del mensaje (`assistant` o `user`)
    </ResponseField>

    <ResponseField name="content" type="string">
      Contenido de texto del mensaje
    </ResponseField>
  </Expandable>
</ResponseField>

### Ejemplos de respuesta

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "status": true,
    "conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "history": [
      {
        "role": "assistant",
        "content": "Hello John Smith! Welcome to Acme Corp support. How can I help you today?"
      }
    ]
  }
  ```

  ```json 200 Success (no initial message) theme={null}
  {
    "status": true,
    "conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "history": []
  }
  ```

  ```json 404 Assistant Not Found theme={null}
  {
    "status": false,
    "error": "Assistant not found"
  }
  ```

  ```json 400 Insufficient Balance theme={null}
  {
    "status": false,
    "error": "Insufficient balance. Please top up your account."
  }
  ```
</ResponseExample>

### Notas

* Las conversaciones con `type: "widget"` se facturan; `type: "test"` es gratis para desarrollo.
* Proporciona `variables` con contenido relevante para personalizar la primera respuesta del asistente.
* Continúa el chat con [`Enviar mensaje`](/es/api-v1/ai-chatbot/send-conversation) y obtén el historial con [`Obtener conversación`](/es/api-v1/ai-chatbot/get-conversation).