Everything on our side is built and live. Four fields in the Meta App Dashboard are all that is left, and only the app owner can change them. This is each one, photographed, with the detail that has caused two missed attempts.
Sign in with Facebook is built and live on all four agents. The button appears, and pressing it sends the person to Facebook correctly. What does not happen is Facebook sending them back.
Between 13 and 16 October our server recorded twelve sign in attempts leaving for Facebook and not one completed sign in. Facebook answers every one of them with the same message:
Can't load URL: The domain of this URL isn't included in the
app's domains. To be able to load this URL, add all domains and
subdomains of your app to the App Domains field in your app settings.
OAuthException, code 191
Facebook refuses before it ever contacts us, which is why there is nothing in our logs to fix. Google sign in was configured the same way on 14 October and has worked since; nothing in our code differs between the two.
The Site URL was set correctly on the first attempt. That is a different field. App Domains sits above it and is still empty, and it is the one the error is about. Section 2 is that field.
Go to App settings, then Basic, in the left hand menu of the App Dashboard.
Click the App domains box, type the domain, and press Enter.
smartzees.com
After pressing Enter the value must appear as a blue tag with a small cross next to it. If it is still plain text sitting in the box, Facebook has not accepted it and saving will not keep it. Press Enter until the tag appears.
Scroll to the bottom of the page and press Save Changes.
A second field, on a different page. Go to Facebook Login, then Settings, in the same left hand menu.
Find Valid OAuth Redirect URIs, paste the address below, and press Enter so that it becomes a tag in the same way.
https://smartzees.com/auth/facebook/callback
Press Save Changes at the bottom of this page too.
The same page has a checker, so there is no need to wait for anyone to test a sign in. It is at the top, called Redirect URI Validator.
Paste the same address into it and press Check URI.
While the app is in Development mode, only people listed as admins, developers or testers of the app can sign in. Everybody else is refused, even with sections 2 and 3 correct.
Facebook will ask for a Privacy Policy URL before it allows Live mode. It is on the same Basic settings page as section 2. Any public page describing how customer data is handled is enough.
Nothing on our side has to change. No new release, no restart, no code. The settings above take effect immediately.
The Meta app is currently named uplapp. That name is what customers will see on the Facebook permission screen, as Continue to uplapp. It will work, but if the name should be SmartZees, changing it is the Display name field on the same Basic settings page in section 2.
Written by Abad Naseer. Every measured number in this document is cited from the running system or from the code, and every target says that it is a target. Where the two disagree, the document says so rather than choosing the flattering one.