Transforme linhas de uma planilha em eventos de uso no CustomerX, alimentando o Tracking e o Health Score, sem digitar nada à mão.
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.
Uma conta Google com acesso à planilha. Você vai conectá-la ao CX Connect, se ainda não conectou.
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.
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.
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.
No bloco de cima (enviar os dados), clique no sinal de mais.
Em "Escolha uma app para enviar seus dados", busque e selecione Google Sheets.
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.
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.
Nos Parâmetros da Chave de Acesso, selecione nos dois campos: primeiro a planilha (o arquivo) e depois a aba dentro dela.
Clique em Continuar.
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.
No bloco de baixo (receber os dados), clique no sinal de mais.
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.
A ação Criar rastreador já vem selecionada. É a única deste conector e é exatamente o que queremos: criar o registro de uso.
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".
Clique em Continuar.
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.
Deixe uma linha de exemplo preenchida na planilha.
Use o botão Teste da automação e confira se o evento apareceu no CustomerX (menu Tracking, em Logs do Tracking).
Deu certo? Ative a automação. A partir daí, toda linha nova vira evento de uso sozinha.
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.
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.
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.
Mapeamento de campos
Como ligar os campos da ferramenta de origem aos campos do CustomerX para que os dados entrem no lugar certo.
