> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prática recomendada: Resposta automática com IA

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](/pt/documentation/agents/ai-agent/how-to-create-and-configure-an-ai-agent) para obter detalhes.

## Visão geral

<img src="https://mintcdn.com/lchnan/RN4tXfXENVvDu0Te/product-assets/bce927a41c-image-822.webp?fit=max&auto=format&n=RN4tXfXENVvDu0Te&q=85&s=8319e02fe2728f59e0162056ec37ab6b" alt="Captura de tela do produto YCloud" width="1520" height="677" data-path="product-assets/bce927a41c-image-822.webp" />

## 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.

<Info>
  Tenha o cuidado de proteger sua Webhook URL e garantir que apenas o código de status 200 seja retornado.
</Info>

<img src="https://mintcdn.com/lchnan/AlSk34JesCiO_ZYy/product-assets/ee2d0d72aa-cleanshot-2025-12-24-at-14-19-49.webp?fit=max&auto=format&n=AlSk34JesCiO_ZYy&q=85&s=ad9711a52ab2cdfc72b18d31c66936cf" alt="Captura de tela do produto YCloud" width="1920" height="961" data-path="product-assets/ee2d0d72aa-cleanshot-2025-12-24-at-14-19-49.webp" />

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:

<img src="https://mintcdn.com/lchnan/Z2X3BzyqaivSGKDr/product-assets/5fce9ea6a1-image-823.webp?fit=max&auto=format&n=Z2X3BzyqaivSGKDr&q=85&s=3445da71ac5e68e91087c1a88c077601" alt="Captura de tela do produto YCloud" width="1041" height="893" data-path="product-assets/5fce9ea6a1-image-823.webp" />

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.

<img src="https://mintcdn.com/lchnan/PCdfO4VGvgYoGyQM/product-assets/f6375a8bae-image-824.webp?fit=max&auto=format&n=PCdfO4VGvgYoGyQM&q=85&s=c995947948540fccbcf624ecb8eb16b9" alt="Captura de tela do produto YCloud" width="1131" height="892" data-path="product-assets/f6375a8bae-image-824.webp" />

#### 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.

<img src="https://mintcdn.com/lchnan/6CxA7mK2t7klNAOL/product-assets/a0f46a0f57-image-825.webp?fit=max&auto=format&n=6CxA7mK2t7klNAOL&q=85&s=791ccf7826c680cc9832a825340045ae" alt="Captura de tela do produto YCloud" width="1124" height="893" data-path="product-assets/a0f46a0f57-image-825.webp" />

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.

<img src="https://mintcdn.com/lchnan/WD-ixrYVrqB7b7aQ/product-assets/4d83205348-cleanshot-2025-12-24-at-14-32-35.webp?fit=max&auto=format&n=WD-ixrYVrqB7b7aQ&q=85&s=cf10657553e833abd56dd88bb1bbeb8b" alt="Captura de tela do produto YCloud" width="698" height="536" data-path="product-assets/4d83205348-cleanshot-2025-12-24-at-14-32-35.webp" />

### 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.

<img src="https://mintcdn.com/lchnan/WD-ixrYVrqB7b7aQ/product-assets/3fd120f98f-image-827.webp?fit=max&auto=format&n=WD-ixrYVrqB7b7aQ&q=85&s=a9b6c7c35ad183bd23ffc3addffa8033" alt="Captura de tela do produto YCloud" width="588" height="556" data-path="product-assets/3fd120f98f-image-827.webp" />

Você pode selecionar diferentes ferramentas para conectar ao nó AI Agent; basta vinculá-las ao nó.

<img src="https://mintcdn.com/lchnan/Z2X3BzyqaivSGKDr/product-assets/6bb9ace98b-cleanshot-2025-12-24-at-16-36-50.webp?fit=max&auto=format&n=Z2X3BzyqaivSGKDr&q=85&s=8c68f243defa4ab5c442d83443b78d02" alt="Captura de tela do produto YCloud" width="474" height="460" data-path="product-assets/6bb9ace98b-cleanshot-2025-12-24-at-16-36-50.webp" />

> 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.

<img src="https://mintcdn.com/lchnan/NjO13A6gLJKR9m7M/product-assets/76c02d652a-image-829.webp?fit=max&auto=format&n=NjO13A6gLJKR9m7M&q=85&s=921eb504423a3f04d5ce370556f404db" alt="Captura de tela do produto YCloud" width="1136" height="425" data-path="product-assets/76c02d652a-image-829.webp" />

## 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.

<img src="https://mintcdn.com/lchnan/6CxA7mK2t7klNAOL/product-assets/a123431309-image-830.webp?fit=max&auto=format&n=6CxA7mK2t7klNAOL&q=85&s=bd40d7511675b2aa9cb490f025743967" alt="Captura de tela do produto YCloud" width="1897" height="673" data-path="product-assets/a123431309-image-830.webp" />

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.

<img src="https://mintcdn.com/lchnan/9zlgZMZStxEKrVPM/product-assets/03d7244532-image-50.webp?fit=max&auto=format&n=9zlgZMZStxEKrVPM&q=85&s=992f77837c253c484a0fc16c5ede4ab4" alt="Captura de tela do produto YCloud" width="1520" height="730" data-path="product-assets/03d7244532-image-50.webp" />

* Você pode usar os exemplos em cURL na [referência da API](/pt/api-reference/getting-started/ycloud-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).

<Warning>
  Observe que as funções de remetente e destinatário estão **invertidas** aqui, pois se trata de uma mensagem de resposta.
</Warning>

* 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.