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

# Atribuir caixa de entrada

> Move a conversa para uma caixa de entrada ou categoria

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

Move a conversa para uma caixa de entrada ou para uma categoria. Exatamente **um** de
`mailbox` | `category`, nunca ambos.

**Campos**

* `mailbox` — objeto `{ name }` da caixa de entrada.
* `category` — objeto `{ name }` da categoria.

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

Em uma lista, este objeto vai no array `actions` de um `POST /conversation/actions` — veja [Montar uma lista de ações](/pt/action-groups/overview#montar-uma-lista-de-ações).

## Exemplo executável

Um `assign_mailbox` em uma conversa identificada por telefone e canal. Exatamente
**um** de `mailbox` ou `category`, nunca ambos — e cada modo se comporta de
forma diferente:

* **`mailbox`** — atribui a conversa à caixa de entrada exata que você indica.
* **`category`** — você não escolhe uma caixa: o sistema distribui a carga e
  atribui a conversa à caixa de entrada com **menos chats pendentes** dentro
  dessa categoria (útil para distribuir automaticamente entre uma equipe). A
  categoria deve ter pelo menos uma caixa de entrada configurada.

### Request

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

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

### Resposta

`202 Accepted` — o grupo foi aceito e roda em **background**. O resultado por
ação não viaja na resposta (consulte-o depois — veja [Como é executado](/pt/action-groups/overview#como-é-executado)).

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

<ResponseField name="status" type="string">
  Sempre `processing`: confirma que o grupo foi aceito e está em execução.
</ResponseField>

<ResponseField name="actions_accepted" type="integer">
  Quantas ações do array foram **admitidas** para execução — não quantas tiveram
  sucesso.
</ResponseField>