Aplicativos e integrações

Como usar Apps no Dashboard

Visão geral dos Apps de Dashboard: cadastrar nome e URL, abrir o app incorporado à conversa e trocar o contexto atualizado com postMessage. Os Apps de Dashboard incorporam uma página externa ao painel de conversas. Eles são úteis para mostrar pedidos, pagamentos ou dados de um CRM sem tirar o agente do atendimento. Criar um App de Dashboard 1. Acesse Configurações → Integrações → Painel de Aplicativos e clique em Configurar. Essa é a integração usada para criar os Apps de Dashboard descritos neste guia. 2. Informe o nome do aplicativo e a URL HTTPS em que ele está hospedado. 3. Salve. Uma aba com o nome escolhido aparecerá na área de contexto da conversa. Receber o contexto no aplicativo Quando o iframe é carregado, a plataforma envia uma string JSON por postMessage. O objeto tem o evento appContext; dentro de data ficam conversation, contact e currentAgent. window.addEventListener('message', event => { // Aceite apenas mensagens da janela que incorporou o app. if (event.source !== window.parent || typeof event.data !== 'string') return; let payload; try { payload = JSON.parse(event.data); } catch { return; } if (payload.event !== 'appContext') return; const { conversation, contact, currentAgent } = payload.data; // Atualize sua interface com os campos necessários. }); Se o aplicativo conhece a origem exata do painel, valide também event.origin contra essa origem antes de ler os dados. Solicitar o contexto atualizado Para pedir novamente os dados da conversa aberta, envie a chave abaixo à janela principal: window.parent.postMessage('chatwoot-dashboard-app:fetch-info', '*'); A resposta chega no mesmo listener com o envelope appContext. Formato resumido { "event": "appContext", "data": { "conversation": { "id": 123, "display_id": 57, "status": "open", "inbox_id": 9, "messages": [] }, "contact": { "id": 81, "name": "Maria", "email": "[email protected]", "phone_number": "+5511999999999", "custom_attributes": {} }, "currentAgent": { "id": 7, "name": "Ana", "email": "[email protected]" } } } O objeto conversation também pode conter mensagens, remetente, responsável, etiquetas e atributos do canal. Leia somente os campos necessários e tolere campos adicionais, porque o contexto pode evoluir entre versões. Segurança - Hospede o app em HTTPS e restrinja quem pode acessá-lo. - Não confie em postMessage sem validar event.source, event.origin quando possível, o tipo e o formato do payload. - Não grave tokens ou dados sensíveis no código entregue ao navegador. - Aplique no seu backend as mesmas permissões que o usuário teria no sistema de origem.

Como integrar seu chatbot Dialogflow ao Chatwoot

Fluxo para conectar o Dialogflow: criar o agente e a chave JSON, abrir a integração, configurar Project ID, chave, região, idioma e caixa de entrada e testar o bot. Os chatbots são grandes aliados das equipes de atendimento: resolvem perguntas simples de forma automática e liberam os agentes humanos para as questões mais complexas. O Dialogflow é uma das principais plataformas de PLN (Processamento de Linguagem Natural) para criar chatbots personalizados. Neste guia, você vai criar um agente no Dialogflow e conectá-lo ao Chatwoot. 💡 Prefere uma alternativa nativa? O Chatwoot já vem com a Eva, a assistente de IA integrada à plataforma — sem precisar configurar nada no Google Cloud. Se você quer colocar um atendimento com IA no ar rapidamente, considere ativar a Eva em Configurações antes de partir para uma integração externa. Antes de começar - Uma conta no Google Cloud com o Dialogflow habilitado. - Uma caixa de entrada já configurada no Chatwoot para o bot atender — por exemplo, Conectar o WhatsApp Web (QR Code) ou o chat no site. - Perfil de Administrador no Chatwoot, pois a integração fica em Configurações. Como criar um agente no Dialogflow Passo 1: Acesse o Console do Dialogflow Vamos usar o Dialogflow Essentials. No console, crie um novo agente para começar. Passo 2: Crie as intenções (intents) As intenções (intents) definem como o bot responde. Todo projeto já vem com duas intenções padrão: uma de saudação e uma de fallback (a resposta padrão para quando o bot não entende a mensagem). Você pode criar quantas intenções precisar para os seus cenários. O Chatwoot também suporta intenções avançadas, que permitem transferir a conversa para um agente humano e enviar mensagens interativas (veja mais abaixo). Passo 3: Crie uma conta de serviço no Google Cloud Para conectar o bot ao Chatwoot, crie uma conta de serviço no Google Cloud: 1. Abra o console do Google Cloud a partir do ID do projeto do seu agente. 2. Em IAM e administrador → Contas de serviço, crie uma conta de serviço com a permissão de Dialogflow API Client. 3. Gere uma chave para essa conta no formato JSON e faça o download. Guarde o arquivo JSON — você vai colar o conteúdo dele no Chatwoot no próximo passo. Configurar a integração no Chatwoot O Chatwoot tem uma integração nativa com o Dialogflow. Passo 1: Abra a integração Acesse Configurações → Integrações → Dialogflow e clique em Configurar. Passo 2: Adicione a conexão Clique em Adicionar um novo hook e preencha o formulário. Os campos deste formulário aparecem em inglês: - Dialogflow Project ID — o ID do projeto do seu agente no Dialogflow. - Dialogflow Project Key File — cole o conteúdo do arquivo JSON baixado no passo anterior. - Dialogflow Region — selecione a mesma região configurada no agente; use Global somente se o agente também estiver na região global. - Language Code — escolha Portuguese (Brazil) para um agente em português do Brasil. Use Auto-detect from contact apenas quando o idioma do contato estiver preenchido de forma confiável. - Selecionar caixa de entrada — escolha a caixa de entrada que o bot vai atender (por exemplo, WhatsApp Web ou o chat no site). Clique em Criar para concluir. Pronto — a integração está ativa. Teste a integração Envie uma mensagem pela caixa de entrada conectada (o chat no site é ideal para testar) e confira se o bot responde à primeira mensagem. Intenções avançadas Transferir a conversa para um agente Quando o cliente pedir para falar com uma pessoa, o Dialogflow avisa o Chatwoot para que um agente humano assuma a conversa. Crie uma intenção (por exemplo, "Falar com um agente") com frases de treinamento como "Falar com um atendente" e configure a resposta como Custom Payload com este conteúdo: { "action": "handoff" } Quando essa intenção for acionada, o Chatwoot muda o status da conversa para Aberta e a encaminha para um agente. (Da mesma forma, um payload { "action": "resolve" } fecha a conversa automaticamente.) Mensagens interativas O Chatwoot e o Dialogflow suportam mensagens de opções, inclusive com intenções de follow-up. O widget do site oferece a experiência completa; em outros canais, a plataforma adapta input_select quando o provedor aceita opções interativas. Teste o resultado no canal de destino. Para criar uma mensagem de opções, configure a intenção com frases de treinamento e use um Custom Payload como no exemplo abaixo: { "content_type": "input_select", "content": "Escolha sua comida favorita", "content_attributes": { "items": [ { "value": "Eu gosto de sushi", "title": "Sushi" }, { "title": "Biryani", "value": "Eu gosto de biryani" }, { "title": "Pizza", "value": "Eu gosto de pizza" } ] }, "private": false } Quando o cliente interagir com essa mensagem e escolher uma opção, o Dialogflow recebe o valor selecionado, permitindo configurar intenções de follow-up. Como devolver a conversa ao bot Quando o bot está conectado a uma caixa de entrada, ele só atua enquanto a conversa está com o status Pendente — assim o bot faz a triagem inicial antes de passar para um agente. Se um agente quiser devolver a conversa ao bot, basta mudar o status de volta para Pendente, e o bot retoma o atendimento.

Como habilitar chamadas de vídeo

Fluxo para ativar chamadas de vídeo com o Dyte: obter as API Keys, abrir o app Dyte, preencher Organization ID e API Key e iniciar a chamada pelo ícone de câmera. Fazer chamadas de vídeo com seus clientes é uma excelente maneira de se conectar rapidamente, entender os problemas com clareza, oferecer soluções mais ágeis e obter insights valiosos para o seu negócio. No Chatwoot, você pode realizar chamadas de vídeo diretamente pela caixa de entrada de chat no site. Este guia explica como ativar esse recurso. Antes de começar Você precisa de uma conta no Dyte. Caso ainda não tenha uma, será necessário criá-la antes de seguir os passos abaixo. Como configurar a integração Dyte no Chatwoot? Passo 1: Acesse Configurações → Integrações → Dyte e clique no botão Configurar. Passo 2: Na página do aplicativo Dyte, clique no botão Conectar. Passo 3: Informe Organization ID e API Key, exatamente como fornecidos pelo Dyte, e clique em Criar. Esses rótulos aparecem em inglês no formulário. Após inserir as informações, sua integração com o Dyte estará concluída. Onde encontrar os dados de configuração do Dyte? Para localizar esses valores, acesse a seção API Keys no portal de desenvolvedores do Dyte. Como fazer chamadas de vídeo com seus clientes? Depois que a integração com o Dyte estiver ativa, a opção de chamada de vídeo aparecerá na janela de conversa da caixa de entrada de chat no site. Para convidar seu cliente para uma chamada de vídeo, siga os passos abaixo: Passo 1: Clique no ícone de câmera de vídeo abaixo do editor de texto. Passo 2: O Chatwoot enviará ao cliente uma mensagem com um convite para participar da chamada. Clique no botão Clique aqui para entrar para abrir a sala. Passo 3: Pronto, você estará conectado ao seu cliente. Durante a chamada, a interface oferece diversas opções para melhorar a experiência tanto para você quanto para o cliente.

Como traduzir mensagens com o Google Translate?

Fluxo para traduzir mensagens com o Google Translate: abrir o app, preencher Google Cloud Project ID e Google Cloud Project Key File, definir o idioma e traduzir pelo menu da mensagem. Se você recebe com frequência mensagens em idiomas que você ou sua equipe não dominam, pode usar a integração do Google Translate no Chatwoot. Com ela ativada, é possível traduzir instantaneamente as mensagens recebidas direto na conversa, pelo menu de opções da mensagem. Assim, você se comunica com seus clientes no idioma nativo deles, mesmo sem falar aquele idioma. Como habilitar o Google Translate no Chatwoot? Passo 1: Acesse Configurações → Integrações → Tradutor do Google e clique no botão Configurar. Passo 2: Na página do Tradutor do Google, clique no botão Conectar. Passo 3: Informe Google Cloud Project ID e Google Cloud Project Key File. Esses rótulos aparecem em inglês no formulário. O projeto precisa ter faturamento e a Cloud Translation API ativados; consulte a configuração oficial da Cloud Translation e o guia de autenticação para criar uma credencial de serviço. Depois de preencher os campos, clique no botão Criar. Pronto — sua integração com o Google Translate está concluída. Como definir o idioma da tradução? As mensagens são traduzidas primeiro para o idioma do perfil do agente. Se o agente não tiver uma preferência, a plataforma usa o idioma do site da conta e, como último fallback, inglês. Para alterar só o seu idioma: abra Configurações do perfil, escolha o idioma e salve. Essa passa a ser também a língua de destino das traduções acionadas por você. Para alterar o padrão da conta: como administrador, vá em Configurações → Configurações da Conta → Idioma do Site e selecione o idioma desejado. Clique em Atualizar Configurações. O padrão da conta vale para usuários sem uma preferência individual. Como traduzir mensagens recebidas? Sempre que receber uma mensagem em um idioma com o qual precisa de ajuda, clique nos três pontos ao lado da mensagem para abrir o menu e selecione Traduzir. O conteúdo traduzido aparece logo abaixo da mensagem original, na própria conversa.

Como melhorar conversas com a integração OpenAI

Fluxo para usar a integração OpenAI: criar e conectar a chave, abrir o menu pelo ícone de brilho e escolher Sugerir uma resposta, Melhorar resposta ou Resumir a conversa. Manter um relacionamento eficiente com os clientes exige profissionalismo constante. A qualidade da comunicação impacta diretamente as vendas, a retenção de clientes e a identidade da sua marca. Para ajudar sua equipe a responder com mais agilidade e clareza, você pode trazer a inteligência artificial para dentro do seu painel. Com a integração OpenAI, você aprimora suas conversas com os clientes em tempo real, sem perder o tom pessoal nem a identidade da marca. A IA oferece sugestões para refinar suas mensagens, resumir conversas e ajustar o tom do texto, permitindo uma comunicação mais eficaz. A configuração é simples e rápida, e os benefícios são imediatos. Siga os passos abaixo para começar. Esta integração não é a Eva. A integração OpenAI descrita aqui adiciona recursos pontuais de IA ao editor de respostas (sugestão de resposta, melhoria de texto e resumo). Se você procura um assistente de IA completo, com Copilot e atendimento automático, veja Introdução à Eva. Antes de começar: criar uma conta na OpenAI Esta integração usa a sua própria chave de API do OpenAI. Se você ainda não tem uma conta na OpenAI, crie uma antes de configurar a integração no Chatwoot. A interface da OpenAI está em inglês. Os passos abaixo indicam o que fazer em cada tela. Passo 1: Acesse platform.openai.com e inicie o cadastro pela opção de inscrição no canto superior direito da página. Passo 2: Informe seu endereço de e-mail, crie uma senha segura e continue. Passo 3: Abra a caixa de entrada do e-mail informado e clique no link de verificação enviado pela OpenAI. Passo 4: Após verificar o e-mail, complete o perfil com as informações solicitadas (como nome completo e nome da empresa) para finalizar o cadastro. Passo 5: Com a conta criada, acesse a página de chaves de API em platform.openai.com/api-keys e gere uma nova chave secreta. Copie e guarde essa chave — ela costuma ser exibida apenas uma vez e será usada para conectar a integração no Chatwoot. Como integrar o OpenAI ao Chatwoot? Passo 1: Vá para Configurações → Integrações → OpenAI e clique no botão Configurar. Passo 2: Clique em Conectar. Uma janela surgirá pedindo sua chave de API do OpenAI. Cole a chave secreta gerada na seção anterior. Depois de inserir a chave, uma mensagem de sucesso aparecerá na tela. Como usar os recursos de IA no Chatwoot? A integração oferece três recursos de IA no atendimento. Veja como utilizá-los. Sugerir uma resposta O recurso Sugerir uma resposta propõe uma resposta rápida para a conversa com o cliente. Passo 1: Abra uma conversa que precise de resposta, clique no ícone de brilho no editor e escolha Sugerir uma resposta. Passo 2: Revise o texto gerado e clique em Aceitar para inseri-lo no editor. Passo 3: Edite a mensagem conforme necessário e clique em Enviar. Melhorar resposta O recurso Melhorar resposta sugere ajustes para a mensagem enquanto você a digita, incluindo correções e mudança de tom. Passo 1: Comece a digitar uma mensagem, clique no ícone de brilho e escolha Melhorar resposta. Passo 2: Escolha o ajuste desejado, como mudar o tom, e gere a nova versão. A IA reescreverá a mensagem. Revise o resultado e clique em Aceitar para levá-lo ao editor. Passo 3: Edite como quiser e envie. Resumir a conversa O recurso Resumir a conversa cria um resumo que você pode inserir como nota privada. Passo 1: Na conversa, mude para a aba Nota Privada, clique no ícone de brilho e escolha Resumir a conversa. Passo 2: Revise o resumo e clique em Aceitar para preencher o editor da nota. Passo 3: Edite a nota como desejar e clique em Adicionar Nota. Onde encontrar as opções de IA? As opções ficam no menu aberto pelo ícone de brilho dentro do editor de respostas. O ícone não tem um rótulo de texto ao lado. Escolha a ação desejada no menu. O resultado será exibido para revisão e poderá ser inserido no editor pelo botão Aceitar. Perguntas Frequentes Os resultados do Assistente de IA são sempre precisos? Os resultados podem não ser sempre precisos. É importante que os agentes revisem e verifiquem as sugestões da IA antes de enviá-las aos clientes. Preciso de uma chave de API própria do OpenAI? Sim. A integração usa a sua própria chave de API do OpenAI, que você cria e conecta seguindo o passo a passo acima. Para um assistente de IA completo já integrado à plataforma, com Copilot e respostas automáticas, veja Introdução à Eva.

Responder conversas pelo Slack

Fluxo para responder conversas pelo Slack: conectar o Slack em Integrações, autorizar o workspace, escolher o canal e responder sempre dentro da mesma thread. Se a sua equipe usa o Slack no dia a dia, você pode conectá-lo ao Chatwoot e acompanhar as conversas das suas caixas de entrada (WhatsApp Web, chat no site, e-mail e outras) direto de um canal do Slack — respondendo aos clientes sem sair do Slack. Antes de começar - Tenha um workspace do Slack em que você possa autorizar aplicativos. - Escolha (ou crie) o canal do Slack onde deseja receber as conversas do Chatwoot. Como conectar o Slack ao Chatwoot 1. Acesse Configurações → Integrações → Slack e clique em Conectar. 2. Informe a URL do seu workspace do Slack quando solicitado. 3. Revise as permissões e autorize o aplicativo do Chatwoot a acessar o seu workspace do Slack. 4. Você será redirecionado para a tela de configuração, onde verá a lista dos seus canais do Slack (públicos e privados). No menu suspenso, selecione o canal em que deseja receber as conversas do Chatwoot e clique em Atualizar. Pronto — a integração está concluída. A partir daí, as conversas passam a aparecer no canal escolhido. Observação importante Se você conectou o Slack antes de setembro de 2023, a opção de escolher um canal específico não existia. Para passar a usar um canal de sua preferência, remova a integração atual do Slack no Chatwoot e conecte novamente seguindo os passos acima. Recursos disponíveis Responder pelo seu perfil de agente Quando você responde a uma conversa pelo Slack, o cliente recebe a resposta com o seu perfil de agente do Chatwoot — como se você tivesse respondido pelo próprio Chatwoot. Criar notas privadas pelo Slack Você também pode registrar uma nota privada no Chatwoot a partir do Slack. Basta iniciar a mensagem com o prefixo note: — ela vira uma nota privada e notifica os agentes marcados. Adicionar o Chatwoot a canais privados Por padrão, o Chatwoot não é adicionado automaticamente aos seus canais privados do Slack — é preciso incluí-lo manualmente: 1. Depois de autenticar no Slack, selecione o canal desejado na tela de configuração do Chatwoot. 2. No Slack, abra o canal privado e adicione o aplicativo do Chatwoot a ele. Perguntas frequentes Respondi a uma mensagem, mas ela não aparece na caixa de entrada do Chatwoot. Responda sempre dentro da mesma thread. Cada thread representa uma conversa separada — usamos o ID da thread para identificar a conversa correspondente. Se você responder fora da thread, a mensagem não será vinculada à conversa certa no Chatwoot.

Como usar webhooks?

Visão geral de webhooks: cadastro do endpoint em Integrações, seleção dos eventos e envio de requisições POST para o sistema conectado. Webhooks são requisições HTTP enviadas pela plataforma quando ocorre um evento na sua conta, como a criação de uma mensagem ou a atualização de um contato. Você pode cadastrar mais de um endpoint e escolher quais eventos cada um receberá. Adicionar um webhook 1. Acesse Configurações → Integrações → Webhooks e clique em Configurar. 2. Clique em Adicionar novo webhook. 3. Informe um nome e uma URL pública iniciada por https://. 4. Selecione somente os eventos que a sua integração precisa receber. 5. Salve o webhook e guarde o segredo exibido para validar as entregas no seu servidor. O endpoint deve aceitar requisições POST, responder rapidamente com um código 2xx e processar tarefas demoradas em segundo plano. Considere que o mesmo evento pode ser entregue novamente: use o identificador do recurso para tornar o processamento idempotente. Exemplo de payload Este é um exemplo reduzido de message_created. Os campos podem variar conforme o canal, o tipo de mensagem e os recursos habilitados. { "event": "message_created", "id": 42, "content": "Olá, preciso de ajuda", "created_at": "2026-07-10T12:30:00.000Z", "message_type": "incoming", "content_type": "text", "private": false, "content_attributes": {}, "source_id": "identificador-no-canal", "sender": { "id": 81, "name": "Maria" }, "conversation": { "id": 123, "display_id": 57, "status": "open" }, "inbox": { "id": 9, "name": "Atendimento" }, "account": { "id": 1, "name": "Minha conta" } } O campo message_type pode ser incoming, outgoing, activity ou template. O content_type descreve o formato e pode assumir valores como text, input_text, input_textarea, input_email, input_select, cards, form, article, incoming_email, input_csat, integrations, sticker ou voice_call. Não faça o consumidor depender de um exemplo inteiro e imutável: leia apenas os campos necessários e tolere campos adicionais. Eventos disponíveis no painel - conversation_created — uma conversa foi criada. - conversation_status_changed — o status da conversa mudou. - conversation_updated — um atributo da conversa mudou; o payload inclui changed_attributes. - message_created — uma mensagem foi criada. - message_updated — uma mensagem foi atualizada. - webwidget_triggered — o visitante abriu o widget de chat do site. - contact_created — um contato foi criado. - contact_updated — um contato foi atualizado; o payload inclui changed_attributes. - conversation_typing_on — alguém começou a digitar. - conversation_typing_off — alguém parou de digitar. - inbox_updated — uma caixa de entrada foi atualizada; aparece quando os eventos de caixa estão habilitados na conta. Os bots de agente também recebem eventos de conversa, incluindo conversation_status_changed, pela URL configurada no próprio bot. Webhooks da conta e webhooks de bots são configurações diferentes. Boas práticas de segurança - Use somente HTTPS com certificado válido. - Verifique a assinatura usando o segredo do webhook antes de confiar no corpo recebido. - Nunca coloque tokens de acesso ou credenciais na URL. - Registre falhas sem gravar dados sensíveis desnecessários. - Trate payloads como entrada externa: valide tipos, limites e campos obrigatórios. Para alterar os eventos ou a URL, volte a Configurações → Integrações → Webhooks, edite o endpoint e salve novamente.

Conectar assistentes de IA ao Chatwoot com MCP

Visão geral da integração MCP: gerar o token de acesso no perfil, conectar o assistente ao endereço /mcp da sua instância, consultar conversas e contatos com as suas permissões e receber respostas como rascunho para revisão humana. Sua equipe já usa um assistente de IA no dia a dia — para escrever, resumir, investigar. O MCP (Model Context Protocol) permite que esse assistente converse com o seu Chatwoot: em vez de você copiar e colar o histórico de um atendimento no chat da IA, o assistente consulta a conversa diretamente na sua conta. Na prática, você passa a poder pedir coisas como: - "Resuma as últimas conversas do cliente Fulano." - "Quantas conversas estão abertas hoje e em quais caixas de entrada?" - "Procure na Central de Ajuda como configurar um canal de WhatsApp e prepare uma resposta." Disponibilidade: o MCP faz parte do plano Empresarial. O recurso não vem ligado por padrão — fale com o nosso time para ativá-lo na sua conta antes de seguir os passos abaixo. O que o assistente pode fazer O assistente enxerga a sua conta com as suas permissões — nem mais, nem menos. Se você é agente e não vê determinada conversa no painel, o assistente também não vê. As ações disponíveis se dividem em três grupos: | Grupo | O que faz | | --- | --- | | Consultas | Buscar e ler conversas, buscar e ler contatos, ver um resumo da conta e pesquisar na Central de Ajuda | | Rascunho de resposta | Salvar uma sugestão de resposta como nota privada, para uma pessoa revisar e enviar | | Alterações diretas | Adicionar nota, atribuir conversa, alterar etiquetas, mudar status, atualizar contato e mover etapa do funil | Duas observações importantes sobre esses grupos: - O assistente nunca envia mensagem para o cliente. Quando você pede uma resposta, ela é salva como nota privada na conversa, identificada como rascunho. Uma pessoa revisa, ajusta e envia — o envio continua sendo sempre humano. - As alterações diretas valem na hora. Mudar o status ou atribuir uma conversa tem o mesmo efeito que fazer isso pelo painel, inclusive disparando automações que você tenha configurado. Trate esses pedidos como ações reais. Passo 1 — Gerar seu token de acesso A conexão é autenticada com o token do seu usuário. Para gerá-lo: 1. Clique no seu avatar, no canto inferior esquerdo do painel, e abra Configurações do perfil. 2. Role até a seção Token de acesso. 3. Copie o token exibido. Esse token vale como a sua senha: quem o tiver consegue agir na conta como você. Não o compartilhe e não o publique em repositórios. Se suspeitar que vazou, volte nessa mesma tela e gere um novo — o anterior deixa de funcionar imediatamente. Passo 2 — Conectar o seu assistente O endereço do servidor MCP é o endereço do seu Chatwoot seguido de /mcp: https://SEU-DOMINIO/mcp Se o seu usuário participa de mais de uma conta, informe o número da conta no final — https://SEU-DOMINIO/mcp/1. O número da conta aparece na URL do painel quando você está logado (/app/accounts/1/...). Na dúvida, use a forma com número: ela evita ambiguidade quando uma segunda conta for habilitada. Claude Code e VS Code Esses dois já falam MCP por HTTP nativamente. No Claude Code, um comando basta: claude mcp add --transport http chatwoot https://SEU-DOMINIO/mcp \ --header "Authorization: Bearer SEU-TOKEN" No VS Code, adicione ao seu mcp.json: { "servers": { "chatwoot": { "type": "http", "url": "https://SEU-DOMINIO/mcp", "headers": { "Authorization": "Bearer SEU-TOKEN" } } } } Claude Desktop O Claude Desktop não conecta direto a um servidor MCP pelo arquivo de configuração — ele só sabe iniciar programas locais. Por isso a conexão passa por uma ponte, o mcp-remote, que o próprio Claude Desktop executa. É necessário ter o Node.js instalado. Abra Configurações → Desenvolvedor → Editar configuração e use este conteúdo: { "mcpServers": { "chatwoot": { "command": "npx", "args": [ "-y", "mcp-remote", "https://SEU-DOMINIO/mcp/1", "--transport", "http-only", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer SEU-TOKEN" } } } } Depois feche o Claude Desktop por completo e abra de novo — ele só lê esse arquivo ao iniciar. Dois cuidados nesse arquivo: - Não use o campo url. Ele existe em outros programas, mas aqui não funciona: ao encontrá-lo, o Claude Desktop apaga silenciosamente toda a seção mcpServers, derrubando junto os outros servidores que você tenha configurado. - O token fica gravado em texto puro nesse arquivo, no seu computador. Prefira gerar o token a partir de um usuário com as permissões mínimas necessárias e revogue-o se o equipamento for compartilhado ou perdido. Passo 3 — Conferir se funcionou Abra o seu assistente e peça algo simples de verificar, como um resumo da conta. Os números devem bater com o que você vê no painel. Se listar as ferramentas disponíveis, você deve encontrar 13 ferramentas com o prefixo chatwoot_. Uma lista menor costuma indicar que a sua instância ainda não está na versão que inclui o recurso — nesse caso, fale com o suporte. Se algo não funcionar | O que você vê | O que costuma ser | | --- | --- | | Erro 404 ou o endereço simplesmente não responde | O recurso ainda não foi ativado na sua conta, ou a instância está numa versão anterior à que inclui o MCP. Fale com o suporte. | | Erro 401 | Token incorreto, revogado, ou o usuário do token não tem acesso à conta informada no endereço. | | Mensagem citando 400 e listando endereços | Seu usuário participa de mais de uma conta. Use o endereço com o número da conta, como indicado na própria mensagem. | | Erro 429 | Limite de requisições por minuto atingido. Aguarde um instante e tente de novo. | | No Claude Desktop: erro citando OAuth, 404 e Unexpected token '<' | Apesar do texto, isso é token inválido. Gere um novo token e atualize o arquivo de configuração. | | No Claude Desktop: o servidor sumiu — e os outros também | O campo url foi usado no arquivo de configuração. Reescreva no formato command/args mostrado acima. | Boas práticas - Um token por pessoa. Como o assistente herda as permissões do usuário do token, evite usar um token de administrador para tarefas que não precisam desse alcance. - Revise antes de enviar. O rascunho de resposta existe justamente para manter a pessoa no controle da mensagem que chega ao cliente. - Atenção ao conteúdo do cliente. Mensagens e dados de contato são escritos por terceiros. O servidor já marca esse conteúdo como dado — e não como instrução — para o assistente, mas vale manter o olhar crítico sobre respostas geradas a partir deles. - Revogue o que não usa. Trocou de computador ou parou de usar a integração? Gere um novo token na tela de perfil para invalidar o anterior. Artigos relacionados - Como usar apps no dashboard - Como usar webhooks?