Integração de Encaminhamento do FalaApp com Google Sheets

Visão Geral

Fluxo técnico:

Cliente conversa no WhatsApp
        ↓
Assistente Virtual coleta informações
        ↓
Encaminhamento é acionado
        ↓
FalaApp envia dados para uma API (Webhook)
        ↓
Webhook processa dados
        ↓
Webhook grava linha no Google Sheets

PASSO 1 — Criar a Planilha no Google Sheets

1. Acesse o Google Sheets
2. Crie uma planilha chamada:

Leads FalaApp

3. Crie as colunas:

Data
Nome
Telefone
Campanha
Interesse
Mensagem
Protocolo
Origem

PASSO 2 — Criar Webhook para receber dados do FalaApp

Você pode usar:

• Google Apps Script (mais simples)
• Make
• Zapier
• N8N
• API própria (Node / PHP / Python)

👉 Melhor opção estratégica: Google Apps Script

Script Webhook exemplo (Google Apps Script)

1. Vá em:

Extensões → Apps Script

2. Apague tudo e cole:

function doPost(e){

  var sheet = SpreadsheetApp.openById("ID_DA_PLANILHA")
  .getSheetByName("Página1");

  var body = JSON.parse(e.postData.contents);

  var overflow = {};

  try{
    overflow = JSON.parse(body.additionalOverflowData);
  }catch(err){}

  sheet.appendRow([
    new Date(),
    body.name || "",
    body.phone || "",
    overflow.campanha || "",
    overflow.interesse || "",
    body.message || "",
    overflow.protocolo || "",
    "FalaApp"
  ]);

  return ContentService
  .createTextOutput(JSON.stringify({status:"ok"}))
  .setMimeType(ContentService.MimeType.JSON);
}

Publicar Webhook

Clique:

Deploy → Nova implantação
Tipo → Web App
Permissão → Qualquer pessoa

Copie a URL gerada:

https://script.google.com/macros/s/XXXXX/exec

PASSO 3 — Configurar Encaminhamento no FalaApp

Menu

Encaminhamentos → Novo Encaminhamento

Assistente Virtual

Selecionar:

Lana

(Precisa estar OPERACIONAL — regra obrigatória da API)

Parametrizações

Recomendações estratégicas:

• Encaminhamento parcial → OFF
• Aguardar fim da conversa → ON
• Não responder após encaminhamento → ON

👉 Isso garante captura completa dos dados.

Identificação

Nome:

encaminhamento_de_leads

Descrição:

Captura dados de leads interessados em campanhas e envia para Google Sheets.

Palavras-chave de acionamento

Exemplo:

interesse, campanha, quero saber mais, falar com atendente

PASSO 4 — Criar Campos de Captura

(Seção: Defina quais informações devem ser capturadas)

Campo 1

Nome:

nome

Descrição:

Nome do lead

Campo 2

Nome:

telefone

Descrição:

Telefone do lead

Campo 3

Nome:

campanha

Descrição:

Campanha de origem

Campo 4

Nome:

interesse

Descrição:

Interesse do lead

Campo 5 (estratégico)

Nome:

protocolo

Descrição:

ID da conversa

PASSO 5 — Configurar Destino → API

Na seção:

Defina o destino das informações

Selecionar:

API

Configuração

URL:

(URL DO GOOGLE SCRIPT)

Exemplo:

https://script.google.com/macros/s/XXXXX/exec

Ativar:

Aguardar retorno da API → ON

Cabeçalho HTTP (recomendado)

Content-Type → application/json

PASSO 6 — Como enviar os dados corretamente (PONTO CRÍTICO)

Você deve usar o campo da API:

additionalOverflowData

Ele precisa ser enviado como JSON STRING

Exemplo correto:

{
"processo":"lead",
"campanha":"Black Friday",
"interesse":"Curso Marketing",
"protocolo":"FAL-123456"
}

Na requisição real:

"additionalOverflowData": "{\"processo\":\"lead\",\"campanha\":\"Black Friday\",\"interesse\":\"Curso Marketing\",\"protocolo\":\"FAL-123456\"}"

Isso será recebido pelo webhook e gravado na planilha.

PASSO 7 — Testar envio manual via API FalaApp

Endpoint:

POST https://api.fala.app.br/send-whatsapp-message?token=SEU_TOKEN

Body exemplo:

{
"sessionId":"ID_ASSISTENTE",
"name":"João Silva",
"phone":"5511999999999",
"message":"Lead interessado",
"additionalOverflowData":"{\"campanha\":\"Instagram\",\"interesse\":\"Plano Premium\",\"protocolo\":\"123\"}"
}

PASSO 8 — Testar Encaminhamento Real

Fluxo:

1. Simular conversa no WhatsApp
2. Assistente coleta dados
3. Palavra-chave dispara encaminhamento
4. FalaApp envia webhook
5. Google Sheets recebe linha

ERROS COMUNS (FAQ)

Dados não chegam na planilha

Possíveis causas:

• Webhook não publicado corretamente
• Encaminhamento não foi acionado
• JSON mal formatado no additionalOverflowData
• Assistente não está operacional
• API não aguardando retorno

Nome ou telefone vazio

Causa:

Campos não foram configurados como captura no encaminhamento.

Encaminhamento não dispara

Causa:

• Palavra-chave não usada
• Encaminhamento parcial ativo
• Conversa não finalizada