---
title: "Integração na prática: Planilhas Google para o Rastreamento CustomerX"
description: "Transforme linhas de uma planilha em eventos de uso no CustomerX, alimentando o Tracking e o Health Score, sem digitar nada à mão."
url: https://ajuda.customerx.com.br/pt-br/articles/210-integracao-na-pratica-planilhas-google-para-o-rastreamento-customerx
collection: "Integração dos APPs"
updated: 2026-11-09
language: pt-br
---

# Integração na prática: Planilhas Google para o Rastreamento CustomerX

Transforme linhas de uma planilha em eventos de uso no CustomerX, alimentando o Tracking e o Health Score, sem digitar nada à mão.

Transforme linhas de uma planilha em eventos de uso no CustomerX, alimentando o Tracking e o Health Score, sem digitar nada à mão.

> **Info:** O CX Connect fica em cliente.customerx.com.br/connect, na aba Automações. Você pode ver as ações de cada app antes de conectar qualquer conta, e cada dado gravado consome uma transação do plano.

## O que vamos construir

Muitas empresas têm dados de uso do produto numa planilha do Google: um relatório exportado do sistema, um controle preenchido pelo time, um export de BI. O problema é que esses dados ficam parados lá, e o CustomerX não os enxerga. Nesta integração, cada linha nova da planilha vira automaticamente um evento de uso dentro do CustomerX, pela ação do Rastreamento. No fim, o Tracking passa a refletir o uso real e o Health Score dos clientes fica mais inteligente, sem ninguém lançar nada na mão.

## Antes de começar, você vai precisar de três coisas

1.  Uma conta Google com acesso à planilha. Você vai conectá-la ao CX Connect, se ainda não conectou.
    
2.  A planilha organizada, com os títulos das colunas na primeira linha. Uma sugestão de colunas: identificador do cliente (o CNPJ ou o código que vocês usam), nome do evento de uso (algo como "login" ou "relatorio\_gerado") e data. Uma linha para cada evento.
    
3.  As chaves de integração do Rastreamento CustomerX, identificadas como Credential e Key na tela de conexão, podem ser encontradas no ambiente da plataforma acessando o menu Empresa. Para isso, clique no **ícone de engrenagem** localizado no canto superior direito da tela e selecione **“Empresa”**. Na seção **“Suas credenciais desta conta”**, clique em “Visualizar credenciais” para revelar os tokens necessários para a integração. Caso essas informações não estejam disponíveis em sua conta, entre em contato com o suporte da CustomerX, que poderá fornecer ambas as credenciais.
    

## Passo 1: criar a automação

No CustomerX, abra o CX Connect (menu Connect) e, na aba Automações, clique em **Nova automação**. Você vai ver dois blocos: "Selecione um App para enviar os dados", que é a origem, e "Selecione um App para receber os dados", que é o destino.

## Passo 2: configurar o gatilho com o Planilhas Google

1.  No bloco de cima (enviar os dados), clique no sinal de mais.
    
2.  Em "Escolha uma app para enviar seus dados", busque e selecione **Google Sheets**.
    
3.  Em "Escolha um evento que acione a automação", selecione **Criar/atualizar uma linha**. É ele que dispara a cada linha nova. A outra opção, **Célula atualizada**, serve para um caso diferente: reagir quando alguém altera células de linhas que já existiam.
    
4.  Em "Conecte sua conta Google Sheets", escolha a conexão da conta Google. Se for a primeira vez, clique em **\+ Conectar App** e autorize com a conta do Google que tem acesso à planilha.
    
5.  Nos **Parâmetros da Chave de Acesso**, selecione nos dois campos: primeiro a **planilha** (o arquivo) e depois a **aba** dentro dela.
    
6.  Clique em **Continuar**.
    

## Passo 3: escolher o modo de execução

Vai aparecer a pergunta "Dados de um período a serem enviados?", com duas opções:

-   **Em tempo real (coleta de dados do período atual)**, que é o padrão. A automação passa a olhar para a frente, só para as linhas novas a partir de agora.
    
-   **Migração de dados (coleta de dados para um período específico no passado)**, para quando você quiser trazer o histórico que já está na planilha.
    

Para o dia a dia, mantenha **Em tempo real** e clique em **Salvar**. Se precisar importar o passado, faça primeiro uma rodada no modo de migração, lembrando que cada linha histórica também consome transação.

## Passo 4: configurar a ação com o Rastreamento CustomerX

1.  No bloco de baixo (receber os dados), clique no sinal de mais.
    
2.  Busque e selecione **Rastreamento CustomerX**. Atenção: é o conector específico de eventos de uso. Não confunda com o conector "CustomerX", que cuida de cadastros, como clientes, contatos e contratos.
    
3.  A ação **Criar rastreador** já vem selecionada. É a única deste conector e é exatamente o que queremos: criar o registro de uso.
    
4.  Em "Conecte sua conta Rastreamento CustomerX": na primeira vez, a lista estará vazia ("Você ainda não tem nenhuma Chave de Acesso"). Clique em **\+ Conectar App** e preencha os três campos obrigatórios: um **nome para a conexão** (pode manter o sugerido), a **Credential** e a **Key**, que são as chaves do passo "Antes de começar".
    
5.  Clique em **Continuar**.
    

## Passo 5: mapear as colunas da planilha

Agora o CX Connect mostra os campos do rastreador para você ligar às colunas da planilha. Indique qual coluna traz o identificador do cliente, qual traz o evento e qual traz a data. Duas regras de ouro:

-   Use um **identificador estável** do cliente, como o CNPJ ou o código, igual ao que existe no CustomerX. É ele que liga o evento ao cliente certo.
    
-   Confira os campos exatos na tela. Eles aparecem depois que a conexão é criada, e são esses que valem.
    

## Passo 6: testar e ativar

1.  Deixe uma linha de exemplo preenchida na planilha.
    
2.  Use o botão **Teste** da automação e confira se o evento apareceu no CustomerX (menu Tracking, em Logs do Tracking).
    
3.  Deu certo? Ative a automação. A partir daí, toda linha nova vira evento de uso sozinha.
    

## Quanto isso consome do plano

Cada linha gravada consome **1 transação** do CX Connect. Uma planilha que recebe 30 linhas por dia gasta cerca de 900 transações por mês. Confira seu limite no painel "Consumo do CX | Connect", no topo da tela. Se a planilha for gigante, vale filtrar o que realmente precisa virar evento.

## Se algo não funcionar

-   **Nada disparou ainda**: este gatilho é do tipo consulta, ou seja, o CX Connect verifica a planilha de tempos em tempos. Espere alguns minutos antes de concluir que falhou.
    
-   **Continuou sem disparar**: veja a aba **Histórico** da automação. Sem registro, o gatilho não viu linha nova, então confira se a linha está na aba certa e abaixo do cabeçalho. Com erro, a mensagem indica a causa.
    
-   **O evento não apareceu no cliente certo**: confira o mapeamento do identificador. Provavelmente a coluna ligada não bate com o código do cliente no CustomerX.
    
-   **A conexão falhou**: revise a Credential e a Key. São as do Tracking, não as de outra área.
    

## Artigos relacionados

[

Planilhas Google + CX Connect: da planilha viva ao CustomerX (e de volta)

Planilha é onde os dados "soltos" da empresa moram — listas, controles, levantamentos. Conectada ao CX Connect, a planilha deixa de ser uma cópia desatualizada e vira porta de entrada e saída de dados do CustomerX.

](https://ajuda.customerx.com.br/pt-br/articles/220-planilhas-google-cx-connect-da-planilha-viva-ao-customerx-e-de-volta.md)[

Mapeamento de campos

Como ligar os campos da ferramenta de origem aos campos do CustomerX para que os dados entrem no lugar certo.

](https://ajuda.customerx.com.br/pt-br/articles/177-mapeamento-de-campos.md)
