Saltar al contenido principal
DELETE
/
api
/
chatwoot
/
delete
/
:instance
Desactivar integración
curl --request DELETE \
  --url https://api.example.com/api/chatwoot/delete/:instance \
  --header 'token: <token>'

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.

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

​
Descripción

Desactiva la integración de Chatwoot para la instancia. El servidor solicita al bridge RyzeIntegrations que finalice la integración (cierra el WebSocket interno, libera recursos), borra el inbox correspondiente en Chatwoot y elimina la fila local.
El inbox creado en Chatwoot se elimina junto con la integración. Las conversaciones vinculadas a ese inbox pueden perderse, si deseas preservar el historial, expórtalo antes de llamar a este endpoint.

​
Ejemplo

curl -X DELETE "https://ryzeapi.cloud/api/chatwoot/delete/suporte" \
  -H "token: $Token_Account"

​
Respuesta exitosa

200 OK
{
  "message": "chatwoot integration deactivated"
}

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia (p. ej., suporte).

​
Cabeceras

​
token
string
requerido
TokenAccount o TokenInstance.

​
Comportamiento

1

Buscar la integración local

Lee el bridge_integration_id de la tabla chatwoot_integrations. Si no existe, devuelve 404.
2

DELETE en el bridge (timeout de 30 s)

Si el bridge está habilitado, llama a DELETE /v1/integrations/<bridge_integration_id>. El bridge cierra el WebSocket y elimina el inbox en Chatwoot (DELETE /api/v1/accounts/<id>/inboxes/<inbox_id>).
  • 404 del bridge → tratado como ya eliminado (no falla).
  • Otros errores → registra una advertencia en el servidor y procede al siguiente paso.
3

Eliminar la fila local

Borra el registro de chatwoot_integrations en RyzeAPI. La operación se considera exitosa cuando este paso se completa.
La eliminación del inbox en Chatwoot es permanente. Para reactivar la integración más tarde, usa POST /api/chatwoot/set/:instance, se creará un nuevo inbox.

​
Errores

HTTPerror.message
404instance not found
404no chatwoot integration to delete
503integration gateway not configured (set BRIDGE_URL and BRIDGE_TOKEN)

​
Siguiente

Reactivar

Recrea la integración con POST /api/chatwoot/set/:instance.

Resumen

Vuelve a la arquitectura del módulo y a las variables de entorno.