Meta (Instagram)
For the administrator: what to set up so people can press Connect with Instagram under Settings › Integrations. Without it, the Instagram card says sign-in is not set up and accepts a pasted token instead.
In the Meta developer console
Create an app with Facebook Login for Business. PULSE uses the Instagram API with Facebook Login (Graph API
v23.0): the person signs in at Facebook, and PULSE finds the Instagram professional account through the Facebook Page it is linked to.Add
<PULSE_PUBLIC_BASE_URL>/oauth/social/callbackto the valid OAuth redirect URIs (see Public address and redirects).Request these permissions. The sign-in asks for all of them at once:
Permission Needed for instagram_basic,pages_show_list,pages_read_engagementEvery feature instagram_content_publishPublishing posts, carousels, Reels and Stories instagram_manage_insightsResults (reach, views, likes, comments, saves, shares), and checking an @mention before it is tagged (business discovery) instagram_manage_commentsComments, replies, and posts that tag the account instagram_manage_messages,pages_manage_metadataDirect messages and replies to them Every permission needs Advanced Access through Meta App Review, and Meta asks for business verification, before it works for accounts that have no role on the app. Until then, only people with a role on the app can connect.
For direct messages, the Instagram account’s setting Allow access to messages must also be on.
What @mentions need
Tagging an account in a post, carousel, Reel or Story is part of publishing
(user_tags on the media container): it needs no permission beyond
instagram_content_publish. Before tagging, PULSE checks each account with
business discovery (GET /<IG user>?fields=business_discovery.username(…)),
which needs instagram_basic, instagram_manage_insights and
pages_read_engagement, all already in the sign-in. Business discovery finds
only business and creator accounts: a personal account, or any account when
instagram_manage_insights is missing, is shown as not checked in Studio
and stays in the caption as @name without being tagged (the person decides).
Instagram allows 20 @mentions in one caption.
In PULSE
Set META_APP_ID and META_APP_SECRET (the secret from the instance’s
secret store, never from a repository secret) and an https
PULSE_PUBLIC_BASE_URL.
PULSE exchanges the sign-in for a long-lived token, stores it sealed, and
renews it in its last ten days; a failed renewal is shown on the card. A
permission the person did not grant is listed on the card, and a read that
needs it says Reconnect to allow …. Disconnect removes PULSE’s grant
at Meta (DELETE /me/permissions), then the stored tokens.
Connecting publishes nothing. Publishing also needs PULSE_APPLY_ENABLED and
PULSE_PUBLISH_INSTAGRAM; replies need PULSE_PUBLISH_INSTAGRAM_REPLIES or
PULSE_PUBLISH_INSTAGRAM_DMS. See
Switches and arming order.