Facebook Pages setup guide

Agents read and publish for your social pages and ad accounts.

Ways to connect

Company admins connect apps, on the Integrations page in Everdeck: open Facebook Pages, choose one of the ways below, follow its steps and fill in its fields. Everdeck checks what you enter before it saves anything, and asks you to confirm it’s you (your second factor) before you type any secret. How connecting works.

Facebook Pages can be connected 2 ways. Where there’s a key or token to paste, that’s usually the quickest.

System user access token

Token.

1. Create an app of type Business at https://developers.facebook.com/apps.
2. In Meta Business Suite open Settings > Users > System users and add a system user. Assign it your Page (content, community activity, messages and insights) and the app (Manage app).
3. Click Generate token, choose the app, set the expiry to Never and tick pages_show_list, pages_read_engagement, pages_read_user_content, pages_manage_posts, pages_manage_engagement, pages_manage_metadata, pages_messaging and read_insights.
4. Paste the token and your Page ID (Page > About > Page transparency). Everdeck swaps it for the Page's own access token.

Field	What to enter
Page ID	Text. For example 102938475610293.
Access token	A secret: Everdeck saves it encrypted and never shows it again. Where to find it.

Disconnecting deletes the credentials Everdeck saved, but Everdeck can't revoke them: the key, token or password itself keeps working at Facebook Pages until you delete or rotate it there.

Your Meta app (Facebook Login for Business)

Your OAuth app.

This way signs in with an OAuth app you create for Facebook Pages, as its steps describe: Everdeck never uses an app of its own. Register this redirect URI with your app:

https://everdeck.io/api/oauth/callback

Then save the app’s client ID and secret in Everdeck, on the connect page or under OAuth apps, and sign in.

1. Create an app of type Business at https://developers.facebook.com/apps and add the Facebook Login for Business product.
2. Under Facebook Login for Business > Settings, add https://everdeck.io/api/oauth/callback to Valid OAuth Redirect URIs.
3. Give the Page admin who will connect a role on the app (App roles). With a role, no App Review is needed; people without a role need Advanced Access, which needs App Review and Business Verification.
4. Copy the App ID and App Secret (App settings > Basic) into the form, sign in and pick the Page.

Field	What to enter
Page ID (optional)	Text. For example 102938475610293. Leave it empty if you manage one Page; when you manage several, Everdeck lists them.

The scopes Everdeck asks for:

• pages_show_list
• pages_read_engagement
• pages_read_user_content
• pages_manage_posts
• pages_manage_engagement
• pages_manage_metadata
• pages_messaging
• read_insights
• business_management

Disconnecting deletes the tokens Everdeck saved. Meta revokes only the person's whole authorization of the app, which would end their other connections too: remove Everdeck under Business Integrations (Facebook) or Apps and websites.

What agents can do

An agent uses an action only when its charter grants it, on the agent’s Tools tab, where you choose whether each one runs by itself (Auto), asks first or never runs. Each action has a risk tier: tier 3 actions, which customers or the public see, ask first unless you choose otherwise, and tier 4 actions (money, deleting things, access) always need a person. How tools and tiers work.

Actions marked Reads outside content return things people outside your company may have written. Agents treat what they read as information, never as instructions, and their riskier actions later in the same session need approval.

• List Page postsTier 0 · ReadReads outside contentfacebook_pages_list_posts

  List recent posts on the Page feed (the Page's own posts plus visitor posts and posts it is tagged in), with author, permalink and reaction, comment and share counts.

• Publish a postTier 3 · Externalfacebook_pages_create_post

  Publish a text post on the Page now, optionally with a link (Facebook builds the link preview).

• Publish a photoTier 3 · Externalfacebook_pages_publish_photo

  Publish a photo post on the Page from a public image URL, with an optional caption.

• Delete a postTier 4 · Money or irreversibleReads outside contentfacebook_pages_delete_post

  Permanently delete a Page post (or photo) by ID.

• List commentsTier 0 · ReadReads outside contentfacebook_pages_list_comments

  List comments on a post, or replies to a comment, with the commenter, text, time, like and reply counts and whether the comment is hidden.

• Comment or replyTier 3 · Externalfacebook_pages_add_comment

  Comment on a post, or reply to a comment, as the Page.

• Hide or unhide a commentTier 3 · Externalfacebook_pages_hide_comment

  Hide a comment on a Page post from everyone except its author and their friends, or unhide it. Prefer this to deleting.

• Get Page insightsTier 0 · ReadReads outside contentfacebook_pages_get_page_insights

  Page metrics per day, week or 28 days: views of the Page's content, unique viewers, post engagements, new follows and Page visits.

• Get post insightsTier 0 · ReadReads outside contentfacebook_pages_get_post_insights

  Lifetime views, unique viewers, clicks and reactions by type for one Page post.

• List Messenger conversationsTier 0 · ReadReads outside contentfacebook_pages_list_conversations

  List the Page's Messenger conversations with their last update time and the participants. The participant who is not the Page is the person to reply to.

• Read a Messenger conversationTier 0 · ReadReads outside contentfacebook_pages_get_conversation_messages

  Read the most recent messages (up to 20) in a Messenger conversation, with sender and time.

• Send a Messenger replyTier 3 · Externalfacebook_pages_send_message

  Reply to a person in Messenger as the Page. Only works within 24 hours of their last message to the Page.

Testing, problems and disconnecting

Everdeck checks the connection when you save it. On the connection’s page in Integrations, Test checks it again at any time.

If Facebook Pages later refuses the connection, for example because a key was deleted or a sign-in expired, the connection shows Needs attention on the Integrations page and the people who manage connections are told. Agents can’t use it until a company admin fixes it with Edit or Reconnect.

To stop agents using Facebook Pages, open the connection and select Disconnect. Agents stop using it at once and its saved credentials are deleted. What else happens depends on how it was connected: each way above says.