Use este guia quando você precisar configurar, entender ou validar **Como instalar o chat em site Gatsby** na IAra.

## Antes de começar na IAra

- Confirme que seu usuário tem permissão para acessar a área citada no artigo.
- Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
- Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

## Guia detalhado

> **Observação técnica:** por compatibilidade com o SDK herdado, alguns objetos de código podem continuar usando nomes como `window.chatwootSettings` e `window.chatwootSDK`. Use esses nomes exatamente como aparecem no snippet.

Se você tem um site criado em Gatsby, pode adicionar um widget de chat ao vivo IAra e conversar com seus visitantes em tempo real. Isso pode ser feito em 3 etapas simples usando o plugin Gatsby da IAra.

## Etapa 1. Adicione o plugin Gatsby ao seu projeto

Adicione `gatsby-plugin-iara` ao seu projeto Gatsby.

```
npm install --save gatsby-plugin-iara
```

Se você estiver usando Yarn, use o seguinte:

```
yarn add gatsby-plugin-iara
```

## Etapa 2. Adicione o plug-in ao arquivo de configuração do Gatsby****

```
// No seu gatsby-config.js
plug-ins: [
  {
    resolver: `gatsby-plugin-iara`,
    opções: {
      baseUrl: "BASE_URL", // Obrigatório
      websiteToken: "WEBSITE_TOKEN", // Obrigatório
      includeInDevelopment: false, // Opcional
      chatwootSettings: {}, // Opcional
    },
  },
];
```

Você pode obter o token do site e o URL base nas configurações da caixa de entrada da sua conta da IAra.

Se você precisar criar um novo canal de site, siga o procedimento ilustrado aqui.

## Etapa 3. Inicie seu servidor

Você poderá ver o widget IAra na página agora.

---

## Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

## Problemas comuns

- Usuário sem permissão para acessar a configuração.
- Nome de tela diferente entre versões ou contas.
- Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
- Falta de teste em conversa realista antes de liberar para a equipe.

## Checklist final

- [ ] Configuração revisada por um administrador.
- [ ] Teste realizado com dado ou conversa controlada.
- [ ] Impacto para agentes e gestores entendido.
- [ ] Artigos relacionados revisados para evitar links quebrados.