[Extensão] Como consultar dados de uma planilha do Google Sheets durante a conversa na Blip

1. Introdução

2. Como configurar a busca no fluxo

3. Suporte

Descrição breve: Busque a linha de um cliente por CPF, e-mail ou número de pedido em uma planilha do Google Sheets e use o retorno para personalizar a resposta do bot, sem criar uma API.

Introdução

Quando o cliente pede o status de um pedido ou quer confirmar um cadastro, o bot precisa consultar uma base para responder. Com a extensão Google Sheets, você usa a própria planilha como base de consulta: o bot procura uma linha a partir de um valor que o contato informou (CPF, e-mail, número de pedido, protocolo) e devolve os dados dessa linha para usar no fluxo.

Isso funciona bem quando você já mantém os dados em uma planilha e quer consultá-los na conversa sem criar uma API nem depender de desenvolvimento. Para gravar novos dados na planilha, veja a pílula de adicionar nova linha. Para ler uma faixa inteira de células, veja a pílula de leitura de intervalo.

Antes de começar

Confirme que você já tem:

• A extensão Google Sheets ativada no bot. Ative a Google Sheets na Blip Store.

• O login com a conta Google feito na tela de Configurações da extensão, com permissão de planilhas concedida.

• A extensão de navegador do Builder instalada. Ela adiciona o botão Nova integração no Builder e tem o link Instalar extensão na tela de Configurações da extensão.

• Uma planilha no Google Sheets com uma aba organizada em colunas, e uma coluna que serve de chave de busca (por exemplo, e-mail ou CPF). A conta Google conectada precisa ter acesso a essa planilha.

• Uma variável do fluxo com o valor que será pesquisado, por exemplo {{contact.email}}.

Exemplo de estrutura da planilha, com uma coluna de chave (e-mail) e as colunas de dados a retornar:

Neste exemplo, o bot consulta a linha pelo e-mail informado pelo contato e usa o status do pedido na resposta.

Como configurar a busca no fluxo

A integração roda como ação de saída de um bloco. Posicione o bloco depois do ponto em que o contato informou o valor que será pesquisado.

1. No Builder, clique em Nova integração para adicionar um bloco de integração no fluxo.

2. Abra o bloco e, na aba Integração, selecione Google Sheets.

3. No campo Ação, escolha Procurar por linha a partir de um valor.

4. Em ID da planilha, informe o identificador da planilha. Ele está na URL, entre /d/ e /edit.

5. Em Intervalo, informe a aba e o intervalo onde a busca será feita, por exemplo Página1!A:D.

6. Em Valor de busca, informe o valor procurado usando a variável do fluxo, por exemplo {{contact.email}}.

7. Em Salvar retorno, informe a Variável de resultado. A extensão procura, dentro do intervalo, a primeira linha que contém esse valor em qualquer uma das colunas e grava a linha inteira nessa variável.

8. Publique o fluxo e faça um teste. Use a variável de resultado nos próximos blocos para personalizar a resposta, referenciando a coluna que precisa pela posição dela na linha retornada.

Atenção

O valor pesquisado precisa existir na planilha exatamente como foi informado. A busca é por correspondência exata da célula, então diferenças de espaço, maiúsculas e minúsculas, acentos ou caracteres especiais impedem o retorno. Se nenhuma linha corresponder ao valor, a variável de resultado volta vazia. Trate esse caso no fluxo, por exemplo com uma condição que responde ao contato quando nada é encontrado.

Suporte

Em caso de dúvida ou problema 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 😃