Skip to main content
Este exemplo demonstrará como implementar um fluxo de resposta automatizado básico usando o n8n + modelos de linguagem grandes (LLMs): Ao receber uma mensagem recebida, a YCloud aciona um fluxo de trabalho do n8n por meio de um webhook, chama um modelo de linguagem grande para gerar uma resposta e retorna a mensagem ao usuário por meio da API da YCloud.
O YCloud AI Agent oferece uma base de conhecimento de IA integrada, corpora e fluxos de trabalho automatizados. Consulte AI Agent para obter detalhes.

​
Visão geral

Captura de tela do produto YCloud

​
Evento de Webhook

Ao configurar o evento de Webhook, defina o HTTP Method como POST, o Response como Immediate Return e o Response Status Code como 200.
Tenha o cuidado de proteger sua Webhook URL e garantir que apenas o código de status 200 seja retornado.
Captura de tela do produto YCloud Você deve selecionar WhatsApp.inbound_message.received no evento de Webhook da YCloud. Ao acionar o Webhook da YCloud, o nó de Webhook do n8n receberá os dados completos de inbound_message e os analisará automaticamente em campos utilizáveis. Como ilustrado abaixo: Captura de tela do produto YCloud Esses campos servirão como dados de entrada para nós subsequentes (como Data Table, AI Agent, HTTP Request, etc.) e podem ser referenciados por meio de Expression.

​
Data Table

​
Design da Data Table

​
Inserir linha (Insert Row)

Este nó é usado para gravar os dados recebidos via webhooks em uma tabela de dados para posterior consulta ou gerenciamento de status.
  • Suporta correspondência manual ou correspondência automática.
  • A correspondência automática requer que os nomes dos campos sejam idênticos.
  • Você pode arrastar campos diretamente do painel Input para os itens de configuração, e o n8n gerará a Expression automaticamente.
Captura de tela do produto YCloud

​
Obter linha (Get Row)

Este nó é usado para ler dados existentes da Data Table. A condição pode ser definida como você desejar. Nesta prática recomendada, usamos wamid como condição de correspondência. Captura de tela do produto YCloud Dentro deste nó, geralmente é necessário configurar condições de correspondência (Condition). Esse método é comumente usado para determinar se uma mensagem já foi processada ou para recuperar o contexto do histórico.

​
AI Agent

​
1. Configuração do modelo

Antes de utilizar o AI Agent, configure as informações do modelo correspondente (como OpenRouter, Ollama, etc.) em Credentials. Esta seção utilizará o OpenRouter para a configuração. As capturas de tela da configuração de Credential foram omitidas aqui; basta utilizar as APIs relevantes fornecidas pelo OpenRouter. Você pode selecionar o modelo de sua preferência e o formato de retorno; para este exemplo de prática recomendada, escolha grok-3 com formato TXT. Captura de tela do produto YCloud

​
2. Nó AI Agent

Dentro do nó AI Agent:
  • Escreva o prompt
  • Utilize expressões para referenciar campos de webhooks ou tabelas de dados como entrada. Você pode compor o prompt desejado aqui; nenhuma adição é necessária. O conteúdo do prompt pode ser personalizado livremente de acordo com os requisitos do seu negócio.
Captura de tela do produto YCloud Você pode selecionar diferentes ferramentas para conectar ao nó AI Agent; basta vinculá-las ao nó. Captura de tela do produto YCloud
Observação: O AI Agent suporta um mecanismo de memória estendida (Memory), permitindo o gerenciamento de contexto por meio de bancos de dados ou outros métodos de armazenamento.
Aqui você pode visualizar as informações da saída final gerada pelo modelo. Captura de tela do produto YCloud

​
Mesclagem (Merge)

O nó Merge é usado para combinar os dados de saída de vários nós, preparando-os para as requisições subsequentes à API. Captura de tela do produto YCloud Os padrões comuns incluem:
  • Append
  • Combine
  • Merge by Index
No exemplo atual, o padrão de mesclagem é empregado para concatenar várias saídas em uma única estrutura de dados para uso pelo nó HTTP Request.

​
HTTP Request

Por fim, invoque a interface de envio de mensagens da YCloud por meio do nó HTTP Request. Captura de tela do produto YCloud
  • Você pode usar os exemplos em cURL na referência da API da YCloud para uma configuração rápida. Insira sua chave de API no cabeçalho X-API-Key.
  • Arraste o campo mesclado da etapa anterior para o corpo da requisição (request body).
Observe que as funções de remetente e destinatário estão invertidas aqui, pois se trata de uma mensagem de resposta.
  • Use Expression para preencher dinamicamente o conteúdo da mensagem, destinatários e outros parâmetros.
Neste ponto, um fluxo de trabalho completo do n8n composto por Webhook → Modelo de Linguagem Grande → Resposta Automatizada foi configurado.

​
Resumo

Seguindo os passos acima, você pode criar rapidamente um fluxo de resposta automatizado usando o n8n para realizar:
  • Escuta de Webhook
  • Processamento de dados de mensagem
  • Geração automatizada de conteúdo com LLM
  • Envio de respostas aos usuários via API da YCloud
Este exemplo serve como ponto de partida para integração via n8n.