# Atualizar Status da Conversa

> Atualiza o status de uma conversa externa específica para ativo (`active`) ou inativo (`inactive`).

`PUT https://crm.wavups.com/api/v1/account-external-conversation/{id}/update-status`

Página: https://crm.wavups.com/docs/api/conversas/atualizar-status

## Requisição

`PUT https://crm.wavups.com/api/v1/account-external-conversation/{id}/update-status`

- `Token` (string, obrigatório, header):
  Seu token de autenticação.

- `id` (string, obrigatório, path):
  ID da conversa externa a ser atualizada.

- `status` (string, obrigatório, body):
  Novo status da conversa. Deve ser `active` ou `inactive`.

---

## Resposta

Retorna o objeto da conversa atualizada.

- `id` (string):
  Identificador único da conversa.

- `contactName` (string):
  Nome do contato da conversa.

- `contactPhone` (string | null):
  Telefone do contato.

- `accountChatSectorId` (string | null):
  ID do setor de chat ao qual a conversa pertence.

- `conversationOwnerId` (string | null):
  ID do usuário responsável pela conversa.

- `status` (string):
  Status atualizado da conversa (`active` ou `inactive`).

- `state` (string | null):
  Estado atual do atendimento da conversa. Este endpoint não altera este campo (apenas `status`); o valor retornado reflete o estado atual da conversa. Valores possíveis:

  - `NEW`: conversa recém-criada, ainda não iniciada.
  - `AI_ANSWERING`: a IA está respondendo automaticamente ao contato.
  - `NEEDS_HUMAN`: a conversa precisa de atendimento humano.
  - `NO_RESPONSE`: o contato não respondeu.
  - `COMPLETED`: o atendimento foi concluído.
  - `ARCHIVED`: a conversa foi arquivada.

- `createdAt` (string):
  Data de criação da conversa (ISO 8601).

---

## Exemplos

### Exemplo de requisição

```bash PUT /api/v1/account-external-conversation/{id}/update-status
curl --request PUT \
  --url 'https://crm.wavups.com/api/v1/account-external-conversation/clxyz123/update-status' \
  --header 'Token: SEU_TOKEN_DE_API' \
  --header 'Content-Type: application/json' \
  --data '{
  "status": "inactive"
  }'
```

### Exemplo de resposta

```json 200
{
  "id": "clxyz123",
  "contactName": "Maria Silva",
  "contactPhone": "+5511999990000",
  "accountChatSectorId": "csector001",
  "conversationOwnerId": "cuser789",
  "status": "inactive",
  "state": "NEW",
  "createdAt": "2025-09-15T10:00:00.000Z"
}
```

```json 400
{
  "error": "Invalid status. Must be 'active' or 'inactive'"
}
```

```json 404
{
  "error": "Account external conversation not found"
}
```

```json 500
{
  "error": "Error to update account external conversation"
}
```