SocialSuite Service Configuration Guide

Complete step-by-step developer account setup for Meta, Google, LinkedIn, WhatsApp Cloud API, SMS & Email

v2.5 Enterprise Production User Help Manual

Architecture & Integration Strategy

How SocialSuite orchestrates social channels, lead capture, and communication pipelines

SocialSuite employs an enterprise-grade, decoupled gateway architecture. Each external integration connects via standard OAuth 2.0 authorization, webhooks, and REST APIs, isolating credentials securely per tenant while empowering agency managers to publish and automate messaging from a unified console.

Security & Production Token Storage: In production environments, client secrets and API keys should be stored in appsettings.Production.json, environment variables, or Azure Key Vault. Never commit plain-text developer secrets into public source control repositories.
Channel / Service Protocol / SDK Default Callback / Webhook Endpoint Required App Mode
Facebook & Instagram OAuth 2.0 & Graph API v19.0+ /Account/FacebookCallback Live (Business App)
WhatsApp Business Cloud API Meta Graph API / Webhooks /api/webhooks/whatsapp Live (WABA Linked)
Google / YouTube Google OAuth 2.0 & Data API v3 /Account/GoogleCallback Production / Verified
LinkedIn OAuth 2.0 & REST API /Account/LinkedInCallback Live (Verified Company)
SMS Gateway Twilio REST / Custom HTTP POST /api/webhooks/sms-status Live / DLT Approved
Email Service SMTP / SendGrid / Amazon SES Direct outbound (Port 587/465) Domain SPF/DKIM Verified

Meta for Developers (Facebook & Instagram)

Publish posts, retrieve analytics, and capture lead generation forms

Meta Developer Portal
1

Create a Meta Business App

Navigate to Meta for Developers > My Apps > Create App.

  • Select App Type: Business (this is required to access Page Management and Instagram Content Publishing).
  • Enter your App Display Name (e.g., SocialSuite Marketing Engine) and link your Meta Business Account.
2

Add Products: Facebook Login & Graph API

From the App Dashboard, click Add Product and add:

  • Facebook Login for Business: Go to Settings > Valid OAuth Redirect URIs and register your live callback URL:
    VALID OAUTH REDIRECT URI
    https://yourdomain.com/Account/FacebookCallback
  • Webhooks: Subscribe to leadgen topic if capturing Facebook Lead Ads.
3

Configure Required Permissions (Scopes)

Request Advanced Access for the following permissions under App Review > Permissions and Features:

Permission / ScopePurpose
pages_show_listList managed client Facebook Pages
pages_read_engagementRead engagement, comments, and post performance
pages_manage_postsPublish automated and scheduled posts to Pages
instagram_basicRead linked Instagram Business profile info
instagram_content_publishPublish images, carousels, and reels to Instagram
leads_retrievalFetch instant leads submitted on Facebook Lead Ads
4

Retrieve App ID and App Secret

Navigate to App Settings > Basic. Copy the App ID and App Secret into your appsettings.json:

APPSETTINGS.JSON - FACEBOOK CONFIG
"Authentication": {
  "Facebook": {
    "AppId": "YOUR_META_APP_ID",
    "AppSecret": "YOUR_META_APP_SECRET"
  }
}

WhatsApp Business Cloud API (WABA)

Send rich flyers, video reels, interactive templates, and scheduled broadcasts

Meta Business Manager
1

Add WhatsApp to your Meta Business App

Inside your Meta Developer App Dashboard, click Add Product > WhatsApp > Set Up. This associates your Meta Developer App with the WhatsApp Business Platform.

2

Register a Dedicated Phone Number

Under WhatsApp > API Setup:

  • Meta provides a free test number for development and sandbox messaging.
  • For production, click Add phone number, enter your company's dedicated number (must not be active on consumer WhatsApp apps), and verify via SMS/Voice OTP.
3

Generate a Permanent System User Token

Important: The 24-hour temporary access token generated in the API Setup tab expires daily. For production, generate a permanent token using a System User.
  1. Open Meta Business Settings > Users > System Users.
  2. Click Add, name it SocialSuite-Worker, and select role Admin.
  3. Click Add Assets and assign your Meta App and WhatsApp Business Account.
  4. Click Generate New Token, select your App, set expiration to Never, and check permissions:
    whatsapp_business_messaging, whatsapp_business_management.
  5. Copy the generated 60-day or permanent bearer token.
4

Configure WhatsApp Cloud API in SocialSuite

Extract the Phone Number ID and WhatsApp Business Account ID from the API Setup tab:

APPSETTINGS.JSON - WHATSAPP CLOUD API
"WhatsApp": {
  "ApiUrl": "https://graph.facebook.com/v19.0/",
  "PhoneNumberId": "109876543210987",
  "BusinessAccountId": "234567890123456",
  "AccessToken": "EAABwzLIX1234567890abcdef...",
  "WebhookVerifyToken": "SocialSuiteSecureWebhookToken2026!"
}

Google Cloud Console & YouTube Data API v3

Publish video reels, manage channel playlists, and sync YouTube engagement

Google Cloud Console
1

Create GCP Project & Enable YouTube API

Log in to Google Cloud Console, select or create project SocialSuite-Production.

Go to APIs & Services > Library, search for YouTube Data API v3, and click Enable.

2

Configure OAuth Consent Screen

Navigate to APIs & Services > OAuth consent screen:

  • User Type: External
  • Add App Name, User support email, and Developer contact information.
  • Add Scopes:
    https://www.googleapis.com/auth/youtube.upload
    https://www.googleapis.com/auth/youtube.readonly
3

Create OAuth 2.0 Client Credentials

Go to APIs & Services > Credentials > Create Credentials > OAuth client ID.

  • Application Type: Web application
  • Authorized redirect URIs:
    AUTHORIZED REDIRECT URI
    https://yourdomain.com/Account/GoogleCallback
4

Plug Credentials into Configuration

APPSETTINGS.JSON - GOOGLE CONFIG
"Authentication": {
  "Google": {
    "ClientId": "123456789-abc.apps.googleusercontent.com",
    "ClientSecret": "GOCSPX-yourClientSecretKey"
  }
}

LinkedIn Developer Portal

Publish company articles, image carousels, and retrieve B2B company page metrics

LinkedIn Developers
1

Create an App & Verify Company Association

In the LinkedIn Developer Portal, click Create App. Enter your App Name, associate it with your official LinkedIn Company Page, and upload your brand logo.

Click Verify to send an administrative approval notification to the LinkedIn Page Admin.

2

Activate Required LinkedIn Products

Go to the Products tab and request access to:

  • Share on LinkedIn: Enables publishing status updates, URLs, and image posts.
  • Sign In with LinkedIn using OpenID Connect: Enables user authentication.
  • Community Management API: Required for managing client Company Pages and reading comments.
3

Register Callback URL & Retrieve Secrets

Under the Auth tab, add your live OAuth Redirect URL:

LINKEDIN REDIRECT URL
https://yourdomain.com/Account/LinkedInCallback

Copy the Client ID and Primary Client Secret into your configuration:

APPSETTINGS.JSON - LINKEDIN CONFIG
"Authentication": {
  "LinkedIn": {
    "ClientId": "77abc12345xyz",
    "ClientSecret": "LINKEDIN_CLIENT_SECRET"
  }
}

SMS & OTP Gateway Configuration

Configure Twilio, Gupshup, Fast2SMS, or custom HTTP telecom endpoints

1

Global Delivery: Twilio SMS

For international text messaging, register an account on Twilio.com and purchase a high-throughput phone number or Alphanumeric Sender ID.

APPSETTINGS.JSON - TWILIO SMS CONFIG
"Sms": {
  "Provider": "Twilio",
  "AccountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "AuthToken": "your_twilio_auth_token_here",
  "FromNumber": "+1234567890",
  "SenderId": "SOCLSTE"
}
2

India / Regional Telecom: DLT Template Compliance

If sending messages to Indian recipients (+91), TRAI mandates DLT registration:

  • Register entity and sender header (e.g. SCLSTE) on Vilpower/Jio DLT.
  • Submit SMS Content Templates for approval to receive a 19-digit DLT Template ID.
  • Configure your custom HTTP SMS gateway in appsettings.json:
    APPSETTINGS.JSON - CUSTOM HTTP SMS GATEWAY
    "Sms": {
      "Provider": "CustomHttp",
      "EndpointUrl": "https://api.sms-gateway.com/send",
      "ApiKey": "YOUR_SMS_API_KEY",
      "SenderId": "SCLSTE",
      "DltTemplateId": "1207161728392019283"
    }

SMTP & Transactional Email Delivery

Configure automated client reports, password resets, and marketing campaigns

SocialSuite supports any standard RFC-compliant SMTP server (SendGrid, Mailgun, Amazon SES, Google Workspace, or Microsoft 365).

APPSETTINGS.JSON - SMTP EMAIL CONFIG
"Email": {
  "SmtpServer": "smtp.sendgrid.net",
  "Port": 587,
  "SenderName": "SocialSuite Marketing",
  "SenderEmail": "notifications@yourdomain.com",
  "Username": "apikey",
  "Password": "SG.your_sendgrid_api_key_here",
  "EnableSsl": true
}
Deliverability Best Practice: Ensure your domain's DNS contains valid SPF (v=spf1 include:sendgrid.net ~all), DKIM, and DMARC records to prevent email delivery to spam folders.

Webhooks Setup & Real-time Synchronization

Verify callbacks for incoming WhatsApp chats and Meta instant leads

SocialSuite includes an automatic webhook verification handler that responds to Meta hub challenges using your configured WebhookVerifyToken.

1

Configure WhatsApp Webhook in Meta Console

In Meta Developer Portal > WhatsApp > Configuration > Callback URL:

  • Callback URL: https://yourdomain.com/api/webhooks/whatsapp
  • Verify Token: Must match WebhookVerifyToken in your appsettings.json.
2

Subscribe to Webhook Fields

Click Manage and subscribe to the following Webhook fields:

  • messages: Triggers when a customer replies to your WhatsApp messages.
  • message_template_status_update: Real-time notification when WhatsApp approves/rejects marketing templates.

Master Production Configuration Template

Complete appsettings.Production.json ready for deployment

APPSETTINGS.PRODUCTION.JSON
{
  "ConnectionStrings": {
    "DefaultConnection": "Server=tcp:your-sql-server.database.windows.net,1433;Initial Catalog=SocialMediaSuite;Persist Security Info=False;User ID=cloudadmin;Password=YourSecurePassword123!;MultipleActiveResultSets=True;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
  },
  "Authentication": {
    "Facebook": {
      "AppId": "YOUR_FACEBOOK_APP_ID",
      "AppSecret": "YOUR_FACEBOOK_APP_SECRET"
    },
    "Google": {
      "ClientId": "YOUR_GOOGLE_CLIENT_ID.apps.googleusercontent.com",
      "ClientSecret": "YOUR_GOOGLE_CLIENT_SECRET"
    },
    "LinkedIn": {
      "ClientId": "YOUR_LINKEDIN_CLIENT_ID",
      "ClientSecret": "YOUR_LINKEDIN_CLIENT_SECRET"
    }
  },
  "WhatsApp": {
    "ApiUrl": "https://graph.facebook.com/v19.0/",
    "PhoneNumberId": "YOUR_PHONE_NUMBER_ID",
    "BusinessAccountId": "YOUR_WABA_ACCOUNT_ID",
    "AccessToken": "YOUR_PERMANENT_SYSTEM_USER_ACCESS_TOKEN",
    "WebhookVerifyToken": "YourCustomSecretTokenForWebhooks2026!"
  },
  "Sms": {
    "Provider": "Twilio",
    "AccountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "AuthToken": "YOUR_TWILIO_AUTH_TOKEN",
    "FromNumber": "+1234567890",
    "SenderId": "SOCLSTE"
  },
  "Email": {
    "SmtpServer": "smtp.sendgrid.net",
    "Port": 587,
    "SenderName": "SocialSuite Marketing",
    "SenderEmail": "no-reply@yourdomain.com",
    "Username": "apikey",
    "Password": "SG.YourSendGridProductionKeyHere",
    "EnableSsl": true
  },
  "Logging": {
    "LogLevel": {
      "Default": "Warning",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*"
}