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

# Desactivar integración

> Elimina la integración de Chatwoot de la instancia (la inbox en Chatwoot se conserva)

**Auth:** `TokenAccount` o `TokenInstance` • **Rate limit:** `Global` (100/min) • **Idempotente:** sí

## Descripción

Desactiva la integración de Chatwoot de la instancia. RyzeAPI finaliza la integración y elimina el registro local. **La inbox en Chatwoot no se elimina**: solo pierde la conexión con la instancia.

<Note>
  La inbox en Chatwoot **no se elimina**: sus conversaciones y mensajes se conservan. Solo pierde la conexión con la instancia. Si vuelves a conectar Chatwoot más tarde, se crea una **nueva** inbox.
</Note>

## Ejemplo

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

## Respuesta exitosa

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

## Parámetros de ruta

<ParamField path="instance" type="string" required>
  Nombre de la instancia (p. ej., `suporte`).
</ParamField>

## Cabeceras

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

## Comportamiento

<Steps>
  <Step title="Buscar la integración local">
    Lee el registro de la tabla `chatwoot_integrations`. Si no existe, devuelve `404`.
  </Step>

  <Step title="Finalizar la integración (timeout de 30 s)">
    RyzeAPI finaliza la integración. La inbox en Chatwoot **se conserva** (pierde el vínculo con la instancia pero mantiene sus mensajes).

    * **Ya eliminada** → tratado como éxito (no falla).
    * **Otros errores** → registra una advertencia en el servidor y procede al siguiente paso.
  </Step>

  <Step title="Eliminar el registro local">
    Borra el registro de `chatwoot_integrations` en RyzeAPI. La operación se considera exitosa cuando este paso se completa.
  </Step>
</Steps>

<Note>
  La inbox en Chatwoot **no se elimina**: solo pierde la conexión con la instancia. Si reactivas la integración más tarde (`POST /api/chatwoot/set/:instance`), se crea una **nueva** inbox.
</Note>

## Errores

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

## Siguiente

<CardGroup cols={2}>
  <Card title="Reactivar" icon="plug" href="/es/api/chatwoot/activate">
    Recrea la integración con `POST /api/chatwoot/set/:instance`.
  </Card>

  <Card title="Resumen" icon="circle-info" href="/es/api/chatwoot/overview">
    Vuelve al funcionamiento del módulo Chatwoot.
  </Card>
</CardGroup>