ealmeida
faef9b47dc
Dify foi removido 06-03-2026. Skills brainstorm/discover ainda referenciam-no no corpo. Bump v1.2 + nota top-of-file. Reescrita workflow para próxima sessão. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
173 lines
3.0 KiB
Markdown
173 lines
3.0 KiB
Markdown
---
|
|
name: n8n-webhook
|
|
description: Criação e gestão de webhooks n8n para receber dados de sistemas externos.
|
|
---
|
|
|
|
# /n8n-webhook - Webhooks n8n
|
|
|
|
Criar e gerir webhooks para receber dados externos.
|
|
|
|
---
|
|
|
|
## Uso
|
|
|
|
```
|
|
/n8n-webhook create <descrição> # Criar novo webhook
|
|
/n8n-webhook list # Listar webhooks existentes
|
|
/n8n-webhook test <workflow_id> # Testar webhook
|
|
```
|
|
|
|
---
|
|
|
|
## Workflow Obrigatório
|
|
|
|
```
|
|
1. Health check → mcp__n8n__n8n_health_check()
|
|
2. Pesquisar template → mcp__n8n__search_templates({ query: "webhook" })
|
|
3. Se template OK → mcp__n8n__n8n_deploy_template()
|
|
4. Se criar do zero → Seguir fluxo abaixo
|
|
```
|
|
|
|
---
|
|
|
|
## Criar Webhook do Zero
|
|
|
|
### Passo 1: Documentação do Node
|
|
|
|
```javascript
|
|
mcp__n8n__get_node({
|
|
nodeType: "nodes-base.webhook",
|
|
detail: "standard",
|
|
includeExamples: true
|
|
})
|
|
```
|
|
|
|
### Passo 2: Validar Configuração
|
|
|
|
```javascript
|
|
mcp__n8n__validate_node({
|
|
nodeType: "nodes-base.webhook",
|
|
config: {
|
|
httpMethod: "POST",
|
|
path: "meu-webhook",
|
|
responseMode: "onReceived"
|
|
},
|
|
mode: "minimal"
|
|
})
|
|
```
|
|
|
|
### Passo 3: Nodes de Processamento
|
|
|
|
| Node | Uso |
|
|
|------|-----|
|
|
| `nodes-base.set` | Transformar dados |
|
|
| `nodes-base.if` | Condicionais |
|
|
| `nodes-base.code` | JavaScript custom |
|
|
| `nodes-base.httpRequest` | Chamar APIs |
|
|
|
|
### Passo 4: Deploy
|
|
|
|
```javascript
|
|
mcp__n8n__n8n_create_workflow({
|
|
name: "Webhook - Descrição",
|
|
nodes: [...],
|
|
connections: {...},
|
|
active: true
|
|
})
|
|
```
|
|
|
|
---
|
|
|
|
## Configurações Webhook
|
|
|
|
| Parâmetro | Opções | Default |
|
|
|-----------|--------|---------|
|
|
| `httpMethod` | GET, POST, PUT, DELETE | POST |
|
|
| `path` | String única | (obrigatório) |
|
|
| `authentication` | none, basicAuth, headerAuth | none |
|
|
| `responseMode` | onReceived, lastNode | onReceived |
|
|
|
|
---
|
|
|
|
## URL do Webhook
|
|
|
|
Após deploy:
|
|
```
|
|
https://automator.descomplicar.pt/webhook/<path>
|
|
```
|
|
|
|
Modo teste (workflow inactivo):
|
|
```
|
|
https://automator.descomplicar.pt/webhook-test/<path>
|
|
```
|
|
|
|
---
|
|
|
|
## Exemplos
|
|
|
|
### Webhook → Slack
|
|
|
|
```
|
|
Webhook (POST /notify)
|
|
↓
|
|
Set (formatar)
|
|
↓
|
|
Slack (enviar)
|
|
```
|
|
|
|
### Webhook → CRM
|
|
|
|
```
|
|
Webhook (POST /lead)
|
|
↓
|
|
HTTP Request (criar no Desk)
|
|
↓
|
|
Email (notificar)
|
|
```
|
|
|
|
---
|
|
|
|
## Testar
|
|
|
|
```javascript
|
|
mcp__n8n__n8n_test_workflow({
|
|
workflowId: "wf-xxx",
|
|
inputData: {
|
|
body: { "test": "data" },
|
|
headers: { "Content-Type": "application/json" }
|
|
}
|
|
})
|
|
```
|
|
|
|
```bash
|
|
curl -X POST https://automator.descomplicar.pt/webhook/meu-webhook \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"test": "data"}'
|
|
```
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
| Problema | Solução |
|
|
|----------|---------|
|
|
| 404 Not Found | Workflow não está activo |
|
|
| 401 Unauthorized | Verificar autenticação |
|
|
| Dados não chegam | Verificar responseMode |
|
|
|
|
---
|
|
|
|
*Skill v1.0 | Descomplicar®*
|
|
|
|
---
|
|
|
|
## Healing Log
|
|
|
|
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
|
|
|
|
```jsonl
|
|
{"date":"","issue":"","fix":"","source":"user|auto"}
|
|
```
|
|
|
|
*Adicionar nova linha após cada erro corrigido.*
|