Como usar dados do Google Sheet em respostas do chatbot

Busque dados do Google Sheets e use-os em respostas do chatbot no WhatsApp

Updated 25 June 2026

Google Sheet Data Fetch permite que seu chatbot extraia informações de uma planilha do Google e as use em respostas do WhatsApp. Um cliente envia uma mensagem, o bot procura o número dele na sua planilha, busca os dados correspondentes (detalhes do pedido, preços, status — qualquer coisa) e responde automaticamente com eles.

Video: https://www.youtube.com/watch?v=gmORCEzt0fM

Passo 1: Conecte sua conta Google

Vá para Settings & Integration → Sign in with Google e conecte sua conta Google.

Adicione sua planilha — clique em Add Existing Sheet, cole o ID da planilha (a string longa na URL do Google Sheets entre /d/ e /edit), selecione sua conta Google e salve.

Passo 2: Crie Custom Fields

Você precisa de custom fields para armazenar os dados que seu chatbot busca da planilha. Crie um custom field para cada coluna que você deseja usar.

Vá para Manage Subscribers → Manage → Manage Custom Fields e crie campos que correspondam às colunas da sua planilha (por exemplo, "order_id", "order_name", "price").

Dica: Veja Managing Customer Data with Custom Fields para detalhes sobre como criar custom fields.

Passo 3: Crie uma campanha de Data Fetch

Vá para Settings & Integration → Google Sheet Data Fetch e clique em Create.

Google Sheet Data Fetch campaign — select spreadsheet, search field, and map columns to custom fields

Campaign Name — Dê um nome reconhecível (por exemplo, "Fetch Order Details").

Select Spreadsheet — Escolha a Google Sheet que você conectou no Passo 1.

Search By — Escolha como encontrar o cliente na sua planilha. Selecionar Number significa que o bot compara o número de WhatsApp do cliente com a coluna de números na sua planilha. Esta é a opção mais comum, pois o número está disponível automaticamente.

Map Data — Clique em Map Data para vincular colunas da planilha aos seus custom fields. Para cada coluna que você deseja buscar, selecione o cabeçalho da coluna e o custom field correspondente. Adicione quantos mapeamentos você precisar.

Clique em Verify Connection para confirmar que os dados estão sendo buscados corretamente, depois Save.

Passo 4: Use em um fluxo de bot

Vá para Bot Manager → Bot Reply → Create. Nomeie seu chatbot e atribua um keyword trigger (por exemplo, "order details").

Adicione um componente Google Sheet Data Fetch ao fluxo e selecione a campanha que você acabou de criar. Depois adicione um bloco de texto que use seus custom fields na resposta — por exemplo, "Your order ID is {{order_id}}, item: {{order_name}}, price: {{price}}."

Bot flow with Google Sheet Data Fetch component and custom field reply

Bot reply using custom fields from Google Sheet data

Salve o bot e teste enviando a palavra-chave no WhatsApp. O bot busca os dados da sua planilha e responde com os valores dos custom fields — e atualiza em tempo real quando você altera a planilha.

Artigos relacionados

How to Import Contacts from Google Sheets — Conecte Google Sheets e importe contatos

How to Create a Keyword-Based WhatsApp Chatbot — Fundamentos do fluxo de bot e triggers de palavra-chave

External HTTP API Integration in Bot Flow — Conecte bots a APIs externas

More in Integrações