Como instalar o chat em site Gatsby

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.