Pular para o conteúdo principal
DELETE
/
api
/
chatwoot
/
delete
/
:instance
Desativar integração
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 ou TokenInstance • Rate-limit: Global (100/min) • Idempotente: sim

​
Descrição

Desativa a integração Chatwoot da instância. O servidor pede ao RyzeIntegrations bridge para encerrar a integração (fecha o WebSocket interno, libera recursos), apaga a inbox correspondente no Chatwoot e remove a row local.
A inbox criada no Chatwoot é deletada junto com a integração. Conversas ligadas àquela inbox podem ser perdidas, se quiser preservar histórico, exporte antes de chamar este endpoint.

​
Exemplo

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

​
Resposta de sucesso

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

​
Parâmetros de rota

​
instance
string
obrigatório
Nome da instância (ex.: suporte).

​
Headers

​
token
string
obrigatório
TokenAccount ou TokenInstance.

​
Comportamento

1

Busca a integração local

Lê o bridge_integration_id da tabela chatwoot_integrations. Se não existir, devolve 404.
2

DELETE no bridge (timeout 30s)

Se o bridge está habilitado, chama DELETE /v1/integrations/<bridge_integration_id>. O bridge encerra o WebSocket e apaga a inbox no Chatwoot (DELETE /api/v1/accounts/<id>/inboxes/<inbox_id>).
  • 404 do bridge → tratado como já removido (não falha).
  • Outros erros → log warning no servidor e segue para a próxima etapa.
3

Remove a row local

Apaga o registro da chatwoot_integrations na RyzeAPI. A operação é considerada bem-sucedida quando esta etapa termina.
A remoção da inbox no Chatwoot é definitiva. Para reativar a integração depois, use POST /api/chatwoot/set/:instance, uma nova inbox será criada.

​
Erros

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

​
Próximo

Reativar

Recrie a integração com POST /api/chatwoot/set/:instance.

Visão geral

Volte à arquitetura e variáveis de ambiente do módulo.