[Extensão] Como integrar o Google Sheets com o Blip

1. Introdução

2. Funcionalidades

3. Pré-requisitos

4. Instalação e configuração

5. Configurando a integração no Builder

6. Exemplo de uso: gravar nome e e-mail na planilha

7. Boas práticas

8. Suporte

Descrição breve: Conecte os fluxos do seu chatbot na Blip a uma planilha do Google Sheets para consultar, buscar e gravar dados durante o atendimento, sem sair da plataforma.

Introdução

A extensão Google Sheets liga o fluxo do seu bot no Builder a uma planilha do Google Sheets. Dentro do fluxo, o bot lê valores de um intervalo, procura uma linha a partir de um valor ou adiciona uma nova linha com os dados que coletou na conversa. Por exemplo, durante um atendimento no WhatsApp o bot pergunta o nome e o e-mail do cliente e grava esses dados em uma nova linha da planilha, ou consulta um pedido pelo número informado e devolve a linha correspondente para seguir o fluxo.

A integração funciona como uma ação de saída do bloco no Builder. Você conecta uma conta Google uma vez na configuração da extensão e, a partir daí, monta as ações de leitura e escrita direto nos blocos do fluxo, usando as variáveis do próprio atendimento. Assim os dados do atendimento ficam centralizados em uma planilha, sem trabalho manual de digitação.

Funcionalidades

• Pegar valores de um intervalo da planilha e salvá-los em uma variável do fluxo.

• Procurar uma linha a partir de um valor e retornar a linha correspondente.

• Adicionar uma nova linha com os dados coletados na conversa.

Suportada nos seguintes canais: todos os canais disponíveis na plataforma Blip.

Pré-requisitos

• Um bot ativo na Blip, com o fluxo montado no Builder.

• Uma planilha já criada no Google Sheets.

• Uma conta Google com permissão de acesso à planilha que será usada no fluxo.

• Permissão para editar e publicar o fluxo desse bot no Builder.

Atenção: para a ação de adicionar uma nova linha, a conta Google conectada precisa ter permissão de edição na planilha. Para as ações de leitura, a permissão de visualização já é suficiente.

Instalação e configuração

Instale a extensão no bot cujo fluxo vai usar a integração com o Google Sheets.

1. Acesse o Google Sheets na Blip Store, procure pela extensão e ative-a no bot. A extensão passa a aparecer na lista de instaladas do bot. 

   

2. Abra o bot e, no menu de extensões, selecione Google Sheets. A tela de Configurações da extensão é exibida.

    

3. Clique em Entrar com Google. Uma janela de login do Google é aberta.

    

4. Faça login com a conta Google que terá acesso às planilhas e aceite as permissões solicitadas. Ao concluir, você volta para o painel da Blip.

   

5. Confirme que o e-mail conectado aparece na configuração. Para trocar de conta, clique em Entrar com outra conta.

    

Nota: ao entrar com o Google, você concorda com os termos de uso e privacidade da Wiv.

Para usar a integração no Builder, instale também a extensão de navegador no Google Chrome.

6. Na tela da extensão, clique em Instalar extensão. Você é direcionado para a Chrome Web Store.

   

7. Clique em Usar no Chrome e conclua a instalação. Abra o Builder e confirme que a integração aparece nos blocos.

    

Configurando a integração no Builder

Depois de conectar a conta Google e instalar a extensão no navegador, monte as ações direto nos blocos do fluxo.

1. Acesse o Builder do bot e abra o bloco onde a integração vai rodar. Adicione uma ação de integração e, no campo Integração, selecione Google Sheets.

   

   

2. No campo Ação, escolha uma das opções:

   • Pegar valores de um intervalo: lê os valores de um intervalo e salva o resultado em uma variável.

   • Procurar por linha a partir de um valor: busca um valor no intervalo e retorna a linha que contém esse valor.

   • Adicionar nova linha: acrescenta uma linha ao final da planilha com os valores informados.

3. Preencha ID da planilha e Intervalo. O Intervalo usa a notação A1 do Google Sheets, como A1:B2 ou Página1!A1:B10.

   

4. Preencha o campo específico da ação escolhida:

   • Em Procurar por linha a partir de um valor, informe o Valor de busca, que pode ser uma variável do fluxo como {{contact.email}}.

   • Em Adicionar nova linha, clique em Adicionar coluna e preencha o valor de cada coluna, na ordem da planilha. Os campos aparecem numerados como Valor da 1ª coluna, Valor da 2ª coluna e assim por diante. Cada valor também pode ser uma variável, como {{contact.email}}.

5. Em Salvar retorno, informe a Variavel de resultado. O retorno da ação fica salvo nessa variável, que você usa nos próximos blocos, por exemplo {{googleSheetsResult1}}.

Exemplo de uso: gravar nome e e-mail na planilha

Este fluxo coleta o nome e o e-mail do cliente na conversa e adiciona uma nova linha na planilha.

1. Crie um bloco para coletar o nome.

   

2. Em Entrada do usuário, ative Salvar resposta em variável e salve a resposta na variável nome. 

   

3. Repita o mesmo para o e-mail: crie o bloco, ative Salvar resposta em variável e salve a resposta na variável email.

   

    

4. Em um bloco de saída, adicione a integração Google Sheets com a ação Adicionar nova linha. Informe o ID da planilha e o Intervalo e adicione duas colunas com os valores {{nome}} e {{email}}.

5. Conecte os blocos, publique o fluxo e faça um teste. A cada atendimento, uma nova linha com o nome e o e-mail é acrescentada à planilha.

   

   

   

    

Boas práticas

• Mantenha a primeira linha da planilha como cabeçalho.

• Use nomes de coluna claros e padronizados.

• Evite células mescladas e colunas vazias no meio da tabela.

• Teste com uma planilha simples antes de usar em produção.

Suporte

Em caso de dúvidas ou problemas com a extensão, fale com a gente pelo e-mail support@wiv.com.br.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃