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

# Desativar agente multiplas conversas

## Desativar Agente em Múltiplas Conversas

Este endpoint permite atualizar o status de múltiplas conversas simultaneamente, incluindo a desativação do agente em conversas específicas por canal ou agente.

### Casos de uso

* Desativar agente em todas as conversas de um canal específico
* Atualizar status de todas as conversas de um agente
* Operações em lote para gerenciamento de conversas
* Transferência em massa para atendimento humano

### Parâmetros de Query

| Parâmetro | Tipo   | Descrição                                |
| --------- | ------ | ---------------------------------------- |
| channel   | string | Filtrar por canal específico (opcional)  |
| agentId   | string | Filtrar por agente específico (opcional) |

### Canais suportados

* `whatsapp` - WhatsApp
* `website` - Website/Chat
* `telegram` - Telegram
* `email` - Email
* `api` - API direta

### Corpo da requisição

| Campo  | Tipo   | Descrição                     |
| ------ | ------ | ----------------------------- |
| status | string | Novo status para as conversas |

### Valores aceitos para status

* `UNRESOLVED` - Conversa não resolvida
* `RESOLVED` - Conversa resolvida
* `HUMAN_REQUESTED` - Solicitação de atendimento humano

<Card>
  <CardContent>
    Esta operação afeta todas as conversas do workspace que correspondem aos filtros especificados.
  </CardContent>
</Card>

### Exemplos de código

<CodeGroup>
  ```javascript JavaScript theme={null}
  // Atualizar todas as conversas de WhatsApp para atendimento humano
  const updateWhatsAppConversations = async () => {
    const response = await fetch('https://dash.superagentes.ai/api/conversations/update-status?channel=whatsapp', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${seu_token_jwt}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        status: 'HUMAN_REQUESTED'
      })
    });
    
    const data = await response.json();
    return data;
  };

  // Atualizar todas as conversas de um agente específico
  const updateAgentConversations = async (agentId) => {
    const response = await fetch(`https://dash.superagentes.ai/api/conversations/update-status?agentId=${agentId}`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${seu_token_jwt}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        status: 'RESOLVED'
      })
    });
    
    const data = await response.json();
    return data;
  };
  ```

  ```python Python theme={null}
  import requests

  def update_whatsapp_conversations():
      headers = {
          'Authorization': f'Bearer {seu_token_jwt}',
          'Content-Type': 'application/json'
      }
      
      data = {
          'status': 'HUMAN_REQUESTED'
      }
      
      response = requests.post(
          'https://dash.superagentes.ai/api/conversations/update-status?channel=whatsapp',
          headers=headers,
          json=data
      )
      
      return response.json()

  def update_agent_conversations(agent_id):
      headers = {
          'Authorization': f'Bearer {seu_token_jwt}',
          'Content-Type': 'application/json'
      }
      
      data = {
          'status': 'RESOLVED'
      }
      
      response = requests.post(
          f'https://dash.superagentes.ai/api/conversations/update-status?agentId={agent_id}',
          headers=headers,
          json=data
      )
      
      return response.json()
  ```

  ```curl cURL theme={null}
  # Atualizar conversas por canal
  curl --request POST \
    --url 'https://dash.superagentes.ai/api/conversations/update-status?channel=whatsapp' \
    --header 'Authorization: Bearer seu_token_jwt' \
    --header 'Content-Type: application/json' \
    --data '{
      "status": "HUMAN_REQUESTED"
    }'

  # Atualizar conversas por agente
  curl --request POST \
    --url 'https://dash.superagentes.ai/api/conversations/update-status?agentId=agent-id-1' \
    --header 'Authorization: Bearer seu_token_jwt' \
    --header 'Content-Type: application/json' \
    --data '{
      "status": "RESOLVED"
    }'
  ```
</CodeGroup>

### Exemplos de uso

#### 1. Transferir todas as conversas de WhatsApp para humano

```json theme={null}
POST /api/conversations/update-status?channel=whatsapp
{
  "status": "HUMAN_REQUESTED"
}
```

#### 2. Resolver todas as conversas de um agente específico

```json theme={null}
POST /api/conversations/update-status?agentId=agent-123
{
  "status": "RESOLVED"
}
```

#### 3. Atualizar todas as conversas do workspace

```json theme={null}
POST /api/conversations/update-status
{
  "status": "UNRESOLVED"
}
```

### Exemplo de resposta

<ResponseExample>
  ```json theme={null}
  {
    "count": 25,
    "message": "25 conversas foram atualizadas com sucesso"
  }
  ```
</ResponseExample>

### Códigos de resposta

| Código | Descrição                         |
| ------ | --------------------------------- |
| 200    | Conversas atualizadas com sucesso |
| 400    | Dados inválidos na requisição     |
| 401    | Token de autenticação inválido    |
| 403    | Sem permissão para esta operação  |
| 500    | Erro interno do servidor          |

### Notas importantes

* Esta operação é irreversível e afeta múltiplas conversas simultaneamente
* Use com cuidado ao especificar filtros para evitar atualizações indesejadas
* O número de conversas afetadas é retornado no campo `count`
* Apenas conversas do workspace atual são afetadas
* Se nenhum filtro for especificado, todas as conversas do workspace serão atualizadas

### Filtros combinados

Você pode combinar filtros para operações mais específicas:

```
POST /api/conversations/update-status?channel=whatsapp&agentId=agent-123
```

Isso afetará apenas conversas de WhatsApp do agente específico.