> ## Documentation Index
> Fetch the complete documentation index at: https://mayahub.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sincronizar Leads Qualificados com o Google Sheets

> Aprenda a adicionar automaticamente leads qualificados ao Google Sheets após chamadas bem-sucedidas com IA 

**Este tutorial mostra como configurar uma automação que adiciona automaticamente leads qualificados a uma planilha do Google após chamadas bem-sucedidas com IA, criando um poderoso sistema de rastreamento de leads e CRM.**

**<u>42 - GOOGLE SHEETS</u>**

## O que Você Vai Aprender

* Configurar automações pós-chamada com lógica condicional
* Criar integração com Google Sheets para rastreamento de leads
* Configurar o mapeamento de dados das chamadas para a planilha
* Construir automaticamente um banco de dados de leads qualificados
* Monitorar e otimizar seu processo de coleta de leads

## Pré-requisitos

* Assistente de IA configurado com variáveis pós-chamada
* Conta Google com acesso ao Google Sheets
* Compreensão sobre automação com webhook pós-chamada
* Acesso à funcionalidade de teste de chamadas

## Etapa 1: Configure o Gatilho de Automação Pós-Chamada

Vamos começar criando uma automação que será acionada quando uma chamada telefônica for encerrada.

<img src="https://mintcdn.com/mayahub/jLorboul40ctksf_/images/01-create-assistant(1).avif?fit=max&auto=format&n=jLorboul40ctksf_&q=85&s=e2a19dfd07be6e108dc9e4c59bf0ab35" alt="01-create-assistant (1).avif" width="1764" height="333" data-path="images/01-create-assistant(1).avif" />

<img src="https://mintcdn.com/mayahub/jLorboul40ctksf_/images/01-create-assistant(1).avif?fit=max&auto=format&n=jLorboul40ctksf_&q=85&s=e2a19dfd07be6e108dc9e4c59bf0ab35" alt="01-create-assistant (1).avif" width="1764" height="333" data-path="images/01-create-assistant(1).avif" />

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/01-create-new-flow.mp4" />

1. Acesse a **plataforma de automação**
2. Crie um novo fluxo do zero (**from scratch**)
3. Pesquise pela sua **plataforma de chamadas** na seção de gatilhos
4. Selecione o gatilho **"Phone Call Ended"**
   * Esse gatilho é ativado quando qualquer chamada para o assistente selecionado for concluída

## Etapa 2: Configure o Assistente e o Webhook

<img src="https://mintcdn.com/mayahub/jLorboul40ctksf_/images/03-prompts-and-tools-tab.avif?fit=max&auto=format&n=jLorboul40ctksf_&q=85&s=524c136087c25b1cab4c50bed8732dcc" alt="03-prompts-and-tools-tab.avif" width="560" height="517" data-path="images/03-prompts-and-tools-tab.avif" />

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/03-select-assistant.mp4">
  <img src="https://mintcdn.com/mayahub/jLorboul40ctksf_/images/03-prompts-and-tools-tab.avif?fit=max&auto=format&n=jLorboul40ctksf_&q=85&s=524c136087c25b1cab4c50bed8732dcc" alt="03-prompts-and-tools-tab.avif" width="560" height="517" data-path="images/03-prompts-and-tools-tab.avif" />
</video>

1. Selecione o assistente que você deseja automatizar
   * Cada assistente pode ter apenas uma automação de **"phone call ended"**
   * Todas as chamadas para esse assistente passarão por essa automação
2. Clique em **"Test Trigger"** para gerar o webhook
   * Isso criará uma URL de webhook em segundo plano\
     O webhook será salvo automaticamente nas configurações do seu assistente

## Etapa 3: Verifique a Configuração do Webhook

<img src="https://mintcdn.com/mayahub/jLorboul40ctksf_/images/06-create-campaign.avif?fit=max&auto=format&n=jLorboul40ctksf_&q=85&s=bcd81fae05a0f43115bec108949fad5d" alt="06-create-campaign.avif" width="1655" height="470" data-path="images/06-create-campaign.avif" />

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/05-check-assistant-webhook.mp4" />

1. Abra uma nova aba e acesse seu assistente
2. Vá para a terceira aba **"Post-call Actions"**
3. Verifique se a URL do webhook foi adicionada automaticamente

<Frame />

4. Revise as configurações do **webhook**:
   * **Enabled:** O webhook será acionado após as chamadas
   * **Completed calls only:** Somente chamadas bem-sucedidas acionam a automação
   * **All calls:** Altere para "No" se quiser que todas as chamadas (inclusive as com falha) acionem o gatilho

<Frame />

* **Revise as variáveis pós-chamada:**

  * **status:** Booleano (true/false) indicando se o objetivo da chamada foi alcançado
  * **summary:** Resumo em texto da conversa durante a chamada

  Essas variáveis são extraídas pela IA após cada chamada

## Etapa 4: Gere Dados de Teste de Chamada

Para configurar nossa automação corretamente, precisamos de dados reais de chamada. Vamos fazer uma chamada de teste para gerar as variáveis pós-chamada.

<Frame>
  <img src="https://mintcdn.com/mayahub/jLorboul40ctksf_/08-set-test-values.avif?fit=max&auto=format&n=jLorboul40ctksf_&q=85&s=239895b957e4dc16535419132e428f37" alt="Setting test values for call variables" width="840" height="774" data-path="08-set-test-values.avif" />
</Frame>

1. Defina valores reais nas variáveis de chamada do seu assistente:
   * Insira seu **nome** e **e-mail** como dados de teste realistas
   * Esses serão os valores padrão usados ao testar diretamente pelo assistente

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/09-make-test-call.mp4" />

2. Faça uma chamada de teste para gerar os dados do webhook:
   * Clique em **"Speak to Assistant"** → **"Phone Call"**
   * Atenda quando seu assistente ligar para você
   * Responda de forma positiva para garantir que a variável **status** seja marcada como **true**
   * Complete o objetivo da chamada durante a conversa
   * Encerre a chamada de forma natural

<Note>
  Em uma situação real, o assistente usará os dados atribuídos ao lead. Para testes, ele utiliza os valores padrão que você acabou de definir.
</Note>

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/10-check-call-results.mp4" />

3. **Verifique os resultados da chamada e a extração das variáveis:**

   * Acesse sua lista de chamadas e localize a chamada recente
   * Clique na chamada para ver os detalhes
   * Confirme se a variável **status** está como **true** (objetivo da chamada alcançado)
   * Revise o **summary** extraído — este é o resumo da chamada gerado pela IA

   Essas variáveis são extraídas após cada chamada com base em:

   * Transcrição da chamada
   * Descrições das variáveis
   * Tipos de variáveis (Booleano para status)
   * Contexto do prompt do sistema

<Note>
  As variáveis pós-chamada estão sendo extraídas. Você pode atualizar a página após cerca de um minuto para visualizar as variáveis extraídas.
</Note>

## Etapa 5: Configure a Automação com os Dados da Chamada

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/11-received-call-data.mp4" />

1. Volte para a aba da sua automação
2. Verifique se você recebeu os dados da chamada a partir do gatilho de teste
   * Você deve ver os dados do webhook porque clicou em **"Test Trigger"** e em seguida realizou uma chamada

     A automação recebeu a requisição após o término da chamada e a extração das variáveis
3. **Método alternativo – reenviar dados do webhook de chamadas existentes:**

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/12-resend-webhook.mp4" />

* Se você precisar testar com dados de chamadas diferentes, pode reutilizar qualquer chamada existente
* Clique em **"Test Trigger"** novamente na sua automação
* Vá até qualquer chamada concluída na sua plataforma
* Clique em **"Resend Webhook"** para enviar os dados dessa chamada para sua automação
* Retorne à aba da automação para ver os dados atualizados

### **Adicionando Novas Variáveis Pós-Chamada**

<Note>
  Se você precisar adicionar uma nova variável pós-chamada após criar a automação, siga este processo para atualizar sua automação com os dados da nova variável.
</Note>

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/add-variable.mp4" />

1. **Defina a nova variável no seu assistente**:
   * Vá até as configurações do assistente → aba **"Post-call Actions"**
   * Adicione sua nova variável pós-chamada (**nome**, **tipo**, **descrição**)
   * **Salve o assistente**
2. Atualize a automação com os dados da nova variável:
   * Volte para a sua **automação**
   * Clique em **"Test Trigger"** para preparar o recebimento dos novos dados do webhook
3. **Reavalie uma chamada existente:**

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/re-evaluate.mp4" />

* Vá até qualquer chamada concluída desse assistente
* Clique em **"Re-evaluate"** para extrair a nova variável dessa chamada
* **Aguarde até que o processamento seja concluído**

4. **Envie os dados atualizados para a automação:**
   * Clique em **"Resend Webhook"** na mesma chamada
   * Retorne à aba da automação
   * Verifique se a nova variável agora está disponível nos dados da sua automação

<Tip>
  Esse recurso de reenvio é útil para testar diferentes cenários sem precisar fazer novas chamadas a cada vez.
</Tip>

## Etapa 6: Adicione Lógica Condicional para Leads Qualificados

Queremos adicionar leads ao Google Sheets apenas quando o objetivo da chamada for alcançado.

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/13-add-branch.mp4" />

1. Clique no ícone **"+"** para adicionar uma nova etapa
2. Pesquise por **"Branch"** em **control flow**
3. Selecione **Branch** para criar a lógica condicional

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/14-configure-status-condition.mp4" />

4. Configure a condição do branch:
   * Selecione a variável **status** dos dados da chamada
   * Escolha **"Boolean is true"**
   * Isso criará dois caminhos: **True (qualificado)** e **False (não qualificado)**

## Etapa 7: Crie a Integração com o Google Sheets

Agora vamos configurar a ação do Google Sheets para os leads qualificados (**ramo True**).

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/15-add-google-sheets-action.mp4" />

1. No ramo **True**, clique no ícone **"+"**
2. Pesquise por **"Google Sheets"**
3. Selecione a ação **"Insert Row"**

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/16-create-sheets-connection.mp4" />

4. Crie uma nova conexão com o **Google Sheets**:
   * Autorize com sua **conta do Google**
   * Salve a conexão para uso futuro

## Etapa 8: Configure Sua Planilha de Leads Qualificados

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/18-spreadsheet-headers.mp4" />

1. Crie uma nova planilha no Google Sheets chamada, por exemplo, **"successful calls"**
2. Configure os cabeçalhos das colunas:
   * **Coluna A:** phone\_number
   * **Coluna B:** summary
3. Adicione mais colunas para dados adicionais, conforme necessário

## Etapa 9: Configure a Seleção da Planilha

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/19-select-target-spreadsheet.mp4" />

1. Volte para sua automação
2. Selecione a planilha **"successful calls"**
3. Escolha a aba correta (geralmente **"Sheet1"**)

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/20-enable-headers.mp4" />

4. Ative a opção **"First row contains headers"**
5. Isso informa à automação sobre a estrutura das suas colunas
6. Os cabeçalhos devem ser carregados e exibidos automaticamente

## Etapa 10: Mapeie os Dados da Chamada para as Colunas da Planilha

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/21-map-phone-number.mp4" />

1. **Mapear o número de telefone:**
   * Clique no campo **phone\_number**
   * Selecione a fonte de dados **Phone Call Ended**
   * Encontre e selecione o número de telefone nos dados da chamada
   * Clique em **Insert**

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/23-map-summary.mp4" />

2. **Mapear o resumo da chamada:**
   * Clique no campo **summary**
   * Navegue até **Post Call Variables**
   * Selecione a variável **summary**
   * Clique em **Insert**
3. **Mapear campos adicionais:**
   * **Email** a partir das variáveis da chamada
   * **Data/Hora da chamada** a partir dos metadados da chamada
   * Quaisquer **variáveis personalizadas** que você tenha definido

## Etapa 11: Testar e verificar

<video autoPlay muted loop playsinline src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/25-test-sheets-integration.mp4" />

1. Clique em **Test Step** para verificar a integração
2. Verifique se a execução foi bem-sucedida
3. Vá até sua **planilha do Google Sheets** para confirmar:
   * Uma nova linha foi adicionada com os dados corretos
   * Todos os campos mapeados foram preenchidos corretamente
   * A formatação dos dados está correta

## Etapa 12: Publicar e monitorar

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/mayahub/resources/tutorials/qualified-leads/27-publish-automation.png" alt="Publishing the automation" />
</Frame>

1. Clique em **Publish** para ativar sua automação
2. O rastreamento de **leads qualificados** agora está ativo
3. Monitore o desempenho da automação:
   * Verifique a seção **Runs** para o histórico de execuções
   * Confirme se os **leads qualificados** estão sendo adicionados à sua planilha
   * Acompanhe possíveis **falhas de execução**

## Solução de Problemas

## Problemas Comuns

**Leads não aparecem na planilha:**

* Verifique se a conexão com o **Google Sheets** está autorizada
* Confirme se a automação está **publicada e ativa**
* Certifique-se de que as chamadas estão acionando o **status = true**
* Verifique se a **condição de ramificação** está configurada corretamente

**Dados incompletos na planilha:**

* Confira todos os **mapeamentos de campos** na automação
* Verifique se as **variáveis pós-chamada** estão sendo extraídas corretamente
* Confirme se os **cabeçalhos da planilha** correspondem aos campos da automação
* Faça testes com **diferentes cenários de chamada**

***

### Próximas Etapas

Quando sua automação de leads qualificados estiver funcionando:

* Adicione **pontuação de leads** com base na qualidade da chamada
* Crie **automações de acompanhamento** para leads quentes
* **Integre** com plataformas de **email marketing**
* Configure **painéis analíticos** para rastrear conversões
* Expanda para **múltiplas campanhas e fontes de leads**

Seus **leads qualificados** agora serão capturados e organizados automaticamente no **Google Sheets**, criando uma base poderosa para seus processos de vendas e follow-up!