# Atualizar configuração do Chatwoot

`PUT /chatwoot/config`

Pasta: **Integração Chatwoot**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Atualizar configuração do Chatwoot

Cria ou atualiza a integração Chatwoot da instância. A API valida a config, salva e devolve também `webhook_url` e `call_script_url` para configurar no Chatwoot.

## Endpoint

`PUT {{baseUrl}}/chatwoot/config`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `enabled` | boolean | Não | Liga/desliga a integração. |
| `url` | string | Não* | URL base do Chatwoot. Vazio preserva o valor atual. |
| `access_token` | string | Não* | Token de acesso da API Chatwoot. |
| `account_id` | number | Não* | ID da conta Chatwoot. |
| `inbox_id` | number | Não* | ID da inbox. |
| `database_url` | string | Não | URL Postgres do Chatwoot (para sync). |
| `sync` | boolean | Não | Ativa sincronização histórica. |
| `ignore_groups` | boolean | Não | Ignora mensagens de grupos. |
| `sign_messages` | boolean | Não | Assina mensagens com nome do agente (default `true` se omitido na criação). |
| `create_new_conversation` | boolean | Não | Cria nova conversa em certos fluxos. |
| `sync_contacts_to_whatsapp` | boolean | Não | Sync de contatos Chatwoot → WhatsApp (default `true`). |
| `management_phone` | string | Não | Telefone de gestão. |

\* Campos de conexão: se vazios, preservam o valor já salvo.

## Exemplo de Requisição

```bash
curl --request PUT '{{baseUrl}}/chatwoot/config' \
  --header 'token: {{token}}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "enabled": true,
  "url": "https://chatwoot.exemplo.com",
  "access_token": "xxxxxxxxxxxxxxxxx",
  "account_id": 1,
  "inbox_id": 1,
  "database_url": "postgres://postgres:password@100.100.100.100:5432/chatwoot?sslmode=disable",
  "sync": true,
  "ignore_groups": true,
  "sign_messages": false,
  "create_new_conversation": false,
  "sync_contacts_to_whatsapp": true,
  "management_phone": "5511999999999"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "config": {
    "chatwoot_enabled": true,
    "chatwoot_url": "https://chatwoot.exemplo.com"
  },
  "webhook_url": "https://api.exemplo.com/chatwoot/webhook",
  "call_script_url": "https://api.exemplo.com/static/chatwoot-call.js"
}
```

## Erros comuns

- `401 Unauthorized`: o header `token` não foi enviado ou é inválido.
- `400 Bad Request`: JSON inválido ou campo obrigatório ausente.
- `500 Internal Server Error`: instância desconectada ou a operação falhou no WhatsApp.
- `400 Bad Request`: config inválida (URL/token/conta).

## Observações

Após salvar, configure o webhook do Chatwoot com a `webhook_url` retornada (autenticada pelo token da instância).

## Corpo (exemplo)

```json
{
  "enabled": true,
  "url": "https://chatwoot.exemplo.com",
  "access_token": "xxxxxxxxxxxxxxxxx",
  "account_id": 1,
  "inbox_id": 1,
  "database_url": "postgres://postgres:password@100.100.100.100:5432/chatwoot?sslmode=disable",
  "sync": true,
  "ignore_groups": true,
  "sign_messages": false,
  "create_new_conversation": false,
  "sync_contacts_to_whatsapp": true,
  "management_phone": "5511999999999"
}
```

## cURL

```bash
curl -X PUT "{{baseUrl}}/chatwoot/config" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": true,
  "url": "https://chatwoot.exemplo.com",
  "access_token": "xxxxxxxxxxxxxxxxx",
  "account_id": 1,
  "inbox_id": 1,
  "database_url": "postgres://postgres:password@100.100.100.100:5432/chatwoot?sslmode=disable",
  "sync": true,
  "ignore_groups": true,
  "sign_messages": false,
  "create_new_conversation": false,
  "sync_contacts_to_whatsapp": true,
  "management_phone": "5511999999999"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=integracao-chatwoot/atualizar-configuracao-do-chatwoot)