Como passar dados personalizados de uma linha de uma planilha do Google Planilhas para o chatbot

Você pode integrar chatbots SendPulse com outros serviços para solicitar dados via Make. Neste artigo, veremos como visualizar dados (numéricos ou texto) de uma específica linha no Google Planilhas.

Com a ajuda de tal cenário, você pode verificar as informações pessoais de um cliente ou fornecê-las a um usuário. Você pode identificar um usuário (para quem os dados são escritos em uma linha e uma das colunas é identificada) usando quaisquer dados em seu chatbot e Google Planilhas — ID de assinante, informações de contato e muito mais.

Como começar

Faça login em sua conta Make e clique no botão + Criar um novo cenário para começar a criar um cenário.

Você pode escolher quais serviços conectar - neste caso, queremos Webhooks e Google Planilhas — usando a pesquisa ou localize e adicione-os diretamente no construtor. Clique no botão Continuar no canto superior direito.

Como criar um webhook

Clique no bloco com o ponto de interrogação no centro da tela e selecione o bloco "Webhooks" — este bloco inicia o fluxo.

Você precisa criar um webhook que envie dados do fluxo do seu chatbot. Selecione o bloco "Webhook personalizado" na lista suspensa.

Clique no botão Adicionar para criar um novo webhook.

Insira um nome de webhook e clique no botão Salvar.

Seu webhook foi criado. Copie o link — você precisa colocá-lo no fluxo do chatbot.

Agora, o Make espera receber o primeiro webhook para determinar a estrutura de dados necessária para funcionar.

Como adicionar um link de webhook a um fluxo de chatbot

Faça login em sua conta SendPulse. Selecione o bot que você precisa e abra o fluxo no criador de fluxo do chatbot.

Adicione e coloque o elemento "Solicitação de API" logo após o elemento que deseja enviar ao webhook. Selecione o tipo de solicitação "GET" e insira a URL copiada do Make.

Você pode solicitar um valor personalizado, como um ID de contato, adicionando um parâmetro no formulário contact_id = {{contact_id}} no final da URL. Você também pode passar informações de contato usando as variáveis {{email}} e {{phone}} .

Clique no botão Solicitação de teste para enviar a solicitação ao Make para que o sistema possa reconhecer a estrutura de dados recebida.

Quando o Make receber o webhook, você verá uma mensagem “Determinado com sucesso” no bloco “Webhooks”.

Agora você pode adicionar mais elementos.

Como obter dados do Google Planilhas

Clique em "Adicionar outro módulo" ao lado do bloco "Webhooks" e selecione "Google Planilhas". Selecione a ação "Pesquisar linhas".

Conecte sua conta do Google, selecione uma planilha e uma página.

Para ler todas as linhas da tabela onde a coluna A é igual ao e-mail passado do contato, no primeiro campo da seção "Filtro", selecione sua coluna com e-mails no Google Planilhas e, no segundo campo, selecione o parâmetro recebido "E-mail "do webhook (ou 6.contact.id se o ID do contato foi passado).

Se você não tiver uma variável no formato 6.Email (onde 6 é o número do bloco no Make, no qual você recebeu esta variável do chatbot), clique no botão Executar uma vez no canto inferior esquerdo e inicie o fluir no chatbot para o qual você configurou o webhook. Após a execução do primeiro fluxo, a variável aparecerá no Make.

Clique no botão OK.

Como passar um registro do Google Planilhas para um chatbot

Clique em "Adicionar outro módulo" ao lado do bloco da tabela. Escolha "Webhooks"> "Resposta do Webhook".

No campo "Body", selecione os valores da tabela que serão retornados ao chatbot e escreva-os no formato JSON:

{"variable_name": "column_from_google_sheets", "variable_name": "column_from_google_sheets"}

Clique no botão OK para salvar os parâmetros.

Volte para editar o fluxo do chatbot em sua conta SendPulse.

Você pode salvar o valor resultante em uma variável para usar um filtro e adicioná-lo a uma mensagem como uma variável. Ou você pode exibir os dados para o usuário uma vez, sem salvá-los como uma variável, usando uma expressão como {{$ ['variável']}}. Leia mais: Usando dados como uma expressão de caminho JSON.

Coloque o elemento "Mensagem" logo após o elemento "Solicitação de API" e adicione uma variável ou expressão de caminho JSON.

Salvar e executar

Antes de salvar e sair, verifique se tudo está funcionando corretamente.

Clique no botão Executar uma vez e execute o fluxo para o qual configurou o webhook. Se você configurou tudo corretamente, marcas de seleção verdes aparecerão nos blocos Webhook e Google Planilhas.

Você também pode clicar no número acima do bloco para ver as informações recebidas e transmitidas para o próximo bloco.

Para ativar o cenário, mova a chave seletora para a posição "Ligado".

Como visualizar o histórico do cenário

Navegue até o script desejado. Na guia "Últimas execuções" ou "Histórico", clique em "Detalhes" para a operação desejada. Você verá o bloco histórico de execução.

Clique no bloco desejado para ver as informações sobre ele. Você terá acesso a todas as informações do bloco - quais valores ele recebeu e transmitiu.

Caso algum dos blocos não tenha sido executado, eles serão destacados em vermelho e, ao serem pressionados, o motivo do erro e uma dica de como corrigi-los serão exibidos. Observe que todo o cenário pode pausar e não executar até que o erro seja resolvido; as operações serão enfileiradas.

Se você tiver alguma dúvida sobre falhas de configuração ou cenário, pode entrar em contato com o suporte do Make.

Última Atualização: 15.07.2024