> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Google Sheets > Como conectar o Google Sheets a um agente do ChatNorris e configurar a Ação que adiciona uma linha na sua planilha para cada contato confirmado, para cada envio de um Lead Form ou quando o lead passa para um status, e que pode manter a linha atualizada. # Google Sheets Com a Ação **Google Sheets**, cada contato que seu agente do ChatNorris capta fica anotado em uma planilha do Google. Quando um visitante deixa o email ou o telefone (no chat, em um Lead Form ou em qualquer canal), o agente adiciona uma linha com os dados que você escolher: nome, email, telefone, os campos do seu Lead Form, o canal e o link para a conversa, entre outros. É a forma mais simples de ter seus leads em um lugar que toda a sua equipe já sabe usar, sem exportar nada manualmente nem pagar por um CRM. ## Requisitos * Uma conta do ChatNorris em qualquer plano. O Google Sheets está incluído em todos, inclusive no **Free**. Você pode ver os planos em [chatnorris.ai/pricing](https://chatnorris.ai/pricing). * Pelo menos um agente criado no ChatNorris. Se você ainda não tem um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md). * Uma conta do Google (Gmail ou Google Workspace). * Função **Owner** ou **Admin** na sua organização do ChatNorris. ## Conectar sua conta do Google Cada agente se conecta a uma conta do Google. Todas as Ações de Google Sheets desse agente usam essa mesma conta. **1. Abra o hub de Integrações do agente** No ChatNorris, acesse `Agentes → [seu agente] → Integrações` e escolha **Google Sheets** no catálogo. **2. Clique em Conectar com Google** O Google é aberto. Escolha a conta com a qual você quer trabalhar. **3. Aceite a permissão** O Google pede acesso aos arquivos do Drive que você escolher com o ChatNorris. Deixe essa permissão marcada: se você desmarcá-la, a conexão não é salva. **4. Volte ao ChatNorris** O Google leva você de volta à página da integração, que mostra **Conectado como** e seu email. Com **Testar conexão** você pode verificar se tudo funciona. Continue com [Configurar a Ação](#configurar-a-ação). > [!NOTE] > > O ChatNorris só vê as planilhas que você escolhe ou que cria pelo ChatNorris e, nelas, só lê os cabeçalhos e adiciona linhas. Ele não vê o resto do seu Drive nem modifica ou apaga linhas existentes. ## Configurar a Ação Conectar o Google ainda não grava nada. Para escolher para qual planilha vão os contatos: **1. Crie a Ação Google Sheets** Acesse `Agentes → [seu agente] → Ações`, clique em **Nova ação** e escolha **Google Sheets**. **2. Escolha quando uma linha é adicionada** * **Cada contato confirmado:** quando o visitante deixa o email ou telefone, por qualquer via (Lead Form, conversa ou canal). * **Somente quando um Lead Form é enviado:** você escolhe um Lead Form específico do agente. Útil se o agente tem vários formulários e você quer que cada um vá para sua própria planilha. * **Quando o lead passa para um status:** você escolhe um ou mais status dos seus [Leads](https://docs.chatnorris.ai/pt/guias/leads.md), por exemplo «Qualificado». A linha é adicionada quando alguém da sua equipe coloca esse status no lead (na lista ou no quadro). Se o contato já estiver nesse status quando for confirmado, a linha também é adicionada. Em **Canais** você pode limitar a Ação aos contatos de alguns canais, por exemplo apenas WhatsApp. Com todos marcados, ela vale para todos. **3. Escolha a planilha** Com **Escolher planilha do Google** você abre o seletor do Google e escolhe uma planilha do seu Drive. Se preferir começar do zero, **Criar planilha nova** a cria no seu Drive com o nome que você quiser (por padrão, «Leads de \[seu agente]») e com os cabeçalhos já escritos. Depois escolha a **Aba** onde as linhas são adicionadas. **4. Revise as colunas** Indique qual dado vai em cada coluna (veja [Colunas](#colunas)). **5. Envie uma linha de teste** Em **Testar**, clique em **Enviar linha de teste**. É adicionada uma linha com dados de exemplo para que você verifique a planilha e as colunas. Você pode apagá-la depois. **6. Habilite a Ação e salve** A partir desse momento, cada contato que cumprir a condição escolhida adiciona uma linha. > [!TIP] > > Um agente pode ter várias Ações de Google Sheets, cada uma com sua planilha. Por exemplo, o Lead Form de orçamentos em uma planilha e o de reclamações em outra. ## Colunas Cada coluna tem um **Cabeçalho** (o título da primeira linha) e um **Dado** (o que o ChatNorris escreve ali). * **Se a aba já tem cabeçalhos**, o ChatNorris os lê e associa cada um ao dado correspondente (por exemplo, «Email» ao email do visitante). Revise a associação e corrija o que for preciso. * **Se a aba está vazia**, o ChatNorris escreve os cabeçalhos na primeira linha. Com **Usar colunas sugeridas** você começa com: Data, Nome, Email, Telefone, Agente, Canal, Conversa e ID ChatNorris. Os dados que você pode escolher são agrupados assim: | Grupo | O que inclui | | - | - | | **Este Lead Form** | Os campos do Lead Form escolhido como gatilho. | | **Contato** | Os campos padrão do contato: nome, email, telefone, empresa e os demais. | | **Campos personalizados** | As colunas personalizadas que você criou nos seus [Leads](https://docs.chatnorris.ai/pt/guias/leads.md). | | **ChatNorris** | Data (no fuso horário do agente), Agente, Canal, Conversa (o link para a conversa no ChatNorris), Status do lead e ID ChatNorris. | No final da seção fica **Manter a linha atualizada** (veja [O que é escrito e quando](#o-que-é-escrito-e-quando)). Você pode ter até 30 colunas. Uma coluna sem dado (**— Não preencher —**) fica vazia em cada linha, caso você queira usá-la para suas próprias anotações. > [!NOTE] > > A coluna **ID ChatNorris** é obrigatória: se o Google falhar e a linha for enviada novamente, com ela o ChatNorris evita escrevê-la duas vezes. Os valores são escritos abaixo do cabeçalho correspondente, mesmo que depois você reordene as colunas ou adicione outras na planilha. Tudo é salvo como texto: se um visitante escrever algo que parece uma fórmula (por exemplo, que começa com `=`), é salvo como texto e não é executado. ## O que é escrito e quando * **Uma linha por contato.** Se o visitante confirmar seus dados novamente, a linha não se repete. * **A linha pode ser mantida atualizada.** Por padrão, ela reflete os dados do momento em que foi adicionada. Se você ativar **Manter a linha atualizada**, quando o lead muda de status, acrescenta dados em uma conversa ou alguém o edita em [Leads](https://docs.chatnorris.ai/pt/guias/leads.md), o ChatNorris reescreve as células dele na linha que já adicionou. Ele a encontra pela coluna **ID ChatNorris** e não mexe nessa coluna nem nas suas colunas próprias. Se você apagou a linha manualmente, ele não a adiciona de novo. * **Funciona em todos os canais:** widget web, WhatsApp, Instagram, Messenger, Telegram, Email e a API. * **Sem a conversa completa.** A planilha recebe o link para a conversa, nunca o conteúdo dela. > [!WARNING] > > A planilha fica na sua conta do Google com os dados dos seus contatos, e quem tiver acesso a ela poderá vê-los. Mapeie apenas os campos de que você precisa e revise com quem você a compartilha. ## Status e novas tentativas O formulário da Ação tem um bloco **Status** com as linhas adicionadas, as pendentes e as que falharam, a data da última linha e o motivo da última falha. * **Pendentes:** se o Google não responder, a linha é reenviada automaticamente, com esperas cada vez mais longas, até 6 tentativas em algumas horas. Se a conta do Google precisar ser reconectada, a linha espera sem gastar tentativas, por até 7 dias. * **Com falha:** se a linha não puder ser escrita (por exemplo, porque você apagou a planilha ou a aba, porque o ChatNorris perdeu o acesso ou porque as tentativas acabaram), os Owners e Admins recebem um aviso no sino de notificações com o motivo. * **Linhas atualizadas:** com **Manter a linha atualizada** ativo, o bloco mostra também a data da última linha atualizada e quantas linhas têm alterações a escrever. * **Tentar novamente as que falharam:** quando você resolver o problema (por exemplo, reconectando a conta ou devolvendo o acesso à planilha), esse botão coloca de novo na fila as linhas que falharam, e elas são reenviadas nos próximos 10 minutos. Cada linha é reenviada para a planilha e a aba às quais se destinava originalmente. ## Desconectar Em `Agentes → [seu agente] → Integrações → Google Sheets`, clique em **Desconectar**. As Ações de Google Sheets desse agente deixam de adicionar linhas e mantêm sua configuração. As planilhas e suas linhas continuam no seu Drive. Para voltar a enviar contatos, conecte o Google novamente. ## Perguntas frequentes > [accordion] Conectar o Google Sheets consome créditos? > > Não. Adicionar linhas não usa IA, então não consome créditos. > [accordion] Não vejo minha planilha no seletor > > O seletor mostra o Drive da conta do Google conectada no ChatNorris. Se a planilha for de outra conta, peça que ela seja compartilhada com você com permissão de edição ou crie uma nova pelo ChatNorris. > [accordion] Renomeei a aba. A configuração se perde? > > Não. O ChatNorris lembra a aba mesmo que o nome dela mude. Se você a apagar, as novas linhas ficam como com falha e você recebe um aviso: escolha outra aba na Ação para os próximos contatos. Os contatos das linhas com falha continuam nos seus [Leads](https://docs.chatnorris.ai/pt/guias/leads.md), de onde você pode exportá-los. > [accordion] Adicionei uma coluna na planilha. O que acontece com as novas linhas? > > Elas continuam sendo escritas abaixo do cabeçalho correspondente. A coluna nova fica vazia até que você atribua um dado a ela na Ação. > [accordion] Mudei o status de muitos leads ao mesmo tempo e a planilha demorou > > É normal. O Google limita quantas gravações podem ser feitas por minuto, então, quando você altera mais de 5 leads de uma vez, as linhas são adicionadas ou atualizadas nos próximos 10 minutos em vez de instantaneamente. > [accordion] A integração aparece como Requer atenção > > O Google deixou de aceitar o acesso: por exemplo, porque você o removeu em [myaccount.google.com/permissions](https://myaccount.google.com/permissions) ou alterou a senha da conta. Conecte o Google novamente pelo hub de Integrações e use **Tentar novamente as que falharam** em cada Ação. ## Suporte Precisa de ajuda com a configuração? Escreva para [hola@chatnorris.ai](mailto:hola@chatnorris.ai). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.