Integrations

Connect AfricaOS to your existing tools and services.

Overview

Integrations extend AfricaOS functionality by connecting to external platforms. Most integrations are configured per-module.

Available Integrations

Payment Providers

Communication

Calendar & Scheduling

Accounting & Finance

E-Commerce & Marketplaces

Shipping & Logistics

CRM & Marketing

Productivity

Development

Setting Up Integrations

General Steps

1. Go to Settings → Integrations
2. Find the integration
3. Click Configure
4. Enter credentials
5. Test connection
6. Enable for modules

Webhook Security

All webhooks include:

• Signature - HMAC-SHA256 with shared secret
• Timestamp - Prevent replay attacks
• Event ID - Deduplication

Verify in your endpoint:

const crypto = require('crypto');
const signature = req.headers['x-africaos-signature'];
const expected = crypto
  .createHmac('sha256', process.env.WEBHOOK_SECRET)
  .update(req.body)
  .digest('hex');

if (signature !== expected) {
  return res.status(401).send('Invalid signature');
}

Rate Limits

Custom Integrations

REST API

Full API access for custom development:

• Base URL - https://api.africaos.dev/v1
• Auth - Bearer token (Settings → API Tokens)
• Docs - /docs/api/reference

GraphQL

Flexible queries for complex data:

• Endpoint - https://api.africaos.dev/graphql
• Schema - Introspection enabled
• Playground - Available in settings

Workflow Scripts

Run TypeScript in workflows:

// Available globals: fetch, console, Date, Math, JSON
// Context: trigger, record, user, org

async function main() {
  const response = await fetch('https://api.external.com/data', {
    headers: { 'Authorization': `Bearer ${secrets.EXTERNAL_API_KEY}` }
  });
  return response.json();
}

Troubleshooting

Common Issues

Debugging

1. Check Settings → Integrations → Logs
2. View request/response payloads
3. Test with Test Connection button
4. Check external service logs

Related

• Module Configuration
• Workflows
• API Reference
• Webhooks