n8n

Last updated 6 de nov. de 2026 Ver como Markdown Configuração do agente

Um fluxo de trabalho de quatro nós: dados de nascimento na entrada, um mapa natal da API no meio, e os signos do Sol, Lua e Ascendente na saída. Foi importado para o n8n 2.39.7 e executado em produção a 17-09-2026, e o resultado abaixo é exatamente o que ele retornou.

Nó AstroWay

Em vez de um HTTP Request manual, podes usar o nó @astroway/n8n-nodes-astroway. Ele contém 730 operações de API como ações prontas com campos para: mapa natal, sinastria, trânsitos, astrologia védica, Human Design, BaZi, numerologia, tarot e outros.

No n8n self-hosted, abre Settings → Community Nodes → Install, introduz @astroway/n8n-nodes-astroway e confirma. O n8n verificou o nó em 2026-10-23, por isso no n8n Cloud podes adicioná-lo a partir do painel de nós sem instalar nada.
Cria uma credential AstroWay API e cola a chave. O n8n verifica-a com um pedido GET /v1/auth/keys/me, que não consome créditos. Se a chave tiver um escopo de endpoints, adiciona auth/keys/me a ele; caso contrário, a verificação mostrará Forbidden, embora as chamadas dentro do escopo funcionem.
Adiciona o nó AstroWay, seleciona um grupo e uma operação, por exemplo Core → Natal Chart. Os campos obrigatórios já estão na lista, os opcionais são adicionados através de Add field.

O nó retorna a parte data da resposta e um erro com um código API, por exemplo INVALID_INPUT. Pode ser conectado a um AI Agent como uma ferramenta.

Abaixo está o mesmo cálculo sem o nó, usando um HTTP Request normal. Funciona em qualquer n8n, incluindo o Cloud.

Primeiro, cria uma chave, conforme descrito na secção Chave para automação, com o escopo chart.

1. Adiciona a chave como credential

A chave é armazenada no repositório de credentials do n8n, e não no nó, por isso não é incluída no workflow exportado.

No n8n, cria uma nova credential do tipo Header Auth.
Name: X-Api-Key.
Value: a tua chave.
Guarda-a com o nome AstroWay API key. O workflow abaixo procura a credential exatamente por este nome.

2. Importa o workflow

Descarrega n8n-natal-chart.json, abre um workflow vazio e cola o conteúdo do ficheiro na tela ou usa a importação de ficheiro no menu do workflow.

Dentro, encontrarás quatro nós:

Start, nó Manual Trigger: inicia o workflow durante o teste.
Birth data, nó Edit Fields (Set): date, time, timezone, latitude e longitude de uma pessoa.
AstroWay chart, nó HTTP Request: chama POST /v1/chart.
Big three, nó Edit Fields (Set): converte longitudes em nomes de signos.

3. Executa

Executa o workflow. O nó Big three retorna:

{
  "sun": "Taurus",
  "moon": "Capricorn",
  "rising": "Virgo",
  "offset_used": 4
}

offset_used é o desvio de UTC que o servidor encontrou para Europe/Kyiv a 15-05-1990: 4, e não 3, que é geralmente escrito manualmente.

Como o nó HTTP Request está configurado

Method: POST.
URL:
```
https://api.astroway.info/v1/chart
```
Authentication: Generic Credential Type.
Generic Auth Type: Header Auth, credential AstroWay API key.
Send Body: ativado.
Body Content Type: JSON.
Specify Body: Using JSON.

O corpo é definido por uma expressão, então os valores de qualquer nó anterior são passados como estão:

{{ JSON.stringify({ date: $json.date, time: $json.time, timezone: $json.timezone, latitude: $json.latitude, longitude: $json.longitude }) }}

Como os signos são calculados

Cada campo em Big three é uma expressão. O signo é igual à longitude, dividida por 30 e arredondada para baixo, como um índice na lista:

{{ ['Aries','Taurus','Gemini','Cancer','Leo','Virgo','Libra','Scorpio','Sagittarius','Capricorn','Aquarius','Pisces'][Math.floor($json.data.houses.ascendant / 30)] }}

Para o Sol e a Lua, a longitude é obtida de $json.data.planets.find(p => p.name === 'Sun').longitude e da mesma forma de 'Moon'.

Insere os teus dados

Substitui Start e Birth data pelo trigger que realmente usas: um formulário, um webhook ou uma nova linha de tabela, e mapeia os seus campos para os cinco nomes acima. Duas coisas a verificar:

timezone não pode estar vazio. Um valor vazio é rejeitado com 400, então mapeia o campo ou define auto se as coordenadas forem fiáveis.
As coordenadas são obrigatórias. A API não geocodifica o nome da cidade; se o formulário pedir apenas o local, adiciona um passo de geocodificação antes de AstroWay chart.