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

# Desativar integração

> Remove a integração Chatwoot da instância (a inbox no Chatwoot é preservada)

**Auth:** `TokenAccount` ou `TokenInstance` • **Rate-limit:** `Global` (100/min) • **Idempotente:** sim

## Descrição

Desativa a integração Chatwoot da instância. A RyzeAPI encerra a integração e remove o registro local. **A inbox no Chatwoot não é deletada**: ela apenas perde a conexão com a instância.

<Note>
  A inbox no Chatwoot **não é deletada**: suas conversas e mensagens são preservadas. Ela apenas perde a conexão com a instância. Se você reconectar o Chatwoot depois, uma **nova** inbox será criada.
</Note>

## Exemplo

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE "https://ryzeapi.cloud/api/chatwoot/delete/suporte" \
    -H "token: $Token_Account"
  ```

  ```javascript JavaScript theme={null}
  await fetch("https://ryzeapi.cloud/api/chatwoot/delete/suporte", {
    method: "DELETE",
    headers: {
      "token": process.env.Token_Account
    }
  });
  ```

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

  requests.delete(
      "https://ryzeapi.cloud/api/chatwoot/delete/suporte",
      headers={
          "token": os.environ["Token_Account"]
      }
  )
  ```

  ```go Go theme={null}
  package main

  import (
      "net/http"
      "os"
  )

  func main() {
      req, _ := http.NewRequest("DELETE", "https://ryzeapi.cloud/api/chatwoot/delete/suporte", nil)
      req.Header.Set("token", os.Getenv("Token_Account"))
      http.DefaultClient.Do(req)
  }
  ```
</CodeGroup>

## Resposta de sucesso

```json 200 OK theme={null}
{
  "message": "chatwoot integration deactivated"
}
```

## Parâmetros de rota

<ParamField path="instance" type="string" required>
  Nome da instância (ex.: `suporte`).
</ParamField>

## Headers

<ParamField header="token" type="string" required>
  `TokenAccount` ou `TokenInstance`.
</ParamField>

## Comportamento

<Steps>
  <Step title="Busca a integração local">
    Lê o registro da tabela `chatwoot_integrations`. Se não existir, devolve `404`.
  </Step>

  <Step title="Encerra a integração (timeout 30s)">
    A RyzeAPI encerra a integração. A inbox no Chatwoot **é preservada** (perde a conexão com a instância, mas mantém as mensagens).

    * **Já removida** → tratado como sucesso (não falha).
    * **Outros erros** → log warning no servidor e segue para a próxima etapa.
  </Step>

  <Step title="Remove a row local">
    Apaga o registro da `chatwoot_integrations` na RyzeAPI. A operação é considerada bem-sucedida quando esta etapa termina.
  </Step>
</Steps>

<Note>
  A inbox no Chatwoot **não é removida**: ela só perde a conexão com a instância. Se você reativar a integração depois (`POST /api/chatwoot/set/:instance`), uma **nova** inbox será criada.
</Note>

## Erros

| HTTP | `error.message`                      |
| :--: | ------------------------------------ |
|  404 | `instance not found`                 |
|  404 | `no chatwoot integration to delete`  |
|  503 | `integration gateway not configured` |

## Próximo

<CardGroup cols={2}>
  <Card title="Reativar" icon="plug" href="/pt/api/chatwoot/activate">
    Recrie a integração com `POST /api/chatwoot/set/:instance`.
  </Card>

  <Card title="Visão geral" icon="circle-info" href="/pt/api/chatwoot/overview">
    Volte à arquitetura e variáveis de ambiente do módulo.
  </Card>
</CardGroup>