> ## 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.
# Exemplo 1: Resposta automática por IA
Este exemplo demonstra como implementar um fluxo de trabalho básico de resposta automática usando o n8n, um modelo de linguagem grande (LLM) e um nó da YCloud:
Quando a plataforma YCloud recebe uma mensagem de entrada, ela aciona um fluxo de trabalho do n8n via Webhook. O fluxo de trabalho chama o modelo de linguagem grande para gerar uma resposta e, em seguida, envia a mensagem de volta ao usuário pelo nó da YCloud.
> O YCloud AI Agent construiu um fluxo de trabalho completo de IA para você, oferecendo uma base de conhecimento de IA ponta a ponta e fácil de entender, corpora e processos automatizados. Clique aqui para obter mais detalhes.
### Processo Geral
### Evento de Webhook
1. Criar um endpoint de Webhook
1. Use o nó Webhook do n8n para criar um novo listener
2. Selecione POST como o método HTTP
3. Nas Opções, defina o Response Code como 200 e certifique-se de que ‘Immediately’ esteja selecionado
Adicione os detalhes do seu endpoint à plataforma YCloud e selecione os eventos de Webhook que você deseja monitorar
### Analisar o valor de retorno e verificar a assinatura
#### Analisar o valor de retorno
Analisando os cabeçalhos na resposta do Webhook usando o nó ‘code’ integrado do n8n
Selecione JavaScript para a análise
```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
function parseSignatureHeader(signatureHeader) {
const result = {};
for (const part of (signatureHeader || '').split(',')) {
const [key, value] = part.split('=');
if (key && value) {
result[key.trim()] = value.trim();
}
}
return result;
}
const input = $input.first().json;
const headers = input.headers || {};
const body = input.body;
const signatureHeader = headers['ycloud-signature'] ;
const parsed = parseSignatureHeader(signatureHeader);
const timestamp = parsed.t;
const receivedSignature = parsed.s;
const payload =
body === undefined || body === null
? ''
: typeof body === 'string'
? body
: JSON.stringify(body);
const signedPayload = `${timestamp}.${payload}`;
return [
{
json: {
...input,
timestamp,
receivedSignature,
payload,
signedPayload,
signatureHeader,
}
}
];
```
Os valores de retorno deste nó são:
* O valor original,
* O carimbo de data/hora (timestamp),
* A assinatura recebida, o payload, o payload assinado e as informações de assinatura no cabeçalho da requisição
#### Dados criptografados
Na etapa anterior, os dados foram totalmente particionados. Neste nó, usaremos SignedPayload e Secret. Usaremos o nó Crypto para criptografar os dados.
Obtenha o Secret na plataforma YCloud.
#### Comparar assinaturas
Use uma instrução if para verificar as informações de assinatura; se coincidirem, a verificação é considerada bem-sucedida.
#### Responder a mensagens usando IA
Depois de se inscrever nos eventos `whatsapp.inbound_message.received` e `whatsapp.message.updated`, você receberá uma notificação push quando uma mensagem for recebida ou uma atualização de status posterior após o envio de uma mensagem.
1. Use o nó `switch` para configurar múltiplos tipos de notificação por Webhook.
2. Quando um evento `inbound_message_received` for recebido, uma resposta poderá ser gerada chamando a API de IA
3. Use o nó merge para reter a coleção de dados push do Webhook da seção anterior
4. Enviando mensagens usando nós da YCloud
Preencha os detalhes relevantes, insira o texto gerado pela IA no campo Body e envie.
Observe que o remetente e o destinatário estão **invertidos** aqui; esta é uma mensagem de resposta.
Com isso, o fluxo de trabalho completo do n8n — Webhook → Modelo de Linguagem Grande → Resposta Automática — agora está configurado.
### Salvar em uma tabela de dados (opcional)
### Monitorar atualizações subsequentes na mensagem enviada (opcional)
Assim que a etapa 5 for concluída, os dados serão enviados via evento `whatsapp.message.update`.
Ao receber esse envio push, você pode usar o nó `datatable - update rows` para atualizar a tabela de dados, rastreando assim todo o processo de entrega da mensagem.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.