Como fazer o AI Assist consultar uma planilha do Google

As instruções abaixo são apenas para computadores de mesa e laptops.
Você pode configurar o AI Assist do tawk.to para consultar planilhas do Google e localizar informações com base nas perguntas dos clientes por meio de uma integração via API.


Ao integrar o AI Assist com o Google Sheets, você ajudará os clientes a obter informações rápidas e precisas, além de reduzir as chances de erros que ocorrem na recuperação manual de dados.


Neste guia, vamos mostrar como integrar o AI Assist com o Google Sheets para que isso funcione.
Observação:
  • As integrações com o AI Assist estão disponíveis apenas nos planos Growth, Business e Enterprise.
  • Você precisará de uma conta do Google para acessar o Google Sheets, a API e os serviços relacionados.
  • Essa integração exige conhecimentos de programação. Se você não estiver familiarizado com isso, recomendamos a ajuda de um desenvolvedor. Para mais informações, visite nosso portal para desenvolvedores.
  • Exemplos dessa integração estão disponíveis em nosso repositório público no GitHub, para sua referência.
Prepare sua planilha do Google
Você precisará de uma planilha do Google com as informações que deseja que o AI Assist consulte. Ela pode conter detalhes de pedidos, descrições de produtos ou informações gerais. Por exemplo:
Você também pode importar um arquivo de planilha do seu computador. Siga estas etapas para importar o arquivo:


1. No Google Drive, clique em Novo.

2. Selecione Carregamento de arquivo.
3. Selecione o arquivo no seu computador e clique em Abrir.


Se necessário, ajuste a formatação da planilha para garantir que as informações possam ser lidas com facilidade.


Em seguida, vamos obter o código para sua planilha.
Escreva e publique o App Script
1. Na sua planilha do Google, vá em Extensões > Script de aplicativos.
2. O console do Apps Script será aberto em uma nova aba. Insira um script no arquivo Code.gs que descreva os métodos para consultar sua planilha.


Você pode copiar o script do exemplo fornecido. Esse exemplo busca correspondências em uma coluna específica (SKU) e não realiza uma consulta ampla em várias colunas. Você pode usar esse exemplo como ponto de partida para construir consultas mais complexas.


Certifique-se de modificar os parâmetros relevantes de acordo com suas necessidades. Para mais informações sobre como personalizar o script, clique aqui.
3. Clique em Implantar > Nova implantação.
4. Clique no ícone de engrenagem ao lado de Selecionar o tipo e escolha Aplicativo da web.
5. Insira a descrição. Em Executar como, selecione Meu. Isso dará ao script acesso à sua planilha.


Em Quem tem acesso, selecione Qualquer um. Isso permitirá que o AI Assist consulte sua planilha por meio do script.


Depois, clique em Implantar.
6. Copie e salve a URL do aplicativo da web (Web App URL). Você precisará dela na próxima etapa.Observação: Uma nova URL é gerada a cada nova implantação.
Prepare seu esquema de API
Você precisará de um arquivo de especificações da API, como um arquivo YAML, que defina a interação entre o AI Assist, sua planilha do Google e o script.


Você pode copiar as especificações do exemplo. Certifique-se de:
  • Substituir o valor de servers.urls pela URL do aplicativo da web (Web App URL) copiada do Apps Script acima.
  • Remover /exec do final da URL.
  • Modificar os parâmetros relevantes conforme suas necessidades. Para mais informações sobre como personalizar as especificações, clique aqui.


Você pode editar e testar suas especificações da API usando um editor online como o Swagger.


Copie e salve a URL do arquivo bruto. Você precisará dela na próxima etapa.


Observação: O “título” nas suas especificações aparecerá como o nome da integração no seu painel do tawk.to.


Por exemplo:
É assim que aparecerá no seu painel:
Se você tiver várias integrações de API, dê a cada uma um nome descritivo para facilitar a identificação.


Agora, vamos concluir essa integração no painel do tawk.to.
Configure a integração com o AI Assist
Observação: Você precisará de um plano pago do AI Assist para realizar essa integração.


1. Acesse sua conta no tawk.to.


2. No painel, selecione a propriedade para a qual deseja modificar o widget. Passe o mouse sobre o nome da propriedade para confirmar que escolheu a correta.
3. Vá para Complementos.
4. Em AI Assist, clique em Configurações.
5. Selecione seu agente de IA.
6. Selecione Integration/API.
7. Clique em +Adicionar ferramenta (+Add Tool).
8. Insira a URL do arquivo de especificações no campo URL do arquivo de esquema (Schema File URL).
9. Deixe o campo URL base da API (API Base URL) em branco e defina o método de autenticação como Sem autenticação. Em seguida, clique em Salvar.


10. Teste sua integração usando a pré-visualização do widget à direita. Lembre-se de testar a integração quanto à precisão, velocidade e segurança. Resolva qualquer problema que possa prejudicar a experiência dos clientes.


Agora, seus clientes poderão obter facilmente informações importantes sobre pedidos e produtos por meio do chat ao vivo em seu site.

Se você tiver sugestões sobre este artigo ou precisar de mais ajuda:


Este artigo foi útil?

4 de 11 gostaram deste artigo