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.
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}}."
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