Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Miksi Facebook-sivun API-yhteys lakkaa toimimasta ja miten se pidetään toimivana

Facebook-sivun yhteys lakkaa toimimasta, kun Meta lakkaa hyväksymästä sen tokenia tai lakkaa lähettämästä sen tapahtumia: token on peräisin lyhytaikaisesta kirjautumisesta, henkilö vaihtoi salasanansa (virhe 190, alikoodi 460), menetti roolinsa sivulla (492) tai poisti sovelluksen Business-integraatioista (458), käyttöoikeutta ei ole käytetty 90 päivään, sovellus oli passiivinen tai Meta rajoitti sivua.

easyCoexistence hakee jokaisen sivun tokenin pitkäaikaisesta kirjautumisesta, tarkistaa sivun joka 6.

Hours

Metan oletuskäyttäjä- ja sivutokenien elinikä. Pitkäaikaisesta käyttäjätokenista saatu sivutoken ei vanhene.

90 days

Jos sovelluksella ei ole kirjautumisia, API-kutsuja tai webhookeja näin pitkään, Meta pitää sovellusta passiivisena ja mitätöi kaikki sen tokenit.

Exempt

Sivuoikeudet, kuten pages_manage_posts ja read_insights, eivät vanhene 90 päivän tietojen käyttöjakson myötä.

page_messaging_api

Page Integrity -rajoitus, joka estää sivua lähettämästä viestejä Messenger Platform API:n kautta.

6 hours

Kuinka usein easyCoexistence tarkistaa jokaisen yhdistetyn sivun kevyellä Graph-kutsulla ja lähettää omistajalle sähköpostin, jos Meta hylkää tokenin.

Mikä voi saada sivuyhteyden lakkaamaan toimimasta?

Syitä on neljällä tasolla: henkilön kirjautuminen, sovelluksen käyttöoikeudet ja asema, sivu itse sekä webhookin tilaus. Jokainen näkyy omalla tavallaan, ja useimmat palautuvat virheenä 190 alikoodilla, joka nimeää syyn:

Short-lived sign-in190, subcode 463: the Page token expired with the user token it came from
Password change or logout190, subcode 460
Account checkpoint190, subcode 459 or 464: the person must log in at facebook.com
Role removed from the Page190, subcode 492
App removed in Business integrations190, subcode 458, and a call to the deauthorize callback
Permission unused for 90 daysCode 10, or one from 200 to 299, on the calls that need it
App inactive for 90 daysAll of the app's tokens invalidated
Page restricted368, or 10 with subcode 1893063 for messages
Webhooks failing for an hourThe app unsubscribed from the Page's events

Miksi sivutoken voi vanhentua tunneissa?

Koska se luettiin päätepisteestä /me/accounts lyhytaikaisella käyttäjätokenilla, jolloin sekin on lyhytaikainen. Metan oletuskäyttäjä- ja sivutokenit vanhenevat tunneissa, lyhytaikaisen tokenin tapauksessa noin yhdessä tai kahdessa tunnissa. Kun vaihdetaan palvelimella fb_exchange_token-kutsulla, käyttäjätoken on voimassa noin 60 päivää, ja sillä luettu sivutoken ei vanhene. Meta ei jatka jo vanhentunutta tokenia: virhe kertoo, että istunto on vanhentunut, alikoodi on 463, ja henkilön täytyy kirjautua uudelleen.

Mitä tapahtuu salasanan vaihdon tai turvatarkistuksen jälkeen?

Meta mitätöi henkilön tokenit. Uloskirjautuminen tai salasanan vaihto palauttaa virheen 190 alikoodilla 460: istunto ei ole voimassa, koska käyttäjä kirjautui ulos. Meta varoittaa myös, että turvatapahtumat voivat mitätöidä tokenit ennen odotettua vanhenemista. Alikoodit 459 ja 464 tarkoittavat, että tili itse tarvitsee huomiota: henkilön täytyy kirjautua facebook.com-sivustolle korjatakseen ongelman ja kirjautua sitten sovellukseen uudelleen. Muuten korjaus on uusi kirjautuminen, henkilöltä itseltään tai joltakin muulta, jolla on rooli sivulla.

Mitä tapahtuu, kun henkilö menettää roolinsa sivulla?

Hänen sivutokeninsa lakkaa toimimasta virheellä 190, alikoodilla 492, jonka Meta kuvaa siten, että sivun käyttötokeniin liittynyt käyttäjä ei enää ole sivulla sopivassa roolissa. Tokenit myönnetään sivu-, henkilö- ja sovelluskohtaisesti, joten muiden roolissa olevien tokenit toimivat yhä. Korjaus on yhdistää sivu uudelleen tililtä, jolla on yhä täydet hallinta- tai tehtäväoikeudet, mieluiten tililtä, joka ei ole lähdössä yrityksestä.

Mitä tapahtuu, kun joku poistaa sovelluksen Business-integraatioista?

Meta mitätöi sovelluksen käyttäjätokenit kyseiseltä henkilöltä, ja niillä luetut sivutokenit lakkaavat toimimasta myös virheellä 190, alikoodilla 458: käyttäjä ei ole valtuuttanut sovellusta. Ihmiset poistavat sovelluksen Facebookin asetuksista kohdasta Business-integraatiot, ja Meta kutsuu sitten sovelluksen deauthorize-takaisinkutsua. Järjestelmäkäyttäjän token päättyy samalla tavalla Business Managerissa kohdassa Business-asetukset, Integraatiot, Yhdistetyt sovellukset. Sovellus voi lopettaa oman käyttönsä kutsulla DELETE /{user-id}/permissions.

Vanhenevatko sivuoikeudet 90 päivän jälkeen?

Kahta eri 90 päivän sääntöä on olemassa, ja vain toinen koskee sivuoikeuksia. Tietojen käyttöoikeuden vanheneminen katkaisee sovelluksen 90 päivän kuluttua henkilön viimeisestä aktiivisuudesta. Se ei koske oikeuksia pages_show_list, pages_manage_posts, pages_messaging ja read_insights, eikä muita sivuoikeuksia, jotka Meta listaa vanhenemattomiksi. Oikeuksien vanheneminen koskee kuitenkin sitä: sovelluksen käyttämätön oikeus voi vanhentua 90 päivän kuluttua, vaikka se olisi hyväksytty App Review:ssa, ja henkilön on myönnettävä se uudelleen. Kutsut, jotka sitä tarvitsevat, epäonnistuvat virheellä 10 tai jollakin 200-alueen virheellä, kunnes uusi kirjautuminen myöntää sen.

Voiko koko sovellus menettää pääsynsä?

Kyllä, kolmella dokumentoidulla tavalla, joista Meta varoittaa kiireellisellä ilmoituksella sovelluksen hallintapaneelin hälytysten saapuneet-kansiossa. Sovellus, jolla ei ole kirjautumisia, Graph API- tai Marketing API -kutsuja eikä webhook-ilmoituksia 90 päivään, katsotaan passiiviseksi, ja Meta mitätöi kaikki sen tokenit. Sen palauttaminen sovelluksen hallintapaneelista päivittää sen uusimpaan versioon, mutta vanhat tokenit pysyvät mitätöityinä, ja käyttämättömyyden vuoksi pudonneet oikeudet kulkevat uudelleen App Review:n läpi. Vuosittainen Data Use Checkup on suoritettava, ja Metan ehtojen tai käytäntöjen rikkominen voi rajoittaa API-pääsyä tai peruuttaa oikeuksia.

Mitä tapahtuu, kun Meta rajoittaa sivua?

Rajoitetut toiminnot epäonnistuvat: virhe 368, väliaikaisesti estetty käytäntörikkomusten vuoksi, tai viestien lähetyksessä virhe 10 alikoodilla 1893063. Metan Page Integrity API kertoo, mikä on kyseessä: GET /{page-id}/page_status, oikeudella pages_manage_metadata, palauttaa tilan ok, warning, restricted tai suspended, jokaisen aktiivisen rajoituksen, kuten page_publish, page_read_only, page_messaging tai page_messaging_api, sen expiration_time-arvon sekä suositellut toimet, kuten FILE_APPEAL. Webhookin kenttä business_integrity raportoi muutokset heti niiden tapahduttua.

Miksi tapahtumat loppuvat, vaikka API-kutsut toimivat yhä?

Koska webhookit epäonnistuvat omilla ehdoillaan. Tunnin epäonnistuneiden toimitusten jälkeen Meta lähettää Webhooks Disabled -hälytyksen ja poistaa sovelluksen tilauksen sivulta, kunnes se tilaa uudelleen. Sivulle, joka on sammuttanut App platformin sovelluksen asetuksistaan, Meta ei lähetä lainkaan mitään. Token voi pysyä voimassa molemmissa tapauksissa, joten katkoksen jälkeen tarkista GET /{page-id}/subscribed_apps, ja kun päätepiste vastaa taas, lähetä sille POST sivutokenilla.

Miten katkennut yhteys havaitaan ennen kuin julkaisu epäonnistuu?

Tarkistamalla aikataulun mukaan, koska Meta ei ilmoita sovellukselle, kun token muuttuu mitättömäksi. Kevyt kutsu, kuten GET /{page-id}?fields=id,name sivutokenilla, epäonnistuu samalla tavalla kuin julkaisu. debug_token, kutsuttuna sovelluksen ID:llä ja salaisuudella käyttötokenina, palauttaa kentät is_valid ja expires_at sekä myönnetyt oikeudet. Mitä tahansa tokenia, joka ei enää toimi, se kuvaa virhekoodilla ja alikoodilla. page_status raportoi rajoitukset, ja deauthorize-takaisinkutsu ilmoittaa poistetusta sovelluksesta.

Inspect a Page token with debug_token
curl -G "https://graph.facebook.com/v26.0/debug_token" \
  --data-urlencode "input_token=$PAGE_TOKEN" \
  --data-urlencode "access_token=$APP_ID|$APP_SECRET"

# data.is_valid, data.expires_at, data.scopes, data.granular_scopes,
# and data.error.code with data.error.subcode once the token stops working

Miten sivu yhdistetään uudelleen?

Samalla kulkuna, jolla se yhdistettiin, ja sen tekee joku, jolla on yhä rooli sivulla, kun syy on korjattu, jos syy on tiedossa. Turvatarkistuksessa oleva tili kirjautuu facebook.com-sivustolle, rajoitus käy läpi suositellun toimensa ja epäonnistuva päätepiste vastaa taas 200. Uusi kirjautuminen palauttaa uudet tokenit, joten korvaa tallennetut tokenit äläkä säilytä molempia:

1Fix the causeCheckpoint, restriction or endpoint first
2Sign in againFacebook Login for Business, code exchanged on the server
3Long-lived tokenfb_exchange_token, about 60 days
4New Page tokenRead /me/accounts and replace the stored one
5Subscribe againPOST /{page-id}/subscribed_apps if events had stopped

Mitä easyCoexistence tekee, kun sivuyhteys katkeaa?

Se valvoo katkoksia, jotka se näkee, ja kertoo niistä sinulle. Joka 6. tunti se tarkistaa jokaisen yhdistetyn sivun kutsulla GET /{page-id}?fields=id,name. Kun Meta hylkää tokenin virheellä 190 tai 102, joko tuon tarkistuksen tai minkä tahansa työkalukutsun aikana, sivu merkitään tilaan Reconnect needed, sen omistaja saa yhden sähköpostin ja kumppanialusta vastaanottaa tapahtuman channel.disconnected. Muut hylkäykset, kuten puuttuva oikeus tai käytäntöesto, palautuvat työkalun tuloksessa Metan koodilla ja viestillä.

Kun joku poistaa sovelluksen Business-integraatioista, Metan deauthorize-takaisinkutsu tavoittaa easyCoexistencen. Se poistaa sen henkilön yhdistämät sivut, heidän tokenit ja tapahtumakohteet, poistaa sivut laskutuksesta ja lähettää tapahtuman channel.removed. Kirjautuminen uudelleen hallintapaneelista tuo sivun takaisin samana yhteytenä, kommenttisääntöineen ja automaatioineen, ja se tilataan uudelleen kenttiin feed, messages ja mention. Tila Reconnect needed jättää tapahtumakohteen paikalleen. Poiston jälkeen set_social_webhook_destination asettaa sen uudelleen uudella salaisuudella.

Yleiset virheet

  • Virheen 190 uudelleenyritys. Hylätty token epäonnistuu samalla tavalla joka kutsulla, ja vain uusi kirjautuminen henkilöltä, jolla on rooli sivulla, tuottaa kelvollisen tokenin.
  • Yhdistäminen uudelleen rajoituksen poistamiseksi. Uusi token ei muuta sivun tilaa, vaan sen muuttavat page_status-kentän suositellut toimet, kuten valitus.
  • Oikeuden pyytäminen, jota tuote harvoin käyttää. Käyttämättömänä 90 päivää se voi vanhentua, ja sitä tarvitsevat kutsut epäonnistuvat, joten pyydä sitä vasta, kun ominaisuus julkaistaan.
  • Vanhan tokenin säilyttäminen uudelleenyhdistämisen jälkeen. Uusi kirjautuminen palauttaa eri tokenmerkkijonon, ja työ, joka yhä pitää vanhaa, epäonnistuu virheellä 190.
Näin teet tämän EasyCoexistencen avulla

tunti ja lähettää sinulle sähköpostin, kun Meta hylkää tokenin. Yksi Facebook-kirjautuminen tuo sivun takaisin samana yhteytenä, kommenttisääntöineen ja automaatioineen. Alkaen US$ 9 per yhteys kuukaudessa, laskien US$ 0,75:een lisäämisen myötä, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Lakkaako sivutoken toimimasta, kun 60 päivän käyttäjätoken vanhenee?

Ei, jos se luettiin päätepisteestä /me/accounts tuolla pitkäaikaisella käyttäjätokenilla. Sellaisella sivutokenilla ei ole vanhenemispäivää, mutta tällä sivulla kuvatut syyt voivat silti lopettaa sen toiminnan.

Kertooko Meta, kun sivutoken lakkaa toimimasta?

Ei tokenille, joka muuttuu mitättömäksi: seuraava kutsu palauttaa virheen. Meta kutsuu sovelluksen deauthorize-takaisinkutsua, kun joku poistaa sovelluksen, ja varoittaa sovelluskohtaisista riskeistä sovelluksen hallintapaneelin hälytysten saapuneet-kansiossa.

Voiko toisen henkilön token pitää sivuyhteyden yllä?

Kyllä. Sivutokenit myönnetään sivu-, henkilö- ja sovelluskohtaisesti, joten toisen henkilön token toimii yhä, kun hänellä on rooli sivulla ja yhden henkilön käyttöoikeus päättyy.

Paljonko easyCoexistence maksaa Facebook-sivulle?

Alkaen US$ 9 per yhteys kuukaudessa, laskien US$ 0,75:een yhteyksien määrän kasvaessa. Kukin sivu lasketaan yhdeksi yhteydeksi, ja ensimmäiset 3 päivää ovat ilmaisia.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu