Facebook and Instagram

Facebook and Instagram are separate GoConva connections that both originate in a Meta app.

Create a Meta app

Create the app

At developers.facebook.com, create an app of type Business.

Add products

Add Facebook Login for Pages, and Instagram for Instagram business accounts.

Set redirect URIs

Under each product’s settings, add your callback to Valid OAuth Redirect URIs:

https://api.yourdomain.com/connect/state

Copy credentials

App settings → Basic holds the App ID and App Secret.

Configure GoConva

FACEBOOK_CLIENT_ID=your-app-id
FACEBOOK_CLIENT_SECRET=your-app-secret
FACEBOOK_REDIRECT_URI=https://api.yourdomain.com/connect/state

INSTAGRAM_CLIENT_ID=your-instagram-app-id
INSTAGRAM_CLIENT_SECRET=your-instagram-app-secret
INSTAGRAM_REDIRECT_URI=https://api.yourdomain.com/connect/state

Scopes

Facebook
Instagram

Scope	Grants
`public_profile`	Basic profile
`pages_show_list`	List the Pages the user manages
`pages_read_engagement`	Read Page content and engagement
`pages_manage_posts`	Create and delete Page posts
`pages_manage_engagement`	Manage comments and reactions

Connect with GET /connect/facebook.

Scope	Grants
`instagram_business_basic`	Basic account info
`instagram_business_content_publish`	Publish posts
`instagram_business_manage_comments`	Read and reply to comments
`instagram_business_manage_messages`	Read and send direct messages

Connect with GET /connect/instagram.

These scopes require a Professional Instagram account — Business or Creator. Personal accounts cannot be connected.

Connect

In your workspace, go to Settings → Integrations and click Connect on Facebook or Instagram. Facebook asks which Pages to grant access to — select every Page the agents should manage, as unselected Pages stay invisible. For Instagram, GoConva upgrades the short-lived token to a long-lived one automatically, so the connection lasts about 60 days before it needs reconnecting.

App Review

While your Meta app is in Development mode, only people with a role on the app can authorize it. Going live with real users requires submitting each permission above for App Review, which asks for a screencast and a written justification. Budget time for this — it is the longest lead item in a Meta integration.

Troubleshooting

Symptom	Fix
`URL Blocked`	The redirect URI is not in Valid OAuth Redirect URIs.
No Pages returned	The user manages no Pages, or did not grant `pages_show_list` at consent.
Instagram connect fails	The account is Personal, or not linked to a Facebook Page.
Works for you, not customers	The app is in Development mode. Complete App Review.
Instagram stops after ~60 days	The long-lived token expired. Reconnect.

Getting started

Integrations

Open source

Facebook and Instagram

Create a Meta app

Configure GoConva

Scopes

Connect

App Review

Troubleshooting

​Create a Meta app

​Configure GoConva

​Scopes

​Connect

​App Review

​Troubleshooting

Create a Meta app

Configure GoConva

Scopes

Connect

App Review

Troubleshooting