IMPORTANT: If you have an existing Facebook application that you previously used in the legacy version of our service, then use that Facebook application. The same Facebook application works in both the legacy and the new version of the service. Just edit your Facebook application at developers.facebook.com and change all the legacy.socialoomph.com references to www.socialoomph.com.
To create a Facebook application, please follow the steps below:
Open a new browser tab and log in to your personal Facebook profile at developers.facebook.com.
Register as a developer if it gives you that option, meaning if you have not yet registered as a developer.
Important: Do not change any other setting and do not put content into any other fields on any of the tabs if we did not tell you to do so below.
In the top menu, click the My Apps entry.
Click Create App entry.
Click the Business option and click Next.
Fill out the Display Name and App Contact Email fields. Display Name can be anything and will appear in the "via" part of every post you publish.
Click the Create App button.
Click Settings, Basic in the sidebar.
Enter socialoomph.com and www.socialoomph.com in the App Domains field, enter a Contact Email (your email address), enter https://www.socialoomph.com/privacy/ in the Privacy Policy URL field, enter https://www.socialoomph.com/terms/ in the Terms of Service URL field.
Upload an app icon image of your choice, and select the "Yourself or your own business" option, and choose a category for your app.
Click the Add Platform bar at the bottom of the page and click Website, then click Next.
Enter https://www.socialoomph.com in the Site URL field.
Click the blue Save Changes button.
Click Settings, Advanced in the sidebar.
Set the Require App Secret Yes/No toggle to Yes and click the blue Save Changes button.
Click the Products - Add Product in the sidebar.
Click the Setup button of the Facebook Login entry.
Click the Web entry.
Enter https://www.socialoomph.com in the Site URL field and click the Save and Continue buttons.
Click the Settings entry of Facebook Login in the sidebar.
Enter https://www.socialoomph.com/facebook/callback/ in the Valid OAuth Redirect URIs field. (When you are done with step 21, please double-check that the URL is still present. Facebook sometimes loses the URL from that field. In step 28, if you get an error message that starts with "Given URL is not allowed by the Application configuration...", return to this step and ensure that the URL in the box is correct.)
Click the blue Save Changes button.
Click Roles, Roles in the sidebar. The Facebook account in the Admin section is the only one that you will be able to add to SocialOomph and schedule posts for the feed of its pages. If you also want to add Facebook pages that belong to other Facebook profiles, then add those profiles in the Developer section. Then, for each of the additional profiles, log in to that Facebook profile, navigate to developers.facebook.com, and approve the request to be added as a Developer of your application. Then you will also be able to add (step 28) and publish to those pages.
Click the Show button of the App Secret field (a few dots) and enter your password if requested.
Copy the now visible App Secret (a string of alphanumeric characters) and paste it into the Facebook app secret field of SocialOomph's Add Facebook App form.
Click the Save button.
Make sure that your application is in "Development" mode ("Status: In Development" toggle switch in the top right corner of the page), i.e., your application must not be in "live" mode.
Back at your account in SocialOomph.com, now add the Facebook pages by using Social Networks, Social Profiles, Connect Social Profiles, Connect Facebook Page. Important: During the authorization process in one of the pop-up screens Facebook is going to ask you what the default privacy level of posts should be (the default is Friends). You must change that default if you want a wider audience for your posts. Also Important: If Facebook warns you about a review that's required, do not click the Cancel button. Click the blue OK button.
Please let us know if these instructions are out of date so that we can update them.
If you receive the following error message when you try to publish to Facebook: "Given URL is not allowed by the Application configuration.: One or more of the given URLs is not allowed by the App's settings. It must match the Website URL or Canvas URL, or the domain must be a subdomain of one of the App's domains," redo step #20. Facebook sometimes loses the URL that you entered in step #20.
Special considerations if you changed your Facebook application from an existing one to a new one
If you've previously created and used a Facebook application and you create and use a new Facebook application, please note that you are going to have duplicate Facebook page entries in your list of social profiles in SocialOomph (Social Networks, Social Profiles in the menu) when you authorize the new application to access your Facebook account. All your scheduled and published posts will be connected to the "old" entry in the social profiles list. You will also need to change any RSS feeds and queues to use the "new" entry. Due to a change that Facebook made on May 1, 2014, it is impossible for us to know that two Facebook accounts are the same account if you switch from one Facebook application to a new application.
Do not delete the old Facebook application at developers.facebook.com because, if you do, Facebook will also delete all the posts that were published using that application.
Submitting Your Facebook Application For Approval By Facebook
Please follow the steps below:
In the browser address bar, type in developers.facebook.com and press Enter.
Log in to your Facebook account, and then in the top menu, click the My Apps entry, and select your Facebook application.
ClickSettings, Basic in the left side bar.
In the App Icon area, upload an image that will serve as the icon of your application. It can be any image of your choice.
In the left sidebar, click App Review, Requests and click "Request Permissions Or Features".
Click the *Request Advanced Access button of the pages_manage_posts permission, then click the Continue button of the permission. If you missed this step, then you can also add the permission by clicking Permissions And Features in the left sidebar, and then in the main window, click the Request button of the pages_manage_posts entry.
Click the Edit App Review Request button.
Select No for the first radio button question and Yes for the second radio button question in the pop-up dialog and click Continue To App Review.
Click the "blue right-arrow" link next to Provide Verification Details and fill in the following:
In the text boxuse the structure that Facebook suggests inside the text box to describe how a Facebook reviewer can log in to your SocislOomph account and schedule a post for your Facebook account.
Then click the "blue right-arrow" link next to "How will your app use..." to complete and submit the review request.
If Facebook requires you to request any additional permissions, such as pages_show_list or pages_read_engagement, enter in the description of each of those permissions, "I do not use this permission, it is only requested because the Facebook system requires it to be requested in conjunction with pages_manage_posts." Attach the same video as above.
Now you will have to wait for Facebook staff to review your application. It might take several days or weeks, depending on how many submissions they have to review. Facebook staff might email you and ask for additional details, such as your SocialOomph login credentials.
Facebook staff also might email you and ask you for "business verification", where they would want you to supply information about your business, such as name, address, telephone, and a copy of a utility bill. If you don't have a business, then explain to them that you are a sole proprietor, and supply them with any information that they might request.
Once your application has been approved, you can make the application public by changing the "Status: In Development" toggle switch in the top right corner of your application's page on developers.facebook.com to "Status: On".