FEATURE: n8n webhook integration

[BenGWeeks]

Description

Implement bidirectional integration with n8n workflow automation platform through webhooks.

Use Cases

1. Incoming Notifications: Receive alerts from n8n workflows and speak them
2. Trigger Workflows: Initiate n8n automations via voice commands
3. Data Exchange: Pass conversation context to workflows
4. Status Updates: Get workflow execution status by voice

Implementation Details

1. Webhook Receiver

• HTTP server endpoint for incoming webhooks
• Authentication (bearer token/API key)
• Message queue for reliable delivery
• Priority levels for notifications

2. Webhook Sender

• Send conversation events to n8n
• Configurable event types (start, end, keyword detection)
• Include conversation context and metadata
• Retry logic for failed webhooks

3. Voice Command Integration

User: "Run my backup workflow"
Nod.ie: "Starting backup workflow... I'll let you know when it's complete."
[Later]
Nod.ie: "Your backup workflow completed successfully."

4. Configuration

{
  "n8n": {
    "webhookUrl": "https://n8n.example.com/webhook/abc123",
    "apiKey": "your-api-key",
    "enableIncoming": true,
    "enableOutgoing": true,
    "eventTypes": ["conversation.start", "conversation.end", "keyword.detected"]
  }
}

Example Workflows

Home Automation

"Turn on the lights" → Trigger n8n → Control smart home

Monitoring Alerts

n8n monitors services → Send webhook → Nod.ie speaks alert

Data Collection

Conversation with specific keywords → Send to n8n → Log to database

Security Considerations

• Validate webhook signatures
• Rate limiting to prevent spam
• Sanitize spoken content
• Secure credential storage

Technical Requirements

• Express/Fastify server for webhook endpoint
• WebSocket for real-time updates
• Event emitter pattern for internal events
• Queue system for reliability

Priority

Medium - Enables powerful automation capabilities