---
title: "Instruções de Configuração do n8n"
description: "O nó comunitário do Localith para n8n permite-lhe ligar a sua conta Localith a fluxos de trabalho do n8n para automatizar avaliações, fichas e relatórios de desempenho nos seus Perfis do Google Business."
---

O nó comunitário do Localith para n8n permite-lhe ligar a sua conta Localith a fluxos de trabalho do n8n para automatizar avaliações, fichas e relatórios de desempenho nos seus Perfis do Google Business.

Se precisar primeiro da visão geral de funcionalidades, do contexto de acesso à API ou de orientação sobre implementação, comece pela nossa página da [ferramenta API para Google Business Profile](/pt/api/).

## Visão geral

Com este nó pode obter avaliações, listar e atualizar fichas, recuperar métricas de desempenho e criar fluxos de trabalho que ligam o Localith ao Slack, Google Sheets, Airtable, e-mail e qualquer outro serviço compatível com o n8n.

## Antes de começar

Antes de instalar o nó, certifique-se de que tem:

- acesso à sua conta Localith
- permissão para criar ou gerir chaves API
- um espaço de trabalho n8n com a versão 0.187 ou posterior
- pelo menos uma conta Google Business Profile ligada ao Localith se quiser testar operações em tempo real

## Instalar o nó Localith no n8n

O nó Localith está disponível como nó comunitário dentro do n8n. Pode encontrá-lo e instalá-lo diretamente a partir da pesquisa de nós do n8n.

- Abra a sua instância do n8n e vá a **Definições > Nós Comunitários**.
- Pesquise por **Localith** na pesquisa de nós.
- Clique em **Instalar** e aguarde que o nó seja adicionado ao seu espaço de trabalho.

[PLACEHOLDER: captura de ecrã — n8n Definições > Nós Comunitários com o nó Localith pronto para instalar]

> **Nota:** Os nós comunitários requerem o n8n versão 0.187 ou posterior. Se estiver a utilizar uma versão mais antiga, atualize o n8n primeiro.

## Configurar as suas credenciais API

Para autenticar o nó Localith, precisa de uma chave API do seu painel Localith. Após criadas, as credenciais são reutilizáveis em todos os seus fluxos de trabalho do n8n.

- Inicie sessão no seu painel Localith, clique no menu **Conta** na parte inferior da barra lateral e selecione **[Chave API](/pt/docs/integrations/api-access/)**.
- Copie a chave da janela que aparece.

![Janela da chave API do Localith](/images/docs/integrations/api-access--api-key.jpg "Copie a sua chave API a partir de Conta > Chave API")

- No n8n, abra o painel de credenciais do nó Localith e cole a sua chave API.
- Guarde as credenciais. Agora pode utilizá-las em qualquer fluxo de trabalho que inclua o nó Localith.

![Painel de credenciais do n8n configurado para o nó comunitário Localith](/images/docs/integrations/n8n-setup--credentials.jpg "Nó comunitário Localith instalado no n8n com ações disponíveis")

## Como funciona

O nó Localith do n8n funciona como uma ponte entre a sua conta Localith e qualquer fluxo de trabalho que crie no n8n.

Na prática, isso significa que pode:

- extrair dados operacionais do Localith para fluxos de trabalho de relatórios ou notificações
- acionar ações de seguimento quando surgem novas avaliações ou alterações nas fichas
- utilizar o Localith como camada de dados do Google Business Profile dentro de automatizações maiores

A lógica exata do fluxo de trabalho continua a residir no n8n. O Localith fornece o acesso à conta, as operações sobre recursos e a ligação de dados autenticada.

## Operações disponíveis

O nó Localith do n8n suporta 7 operações organizadas em três categorias de recursos.

- **Avaliações** — Obtenha os dados das suas avaliações a partir das fichas ligadas. Utilize isto para encaminhar novas avaliações para o Slack, sincronizá-las numa folha de cálculo ou acionar [fluxos de trabalho de resposta com IA](/pt/docs/ai-review-reply/reply-agent-setup/).
- **Fichas** — Obtenha todas as localizações Google Business Profile ligadas, recupere detalhes de uma localização específica ou atualize informações da ficha como horários, descrições e atributos.
- **Métricas** — Obtenha dados de desempenho incluindo impressões, cliques, chamadas e pedidos de direções por localização. Recupere métricas ao nível de item para publicações ou produtos individuais.

## Fluxo de configuração passo a passo

Utilize esta sequência para uma primeira configuração limpa:

1. Instale o nó comunitário Localith no n8n.
2. Gere uma chave API a partir da sua conta Localith.
3. Adicione as credenciais Localith dentro do n8n.
4. Comece com um fluxo de trabalho apenas de leitura, como obter avaliações ou métricas.
5. Teste o resultado e confirme a estrutura dos dados antes de adicionar ações a jusante.
6. Expanda para fluxos de trabalho de notificação, relatórios ou atualização quando a ligação estiver estável.

[PLACEHOLDER: vídeo — demonstração de 45 segundos da instalação do nó Localith no n8n e primeiro teste de credenciais]

## Exemplos de fluxos de trabalho

- **Notificações Slack para novas avaliações** — Acione um fluxo de trabalho quando chega uma nova avaliação e publique-a num canal Slack para que a pessoa certa a veja imediatamente.
- **Sincronização automática com Google Sheets ou Airtable** — Extraia dados de avaliações ou métricas de fichas para uma folha de cálculo num horário recorrente para relatórios ou análise.
- **Relatório semanal de desempenho por e-mail** — Agregue métricas de localização e envie um resumo formatado aos responsáveis todas as segundas-feiras de manhã.
- **Geração de respostas a avaliações com IA** — Obtenha novas avaliações, passe-as a um modelo de IA para gerar rascunhos de respostas e coloque os rascunhos em fila para aprovação humana antes de publicar.
- **Gestão de múltiplas localizações através de fluxos de trabalho únicos** — Crie um fluxo de trabalho que atualize horários, envie alterações de fichas ou acione alertas em todas as suas localizações sem repetição manual.

## Limites ou casos especiais

- A disponibilidade de nós comunitários depende do seu ambiente e versão do n8n.
- A utilização da API deve seguir as permissões da sua conta Localith e os limites de taxa.
- Se planeia escrever alterações de volta nas fichas, teste primeiro num conjunto limitado de localizações.
- Alguns fluxos de trabalho podem requerer ramificação adicional, lógica de aprovação ou validação dentro do n8n antes de os utilizar em produção.

## Perguntas frequentes

**P: Posso usar a mesma chave API em vários fluxos de trabalho?**

Sim. Depois de criar credenciais no n8n, estas são reutilizáveis em qualquer fluxo de trabalho no seu espaço de trabalho.

**P: Existe um limite de taxa?**

O Localith aplica limites de taxa API padrão. Para a maioria das equipas, a restrição prática é o design do fluxo de trabalho, não a API.

**P: Onde posso obter ajuda?**

Contacte support@localith.ai ou visite o centro de ajuda do Localith para orientação adicional.
