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.
Este artigo fornece um exemplo de como integrar o Google Planilhas com a SendPulse através do Make. Você pode escolher qualquer outro serviço disponível no Make em vez do Google Planilhas. Observe que o design da interface do usuário pode diferir das capturas de tela mostradas.
A SendPulse também oferece uma integração direta com o Google Planilhas. Saiba mais.
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 forma que outras variáveis.
Última Atualização: 15.07.2024
ou