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

# Create Conversation

> Crea una nueva conversación. Requiere source_id e inbox_id. Acepta userApiKey o agentBotApiKey.

Crea una conversación en el inbox indicado. Es obligatorio enviar `source_id` (identificador de origen) e `inbox_id`. Opcionalmente puedes asignar a agente o equipo, enviar un mensaje inicial y atributos personalizados.

## Autenticación

<ParamField header="api_access_token" type="string" required>
  Token de usuario (**userApiKey**) o de bot (**agentBotApiKey**).
</ParamField>

## Parámetros de ruta

<ParamField path="account_id" type="integer" required>
  ID de la cuenta.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="source_id" type="string" required>
  Identificador de origen de la conversación. Ejemplo: `1234567890`.
</ParamField>

<ParamField body="inbox_id" type="integer" required>
  ID del inbox donde se crea la conversación. Tipos permitidos: Website, Phone, Api, Email.
</ParamField>

<ParamField body="contact_id" type="integer">
  ID del contacto asociado (opcional).
</ParamField>

<ParamField body="status" type="string">
  Estado inicial: `open`, `resolved`, `pending`. Por defecto suele ser `open`.
</ParamField>

<ParamField body="assignee_id" type="integer">
  ID del agente al que se asigna la conversación.
</ParamField>

<ParamField body="team_id" type="integer">
  ID del equipo al que se asigna la conversación.
</ParamField>

<ParamField body="message" type="object">
  Mensaje inicial. Requiere `content` (string). Para WhatsApp puede incluir `template_params`.
</ParamField>

<ParamField body="additional_attributes" type="object">
  Atributos adicionales (ej. browser, os) para contexto.
</ParamField>

<ParamField body="custom_attributes" type="object">
  Atributos personalizados (clave-valor) definidos en la cuenta.
</ParamField>

<ParamField body="snoozed_until" type="string">
  Fecha/hora ISO hasta la cual la conversación queda en snooze.
</ParamField>

## Ejemplo de solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://app.yampi.ai/api/v1/accounts/1/conversations' \
    -H 'api_access_token: TU_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
      "source_id": "widget-abc-123",
      "inbox_id": 1,
      "contact_id": 10,
      "status": "open",
      "message": { "content": "Hola, necesito ayuda con mi pedido." }
    }'
  ```
</RequestExample>

## Respuesta exitosa

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "id": 100,
    "account_id": 1,
    "inbox_id": 1
  }
  ```
</ResponseExample>

<ResponseField name="id" type="number" required>
  ID de la conversación creada.
</ResponseField>

<ResponseField name="account_id" type="number">
  ID de la cuenta.
</ResponseField>

<ResponseField name="inbox_id" type="number">
  ID del inbox.
</ResponseField>

## Errores

* **403**: Access denied — sin permiso o inbox/contacto inválido.
* **401**: No autenticado.