Como instalar um chat ao vivo em um site Gatsby

A

Antonio Milesi

Última atualização em Jul 10, 2026

Três passos para instalar o widget em um site Gatsby: instalar o gatsby-plugin-chatwoot, configurá-lo no gatsby-config.js com baseUrl e websiteToken, e iniciar o servidor.

Se você tem um site Gatsby, a opção recomendada é copiar o script oficial do widget na aba Configuração da caixa de entrada de site e carregá-lo no layout do projeto.

O gatsby-plugin-chatwoot é um plugin da comunidade, não um pacote oficial. Sua versão publicada foi feita para Gatsby 2 e React 16; use as etapas abaixo somente em um projeto legado compatível. Em um Gatsby atual, prefira o script oficial para evitar conflitos de dependências.

Passo 1. Adicione o plugin a um projeto compatível

Instale o gatsby-plugin-chatwoot no seu projeto Gatsby com o seguinte comando:

npm install --save gatsby-plugin-chatwoot

Se você usa o Yarn, utilize:

yarn add gatsby-plugin-chatwoot

Passo 2. Adicione o plugin ao arquivo de configuração do Gatsby

No seu arquivo gatsby-config.js, insira o código abaixo:

plugins: [
  {
    resolve: `gatsby-plugin-chatwoot`,
    options: {
      baseUrl: "BASE_URL", // Obrigatório
      websiteToken: "WEBSITE_TOKEN", // Obrigatório
      includeInDevelopment: false, // Opcional
      chatwootSettings: {}, // Opcional
    },
  },
];

Você encontra o token do site (websiteToken) e a URL base (baseUrl) nas configurações da sua caixa de entrada de site: acesse Configurações → Caixas de Entrada, selecione o canal de site e abra a aba Configuração.

Ainda não tem uma caixa de entrada de site? Crie uma em Configurações → Caixas de Entrada → Adicionar caixa de entrada e escolha o canal de site.

Passo 3. Inicie o servidor

Suba o servidor do seu projeto Gatsby. Pronto — o widget do Chatwoot já aparece nas páginas do seu site.