Atualizar configuração do Chatwoot

curl --request PUT \
  --url https://api.zappfy.io/chatwoot/config \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "enabled": true,
  "url": "https://app.chatwoot.com",
  "access_token": "pXXGHHHyJPYHYgWHJHYHgJjj",
  "account_id": 1,
  "inbox_id": 5,
  "ignore_groups": false,
  "sign_messages": true,
  "create_new_conversation": false
}
'

{
  "message": "Chatwoot config updated successfully, put this URL in Chatwoot inbox webhook settings:",
  "chatwoot_inbox_webhook_url": "https://sua-api.com/chatwoot/webhook/inst_abc123"
}

Integração Chatwoot

Atualizar configuração do Chatwoot

Atualiza a configuração da integração com Chatwoot para a instância.

Funcionalidades:

Configura todos os parâmetros da integração Chatwoot
Reinicializa automaticamente o cliente Chatwoot quando habilitado
Retorna URL do webhook para configurar no Chatwoot
Sincronização bidirecional de mensagens novas entre WhatsApp e Chatwoot
Sincronização automática de contatos (nome e telefone)
Atualização automática LID → PN (Local ID para Phone Number)
Sistema de nomes inteligentes com til (~)

Configuração no Chatwoot:

Após configurar via API, use a URL retornada no webhook settings da inbox no Chatwoot
Configure como webhook URL na sua inbox do Chatwoot
A integração ficará ativa e sincronizará mensagens e contatos automaticamente

🏷️ Sistema de Nomes Inteligentes:

Nomes com til (~): São atualizados automaticamente quando o contato modifica seu nome no WhatsApp
Nomes específicos: Para definir um nome fixo, remova o til (~) do nome no Chatwoot
Exemplo: “~João Silva” será atualizado automaticamente, “João Silva” (sem til) permanecerá fixo
Atualização LID→PN: Contatos migram automaticamente de Local ID para Phone Number quando disponível
Sem duplicação: Durante a migração LID→PN, não haverá duplicação de conversas
Respostas nativas: Todas as respostas dos agentes aparecem nativamente no Chatwoot

🚧 AVISO IMPORTANTE - INTEGRAÇÃO BETA:

Fase Beta: Esta integração está em fase de desenvolvimento e testes
Uso por conta e risco: O usuário assume total responsabilidade pelo uso
Recomendação: Teste em ambiente não-produtivo antes de usar em produção
Suporte limitado: Funcionalidades podem mudar sem aviso prévio

⚠️ Limitações Conhecidas:

Sincronização de histórico: Não implementada - apenas mensagens novas são sincronizadas

PUT

/

chatwoot

/

config

Atualizar configuração do Chatwoot

curl --request PUT \
  --url https://api.zappfy.io/chatwoot/config \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "enabled": true,
  "url": "https://app.chatwoot.com",
  "access_token": "pXXGHHHyJPYHYgWHJHYHgJjj",
  "account_id": 1,
  "inbox_id": 5,
  "ignore_groups": false,
  "sign_messages": true,
  "create_new_conversation": false
}
'

{
  "message": "Chatwoot config updated successfully, put this URL in Chatwoot inbox webhook settings:",
  "chatwoot_inbox_webhook_url": "https://sua-api.com/chatwoot/webhook/inst_abc123"
}

Autorizações

token

string

header

obrigatório

Corpo

application/json

enabled

boolean

obrigatório

Habilitar/desabilitar integração com Chatwoot

Exemplo:

true

url

string

obrigatório

URL base da instância Chatwoot (sem barra final)

Exemplo:

"https://app.chatwoot.com"

access_token

string

obrigatório

Token de acesso da API Chatwoot (obtido em Profile Settings > Access Token)

Exemplo:

"pXXGHHHyJPYHYgWHJHYHgJjj"

account_id

integer<int64>

obrigatório

ID da conta no Chatwoot (visível na URL da conta)

Exemplo:

1

inbox_id

integer<int64>

obrigatório

ID da inbox no Chatwoot (obtido nas configurações da inbox)

Exemplo:

5

ignore_groups

boolean

Ignorar mensagens de grupos do WhatsApp na sincronização

Exemplo:

false

sign_messages

boolean

Assinar mensagens enviadas para WhatsApp com identificação do agente

Exemplo:

true

create_new_conversation

boolean

Sempre criar nova conversa ao invés de reutilizar conversas existentes

Exemplo:

false

Resposta

Configuração atualizada com sucesso

message

string

Mensagem de confirmação

Exemplo:

"Chatwoot config updated successfully, put this URL in Chatwoot inbox webhook settings:"

chatwoot_inbox_webhook_url

string

URL do webhook para configurar na inbox do Chatwoot

Exemplo:

"https://sua-api.com/chatwoot/webhook/inst_abc123"

Obter configuração do Chatwoot