Social Media Integration Guide

Go to the Twitter Developer Portal

Open your browser and go to: https://developer.x.com

Click the "Sign Up" button in the top-right corner. Log in with the SAME Twitter account you want to post from.

Apply for a Developer Account

Twitter will ask you a few questions:

1. Select "Making a bot" or "Building tools for Twitter users" as your use case
2. In the description box, write something like: "I'm building an automated social media management tool to schedule and publish posts for my business."
3. Check the agreement boxes and submit

Create a "Project" and an "App"

After your account is approved, you'll be taken to the Developer Dashboard.

1. Click "+ Create Project"
2. Name it anything you like, e.g. "PromoteSense"
3. Select use case: "Making a bot"
4. Project description: "Automated social media posting"
5. Click "Next" and then "Create App"
6. Name your app, e.g. "MyBusiness Posts"

Get your API Key and API Secret

After creating the app, Twitter immediately shows you:

• API Key (also called "Consumer Key") - looks like: xvz1evFS4wEEPTGEFPHBog
• API Secret (also called "Consumer Secret") - looks like: L8qq9PZyRg6ieKGEKhZolGC0vJWLw8iEJ88DRdyOg

Set App Permissions to "Read and Write"

Before generating tokens, you MUST change permissions:

1. Go to your app in the Developer Portal
2. Click on the "Settings" tab
3. Scroll down to "App permissions"
4. Click "Edit"
5. Select "Read and Write" (NOT just "Read")
6. Click "Save"

Generate Access Token and Access Secret

1. Go to the "Keys and Tokens" tab of your app
2. Under "Authentication Tokens", find "Access Token and Secret"
3. Click "Generate"
4. Two new values will appear:
   • Access Token - looks like: 1234567890-AbCdEfGhIjKlMnOpQrStUvWxYz
   • Access Secret - looks like: kAcSOqF21Fu85e7zjz7ZN2U4ZRhfV3WpwPAoE3Z7kBw

Summary - Your 4 Twitter Keys

You should now have all 4 values saved in Notepad:

✅ Jump to "How to paste keys into PromoteSense"

Go to LinkedIn Developers

Open: https://www.linkedin.com/developers/

Click "Create App". You must be logged into the LinkedIn account you want to post from.

Fill in App Details

Click "Create App".

Request the right permissions (Products)

1. In your app dashboard, click the "Products" tab
2. Find "Share on LinkedIn" and click "Request Access"
3. Also request "Sign In with LinkedIn using OpenID Connect"
4. Wait for approval (usually instant, sometimes takes a few hours)

Set Redirect URL

1. Click the "Auth" tab in your app settings
2. Under "OAuth 2.0 settings", find "Authorized redirect URLs"
3. Add: https://www.linkedin.com/developers/tools/oauth/redirect
4. Click "Update" (or the + button)

Also on this same page, note down your Client ID and Client Secret - you'll need them in the next step.

Use LinkedIn's Token Generator Tool

This is the easiest way to get a token without any coding:

1. Go to: https://www.linkedin.com/developers/tools/oauth
2. Select your app from the dropdown
3. Under "OAuth Scopes", check these boxes:
   • ☑ w_member_social (to post on your personal profile)
   • ☑ r_liteprofile (to read your profile info)
4. Click "Request access token"
5. LinkedIn will redirect you to a login page - log in and click "Allow"
6. You'll get an Access Token - it's a long string of letters and numbers

Copy Your Access Token

The token will look something like:

Copy this entire value and save it in Notepad.

Summary - Your LinkedIn Key

The other 3 fields (Access Secret, API Key, API Secret) can be left blank for LinkedIn.

✅ Jump to "How to paste keys into PromoteSense"

Make sure you have these 3 things

1. A Facebook Page for your business (not your personal profile)
2. An Instagram Business or Creator account (not a personal account)
3. Your Facebook Page linked to your Instagram account

Go to Meta Developer Portal

Open: https://developers.facebook.com/

Click "My Apps" (top right) and then "Create App".

Set Up the App

1. Select app type: "Business"
2. App name: e.g. "MyBusiness Social"
3. Contact email: your business email
4. Business Portfolio: select your business (or "I don't have one")
5. Click "Create App"

Add Instagram Graph API to your app

1. In the App Dashboard, scroll down to "Add Products"
2. Find "Instagram Graph API" and click "Set Up"

Use the Graph API Explorer

This is the easiest way to get your token:

1. Go to: https://developers.facebook.com/tools/explorer/
2. In the top-right dropdown, select your app
3. Click "Generate Access Token"
4. A popup will ask you to grant permissions. Check these boxes:
   • ☑ pages_show_list
   • ☑ pages_read_engagement
   • ☑ pages_manage_posts
   • ☑ instagram_basic
   • ☑ instagram_content_publish
5. Click "Generate Access Token" and then "Allow" in the popup

Convert to a Long-Lived Token (IMPORTANT!)

The token from Step 5 expires in 1 hour. You need to convert it to a long-lived token (60 days):

1. Go to: https://developers.facebook.com/tools/debug/accesstoken/
2. Paste your token and click "Debug"
3. At the bottom, click "Extend Access Token"
4. A new, longer token will appear - copy this one

Find Your Instagram Business Account ID

Go back to the Graph API Explorer and paste this into the query box at the top:

Click "Submit". You'll see a result like:

The number inside instagram_business_account.id (e.g. 17841412345678901) is your Instagram Page ID. Copy it.

Summary - Your Instagram Keys

Leave Access Secret and API Secret blank for Instagram.

✅ Jump to "How to paste keys into PromoteSense"

Create or verify your Meta Business Account

1. Go to: https://business.facebook.com/
2. If you don't have an account, click "Create Account"
3. Enter your business name, your name, and business email
4. Complete verification if prompted

Create a Meta Developer App

1. Go to: https://developers.facebook.com/
2. Click "My Apps" then "Create App"
3. Select type: "Business"
4. App name: e.g. "MyBusiness WhatsApp"
5. Link to your Meta Business Account
6. Click "Create App"

Add WhatsApp product to your app

1. In your App Dashboard, scroll to "Add Products"
2. Find "WhatsApp" and click "Set Up"
3. Select your Meta Business Account when prompted

Configure WhatsApp in your app

1. After adding WhatsApp, click "WhatsApp" > "API Setup" in the left sidebar
2. You'll see a test phone number provided by Meta (you can use this for testing)
3. Your Phone Number ID is shown on this page - it looks like: 123456789012345
4. Copy this Phone Number ID and save it in Notepad

Get a Temporary Token (for testing)

On the same "API Setup" page, you'll see a "Temporary access token". This expires in 24 hours but is good for testing.

Copy this token for initial testing.

Get a Permanent Token (for production)

For long-term use, create a permanent (non-expiring) System User token:

1. Go to Meta Business Settings > System Users
2. Click "Add" to create a new System User
3. Name: "PromoteSense Bot", Role: "Admin"
4. Click "Generate New Token"
5. Select your WhatsApp app
6. Check these permissions:
   • ☑ whatsapp_business_management
   • ☑ whatsapp_business_messaging
7. Click "Generate Token"
8. Copy the token - this one does NOT expire

Add your own phone number (optional)

To send from your actual business number instead of the test number:

1. In "WhatsApp" > "API Setup", click "Add phone number"
2. Enter your business phone number (must have WhatsApp Business app installed)
3. Verify via SMS or voice call
4. Your new Phone Number ID will appear - use this one instead

Summary - Your WhatsApp Keys

Leave Access Secret and API Secret blank for WhatsApp.

✅ Jump to "How to paste keys into PromoteSense"

Upload contacts and send

1. Go to WhatsApp page in the sidebar
2. Upload a CSV file with columns: Name,Phone (phone format: 919876543210)
3. Type your message or use "AI Suggest" to get message ideas
4. Click "Send Broadcast"
5. PromoteSense sends your message to each contact via the WhatsApp Cloud API
6. Cost: Rs.0.50 per message, deducted from your wallet

Go to Settings

Log in to PromoteSense and click "Settings" in the left sidebar (the gear icon at the bottom).

Find "Platform Connections"

Scroll down to the "Platform Connections" card. You'll see a dropdown and 4 text fields.

Select the Platform and Paste Your Keys

For Twitter:

For LinkedIn:

For Instagram:

For WhatsApp:

Click "Save Connection"

Click the "Save Connection" button. You should see a green success message: "Platform connection saved."

The platform will now appear in the "Platform Connections" list above with a green "Connected" badge.