Integrations

ArcanFlows integrates with a wide variety of external services to power your AI agents and workflows.

Integration Categories

AI Model Providers

Connect to leading AI model providers:

Notification Channels

Send notifications through multiple channels:

External Services

Connect to popular services:

Setting Up Integrations

Step 1: Navigate to Settings

1. Go to Settings in the sidebar
2. Select Integrations or the specific category

Step 2: Add Credentials

For most integrations, you'll need to provide API credentials:

1. Click Add Integration or Add Credential
2. Select the provider
3. Enter your API keys or OAuth credentials
4. Test the connection
5. Save

Step 3: Use in Agents/Workflows

Once configured, integrations are available in:

• Agent Model Selection: Choose AI providers
• Workflow Action Nodes: Send notifications, call APIs
• Form Integrations: Trigger on submission

Credentials Vault

All credentials are stored securely in the Credentials Vault:

Security Features

• Encryption: AES-256 encryption at rest
• Access Control: Role-based permissions
• Audit Logging: All access is logged
• Rotation: Support for credential rotation

Managing Credentials

Settings > Credentials
├── AI Providers
│   ├── OpenAI API Key
│   ├── Anthropic API Key
│   └── Google AI API Key
├── Email Providers
│   ├── SendGrid API Key
│   └── SMTP Configuration
└── Custom Credentials
    └── Salesforce OAuth

AI Provider Setup

OpenAI

1. Visit platform.openai.com
2. Navigate to API Keys
3. Create a new secret key
4. In ArcanFlows: Settings > AI Providers > OpenAI
5. Paste your API key and save

jsonCopy
{
  "provider": "openai",
  "api_key": "sk-...",
  "organization_id": "org-..." // optional
}

Anthropic

1. Visit console.anthropic.com
2. Navigate to API Keys
3. Create a new key
4. In ArcanFlows: Settings > AI Providers > Anthropic
5. Paste your API key and save

Ollama (Local)

For privacy-focused deployments:

1. Install Ollama on your server
2. Pull the models you need: ollama pull llama2
3. Configure the base URL in ArcanFlows
4. Select Ollama models in your agents

jsonCopy
{
  "provider": "ollama",
  "base_url": "http://your-ollama-server:11434"
}

Notification Channel Setup

Email - SendGrid

1. Create a SendGrid account
2. Generate an API key with Mail Send permissions
3. Verify your sender domain
4. In ArcanFlows: Settings > Notification Channels > Add
5. Select "Email" > "SendGrid"
6. Enter your API key and sender info

jsonCopy
{
  "channel_type": "email",
  "provider": "sendgrid",
  "config": {
    "api_key": "SG.xxx",
    "from_email": "notifications@yourcompany.com",
    "from_name": "Your Company"
  }
}

Slack

1. Create a Slack app at api.slack.com
2. Add the necessary scopes (chat:write, channels:read)
3. Install the app to your workspace
4. Copy the Bot Token
5. In ArcanFlows: Settings > Notification Channels > Add
6. Select "Slack" and enter your token

Webhooks

Send data to any HTTP endpoint:

jsonCopy
{
  "channel_type": "webhook",
  "config": {
    "url": "https://your-server.com/webhook",
    "method": "POST",
    "headers": {
      "Authorization": "Bearer your_token"
    }
  }
}

Incoming Webhooks

Receive data from external services:

Creating a Webhook Endpoint

1. Go to Settings > Incoming Webhooks
2. Click Create Webhook
3. Give it a name and optional description
4. Copy the generated URL

Webhook URL Format

https://hooks.arcanflows.io/v1/incoming/wh_abc123

Connecting to Workflows

Use the Webhook trigger in your workflow:

javascriptCopy
// Incoming webhook payload
{
  "event": "order.created",
  "data": {
    "order_id": "ord_123",
    "customer_email": "customer@example.com",
    "total": 99.99
  }
}

// Access in workflow
{{ input.event }}           // "order.created"
{{ input.data.order_id }}   // "ord_123"

Testing Integrations

Connection Test

Most integrations include a test button:

1. Configure the integration
2. Click Test Connection
3. Verify the success message

Send Test Notification

For notification channels:

1. Select the channel
2. Click Send Test
3. Enter test recipient details
4. Verify delivery

Troubleshooting

Common Issues

Logs

View integration logs:

1. Go to Activity > Integration Logs
2. Filter by integration type
3. Review request/response details

Next Steps

• AI Providers - Configure AI models
• Notification Channels - Set up notifications
• Webhooks - Configure webhooks
• Credentials - Manage secrets