Nocage Integrations Guide
This document outlines integration opportunities for external platforms across your Nocage projects.
Project Overview
| Project | Purpose | Key Features |
|---|---|---|
business-management | Business operations | Orders, customers, products, wallet, notifications |
hub | Creator marketplace | Posts, chat, capsules, creators, analytics |
capsule-management | Digital asset management | Capsule creation, delivery, creators profile |
auth-service | Authentication | User authentication |
join-waitlist | Lead capture | Waitlist with Instagram field |
1. Calendly Integration
Integration Areas
| Project | Area | Use Case |
|---|---|---|
capsule-management | Creators Profile | Creators can embed their Calendly link for booking consultations |
business-management | Order Steps | Schedule service appointments via Calendly for TYPE_2 orders |
hub | Creator Discovery | Display booking availability alongside creator profiles |
Existing Code Reference
capsule-management/src/components/join-as-creator/forms/step2.tsx:240- Already has Calendly URL placeholder field
Suggested Implementation
typescript
// New integration module: src/lib/integrations/calendly.ts
interface CalendlyEvent {
uri: string;
name: string;
status: 'active' | 'canceled';
start_time: string;
end_time: string;
}
Documentation Links
- Calendly Developer Portal
- Getting Started with Calendly API
- API Recipes
- Authentication via OAuth
- Create Single-Use Scheduling Link
- Calendly API Documentation - Apidog
2. Google Meet Integration
Integration Areas
| Project | Area | Use Case |
|---|---|---|
business-management | Order Steps | Auto-generate Google Meet links for virtual service appointments |
business-management | Video Consultations | Add video call functionality to TYPE_2 service orders |
hub | Creator Sessions | Enable video consultations between creators and clients |
Existing Code Reference
business-management/src/server/api/routers/order-step.ts- HasmeetingTypeandmeetingDetailsfields in stepsbusiness-management/src/server/api/routers/order.ts:1436-1488-scheduleMeetingmutation already exists
Suggested Implementation
typescript
// New integration module: src/lib/integrations/google-meet.ts
interface MeetEvent {
conferenceData: {
createRequest: { requestId: string };
};
attendees: { email: string }[];
}
Documentation Links
- Google Meet REST API Overview
- Google Meet SDK & API Overview
- Create Events with Google Calendar
- Authenticate Meet REST API Requests
- Subscribe to Google Meet Events
- Tutorial: Observe Meet Events with Python
3. Odoo Invoice Integration
Integration Areas
| Project | Area | Use Case |
|---|---|---|
business-management | Orders | Export completed orders to Odoo for professional invoicing |
business-management | Accounting | Sync transactions, track expenses, manage GST compliance |
hub | Payments | Connect wallet transactions to Odoo accounting |
Suggested Implementation
typescript
// New integration module: src/lib/integrations/odoo.ts
interface OdooInvoice {
name: string;
partner_id: number;
line_ids: { product_id: number; price_unit: number }[];
}
// API endpoints to connect
const ODOO_CONFIG = {
xmlrpcEndpoint: process.env.ODOO_XMLRPC_URL,
db: process.env.ODOO_DB,
username: process.env.ODOO_USERNAME,
};
Documentation Links
- Odoo External API Documentation
- Odoo API Integration Guide
- Connect Odoo to Any System
- Odoo Invoicing Processes
- Odoo Invoice Integration Guide
- Integrate with Odoo API
4. Telegram Integration (Extra)
Integration Areas
| Project | Area | Use Case |
|---|---|---|
hub | Notifications | Send order updates and messages via Telegram bot |
business-management | Customer Support | Enable Telegram-based customer chat |
hub | Creator Announcements | Broadcast updates to subscribers |
Suggested Implementation
typescript
// New integration module: src/lib/integrations/telegram.ts
interface TelegramMessage {
chat_id: string;
text: string;
parse_mode?: 'HTML' | 'Markdown';
}
// Bot webhook endpoint: /api/webhooks/telegram
Documentation Links
5. WhatsApp Integration
Integration Areas
| Project | Area | Use Case |
|---|---|---|
business-management | Order Updates | Send order status, tracking via WhatsApp |
business-management | Customer Notifications | Payment confirmations, delivery updates |
join-waitlist | Lead Nurturing | Follow-up messages to waitlist signups |
hub | Two-way Chat | Customer-creator communication |
Existing Code Reference
business-management/src/app/(protected)/tracking-links/page.tsx:441- WhatsApp listed as UTM source
Suggested Implementation
typescript
// New integration module: src/lib/integrations/whatsapp.ts
interface WhatsAppTemplate {
name: string;
language: { code: string };
components: {
type: 'HEADER' | 'BODY' | 'BUTTON';
text?: string;
}[];
}
// Meta WhatsApp Cloud API
const WHATSAPP_CONFIG = {
phoneNumberId: process.env.WHATSAPP_PHONE_ID,
accessToken: process.env.WHATSAPP_ACCESS_TOKEN,
};
Documentation Links
- WhatsApp Business Platform Documentation
- Send Messages Guide
- Interactive Messages
- Message Templates
- WhatsApp Business API Overview
6. Instagram Integration
Integration Areas
| Project | Area | Use Case |
|---|---|---|
join-waitlist | Lead Capture | Capture Instagram handles during signup |
hub | Creator Profiles | Display Instagram links on creator pages |
business-management | Tracking Links | UTM source for Instagram campaigns |
capsule-management | Social Sharing | Share capsule purchases to Instagram |
Existing Code Reference
join-waitlist/src/components/waitlist-form.tsx:13-267- Instagram field existshub/src/server/api/routers/creators.ts:92-instagramUrlfield in creator profilebusiness-management/src/app/(protected)/tracking-links/page.tsx:360,435- Instagram as UTM source
Suggested Implementation
typescript
// New integration module: src/lib/integrations/instagram.ts
interface InstagramMedia {
id: string;
caption: string;
media_type: 'IMAGE' | 'VIDEO' | 'CAROUSEL_ALBUM';
media_url: string;
permalink: string;
}
// Instagram Graph API via Meta
const INSTAGRAM_CONFIG = {
accessToken: process.env.INSTAGRAM_ACCESS_TOKEN,
instagramAccountId: process.env.INSTAGRAM_ACCOUNT_ID,
};
Documentation Links
- Instagram Graph API Overview
- Instagram API with Facebook Login
- Instagram Graph API Complete Guide 2026
- Instagram Media API
- How to Use Instagram Graph API in 2026
7. Meta Integration (Facebook)
Integration Areas
| Project | Area | Use Case |
|---|---|---|
business-management | Ads Tracking | Connect Meta Pixel, track conversions |
hub | Social Login | Facebook OAuth for authentication |
hub | Page Integration | Post content to Facebook pages |
business-management | Analytics | Import Meta ad performance data |
Suggested Implementation
typescript
// New integration module: src/lib/integrations/meta.ts
interface MetaAdInsights {
campaign_id: string;
impressions: number;
clicks: number;
spend: number;
actions: { action_type: string; value: string }[];
}
// Meta Business SDK
import { Meta } from 'facebook-nodejs-business-sdk';
Documentation Links
- Meta Business SDK
- Get Started with Business Management API
- Meta Business Extension Overview
- Graph API Reference
- Business API Reference
- Get Started with Meta Business SDK
Implementation Priority Matrix
| Integration | Complexity | Business Impact | Priority |
|---|---|---|---|
| Medium | High | P0 | |
| Google Meet | Medium | High | P0 |
| Calendly | Low | Medium | P1 |
| Low | Medium | P1 | |
| Odoo Invoice | High | High | P2 |
| Telegram | Low | Low | P2 |
| Meta/Facebook | Medium | Medium | P2 |
Environment Variables Required
env
# Calendly
CALENDLY_API_KEY=
CALENDLY_WEBHOOK_SECRET=
# Google
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=
# Odoo
ODOO_XMLRPC_URL=
ODOO_DB=
ODOO_USERNAME=
ODOO_API_KEY=
# Telegram
TELEGRAM_BOT_TOKEN=
TELEGRAM_WEBHOOK_SECRET=
# WhatsApp (Meta)
WHATSAPP_PHONE_ID=
WHATSAPP_ACCESS_TOKEN=
WHATSAPP_BUSINESS_ACCOUNT_ID=
# Instagram (Meta)
INSTAGRAM_ACCESS_TOKEN=
INSTAGRAM_ACCOUNT_ID=
# Meta/Facebook
META_APP_ID=
META_APP_SECRET=
META_ACCESS_TOKEN=
Next Steps
- Immediate: Add Calendly integration to capsule-management creator profiles (already has placeholder)
- Phase 1: Implement Google Meet link generation for service orders
- Phase 2: Set up WhatsApp Business API for order notifications
- Phase 3: Create Odoo invoice sync for completed orders
- Phase 4: Telegram bot for customer support notifications
- Phase 5: Full Meta/Instagram social integration
Last Updated: March 2026