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

# Asignar buzón

> Mueve la conversación a un buzón o categoría

<Info>
  **Endpoint** · `POST /conversation/actions`
</Info>

Mueve la conversación a un buzón o a una categoría. Exactamente **uno** de
`mailbox` | `category`, nunca ambos.

**Campos**

* Exactamente **uno** de `mailbox` — `{ name }` del buzón — o `category` — `{ name }` de la categoría (nunca ambos).

```jsonc theme={null}
{
  "type": "assign_mailbox",
  "mailbox": { "name": "Ventas" }
}
{
  "type": "assign_mailbox",
  "category": { "name": "Soporte" }
}
```

En una lista, este objeto va en el array `actions` de un `POST /conversation/actions` — ver [Armar una lista de acciones](/es/action-groups/overview#armar-una-lista-de-acciones).

## Ejemplo ejecutable

Un `assign_mailbox` sobre una conversación identificada por teléfono y canal.
Exactamente **uno** de `mailbox` o `category`, nunca ambos — y cada modo se
comporta distinto:

* **`mailbox`** — asigna la conversación al buzón exacto que indicas.
* **`category`** — no eliges un buzón: el sistema reparte la carga y asigna la
  conversación al buzón con **menos chats pendientes** dentro de esa categoría
  (útil para distribuir automáticamente entre un equipo). La categoría debe
  tener al menos un buzón configurado.

### Request

<CodeGroup>
  ```bash Buzón theme={null}
  curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
    -H "Authorization: Bearer sk_1to1_tu_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "conversation": {
        "phone": "+5215512345678",
        "channel": "ch_7A9K2M4Q"
      },
      "actions": [
        {
          "type": "assign_mailbox",
          "mailbox": { "name": "Ventas" }
        }
      ]
    }'
  ```

  ```bash Categoría theme={null}
  curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
    -H "Authorization: Bearer sk_1to1_tu_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "conversation": {
        "phone": "+5215512345678",
        "channel": "ch_7A9K2M4Q"
      },
      "actions": [
        {
          "type": "assign_mailbox",
          "category": { "name": "Soporte" }
        }
      ]
    }'
  ```
</CodeGroup>

### Respuesta

`202 Accepted` — el grupo se aceptó y corre en **background**. El resultado real
por acción no viaja en la respuesta (se consulta después — ver [Cómo se ejecuta](/es/action-groups/overview#cómo-se-ejecuta)).

```json theme={null}
{
  "status": "processing",
  "actions_accepted": 1
}
```

<ResponseField name="status" type="string">
  Siempre `processing`: confirma que el grupo fue aceptado y está en ejecución.
</ResponseField>

<ResponseField name="actions_accepted" type="integer">
  Cuántas acciones del array se **admitieron** para ejecución — no cuántas
  tuvieron éxito.
</ResponseField>