Como transferir dados do Google Sheets para chatbots
Se você utiliza o Google Planilhas como um banco de dados para contatos, pedidos ou informações sobre disponibilidade de produtos, pode ser necessário alimentar esses pontos de dados em chatbots para que os usuários recebam mensagens relevantes.
Neste artigo, falaremos sobre como transferir dados do Google Sheets para o elemento "Solicitação de API" em um fluxo de chatbot utilizando a integração com a API do Google Sheets e a SendPulse.
Configure sua conta, senhas e arquivos do Google
Para usar o Google Sheets para enviar dados, crie um projeto no Google Cloud Platform e conceda acesso à planilha do banco de dados.
Selecionar um projeto e configurá-lo
Faça login na plataforma do Google Cloud com sua conta do Google. Crie um novo projeto ou selecione um existente na lista. Especifique o nome do seu projeto e a organização principal, se necessário.
Habilitar a API do Google Sheets
Em "APIs & serviços", selecione "APIs & serviços habilitados". Clique em Habilitar APIs e serviços e vá para a biblioteca de integração.
Encontre "API do Google Sheets" na biblioteca e clique em Habilitar.
Crie uma chave de API
Vá para "APIs & serviços" > "Credenciais" e clique em Criar credenciais. Selecione "chave da API" no menu suspenso.
Você receberá uma mensagem informando que uma chave foi criada. Você pode copiá-la imediatamente ou posteriormente.
Recomendamos limitar o uso da sua chave de API à integração com o Google Sheets imediatamente. Para fazer isso, clique no ícone de três pontos ao lado do nome da sua chave de API, selecione "Editar" e, em "Restrições de API", especifique a API do Google Sheets.
Conceder acesso à planilha
Disponibilize a planilha para visualização por meio de um link ou adicione a conta de serviço do projeto do Google Cloud à lista de usuários que podem visualizar o arquivo.
Configurar um fluxo de chatbot
Adicione o elemento "Solicitação de API"
Para usar os valores da sua planilha, forme uma URL do seguinte tipo:
https://sheets.googleapis.com/v4/spreadsheets/{sheet_id}/values/{sheet_name}!{range}?key={api_key}
Parâmetros usados no URL:
Nome | Descrição |
sheet_id |
O ID da planilha* que você pode copiar no endereço da URL da planilha. |
sheet_name |
O nome da planilha, por exemplo, Contatos ou Planilha1 . |
variedade |
As coordenadas da célula ou da variedade de células de onde você recupera os dados da consulta no formato de notação do Google Sheets, por exemplo, E1:F21 . |
api_key |
Sua chave de API nas configurações do projeto no Google Cloud. |
* Por exemplo, se o URL da sua planilha for
https://docs.google.com/spreadsheets/d/18H_kz3wXduyqjOW_J0Yuv8FKur5Cd0Wb8s9nEMRC3Ps/edit#gid=91581876
,
então seu ID é 18H_kz3wXduyqjOW_J0Yuv8FKur5Cd0Wb8s9nEMRC3Ps
.
Adicione o elemento "Solicitação de API" ao seu fluxo de chatbot, selecione o método GET para a solicitação e insira o URL resultante no campo de link.
Você pode testar os dados recebidos clicando em Testar solicitação. Em seguida, você pode usar os dados resultantes em "Configurações de mapeamento".
Clique em Adicionar e, em "Campo de resposta", selecione um valor da resposta da solicitação recebida – ele será exibido como um link JSONPath {{$['somekey']['nestedkey']}}
.
No próximo campo, selecione uma variável do público do chatbot onde você deseja importar os valores para usá-los em outros elementos.
Salvar o resultado e configurar os elementos subsequentes
Você pode usar os dados recuperados como um link JSONPath em suas mensagens. Copie o link do "Campo de resposta" sem salvar os dados em variáveis.
No entanto, observe que você só pode transferir um valor em um link JSONPath em um elemento imediatamente após a "Solicitação de API", portanto, se você deseja usar determinados pontos de dados várias vezes, salve-os.
Você pode usar valores salvos nos elementos "Filtro" e "Mensagem" da mesma maneira que outras variáveis.
Leia também: Como transferir dados de um Chatbot para o Google Apps (usando a integração com o Make como exemplo).
Última Atualização: 20.04.2023
ou