Encore OS Integrations

This directory contains integration guides for connecting Encore OS with external services and platforms (Supabase, n8n, Entra ID, RingCentral, etc.). Cross-core integration contracts and per-spec integration docs live under architecture/integrations.

​

Available Integrations

​

n8n Workflow Automation

Connect Encore OS automations to n8n workflows for advanced external integrations, multi-step orchestration, and connecting to 400+ services. Use Cases:

• Sync form submissions to CRMs (Salesforce, HubSpot)
• Send notifications via Slack, Teams, or SMS
• Update Google Sheets or Airtable
• Trigger multi-step approval workflows
• Connect to custom APIs and services

---

​

Integration Architecture

Encore OS uses a hybrid approach for automation:

• Encore OS FW-03 Engine: Internal workflows, database operations, notifications, simple integrations
• n8n: Complex external integrations, visual workflow design, branching logic, 400+ pre-built connectors

​

When to Use Each

---

​

Getting Started

1. Set up n8n: Follow the n8n setup guide
2. Create webhook: Add a webhook trigger to your n8n workflow
3. Configure Encore OS: Add “Call Webhook” action to your automation rule
4. Test integration: Use dry-run mode to validate the connection

---

​

Security Considerations

• Always use HTTPS for webhook URLs
• Implement authentication (Basic Auth, API Key, or Header Auth)
• Never log sensitive data (PHI, PII, credentials)
• Use circuit breakers to prevent runaway automations
• Review Automation Security documentation

---

​

Documentation

​

Integration Guides

• n8n Workflow Automation - External workflow integration
• Edge Functions - Complete documentation for all 48 edge functions
• Supabase Setup - Production Supabase configuration guide
• Email & SMS Setup - Entra/Gmail and RingCentral configuration
• RingCentral Gap Analysis - RingCentral integration analysis and recommendations
• Entra ID Integration - Microsoft Entra ID/Office 365 integration overview
  • Setup Guide - Complete setup instructions
  • Gap Analysis (archived; superseded by PF-63 implementation — see ENTRA_ID_GAP_ANALYSIS.md)
  • Research Findings - Programmatic app registration research

​

Related Documentation

• FW-03 Automation Engine spec - Automation engine specification
• Integration Documentation - Cross-core integration contracts and patterns
• Environment Variables - Environment configuration guide
• Secrets Management - Secrets management strategy

​

Support

For questions or issues:

• Review the n8n Integration Guide
• Consult Integration Documentation for integration contracts and patterns