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

Facebook-sivun tilaaminen webhookeihin: subscribed_apps-päätepiste

Facebook-sivu tilataan sovelluksen webhookeihin lähettämällä POST-pyyntö osoitteeseen /{page-id}/subscribed_apps. Pyynnössä annetaan subscribed_fields-kentät, kuten feed,messages, sekä Facebook-sivun käyttöoikeustoken henkilöltä, jolla on tehtävä CREATE_CONTENT, MANAGE tai MODERATE. Lisäksi tarvitaan pages_manage_metadata- ja pages_show_list-oikeudet. Meta lähettää kentän tapahtumat vain, jos myös sovellus tilaa kentän. GET listaa tilauksen ja DELETE poistaa sen.

easyCoexistence tilaa jokaisen yhdistämäsi sivun kenttiin feed, messages ja mention subscribed_apps-päätepisteen kautta, poistaa tilauksen, kun poistat sivun, ja välittää sivun tapahtumat HTTPS-päätepisteeseesi, allekirjoitettuina sivukohtaisella salaisuudella yhdeltä MCP-liittimeltä tai Partner API:sta.

Both levels

Webhookit tulevat vain kentistä, jotka on tilattu sekä sivu- että sovellustasolla. Sivulla voi olla enemmän kenttiä kuin sovelluksella.

CREATE_CONTENT, MANAGE or MODERATE

Sivun tehtävät: tokenin takana olevan henkilön on kuuluttava johonkin niistä, jotta hän voi lukea tai luoda tilauksen.

messaging_success

Palautetaan onnistumisen rinnalla, kun sovellus poistaa webhook-tilauksensa sivulta DELETE-pyynnöllä.

App access token

Vaatimukset, jotka /{app-id}/subscriptions asettaa, jotta sovelluksen tasoisen tilauksen voi lukea, luoda tai poistaa.

1 hour

Epäonnistuneiden Messenger-toimitusten jälkeen Meta irrottaa sovelluksen sivulta, ellei se tilaa uudelleen.

Mitä subscribed_apps-päätepiste tekee?

Se asentaa sovelluksen sivulle ja määrittää, mitkä sivun webhook-kentistä sovellus vastaanottaa. Meta lähettää ilmoituksia vain, kun sivulla on sovellus asennettuna eikä sovellusalustaa ole poistettu käytöstä sivun asetuksissa. Ilmoituksia tulee vain kentistä, jotka on tilattu molemmilla tasoilla: sivun tasolla tämän päätepisteen kautta ja sovelluksen tasolla App Dashboardissa tai /{app-id}/subscriptions-päätepisteen kautta. Sivulle voi tilata enemmän kenttiä kuin sovellukselle.

Miten sivu tilataan?

POST-pyynnöllä päätepisteeseen. Pyynnössä on subscribed_fields, jossa kentät on erotettu pilkuilla, ja sivun käyttöoikeustoken. Onnistunut kutsu palauttaa success: true. Jos kenttiin kuuluu messages, tokenilla tarvitaan myös pages_messaging:

Subscribing a Page to three fields
POST https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed,messages,mention
  &access_token=<PAGE_ACCESS_TOKEN>

{ "success": true }

Mitä tokenia, tehtäviä ja oikeuksia se tarvitsee?

Sivun käyttöoikeustoken, joka sitoo kutsun yhteen sivuun, henkilöltä, joka voi toimia kyseisellä sivulla. Metan ohjeet ja oppaat asettavat nämä vaatimukset:

  • Mikä tahansa kenttä: henkilö, jolla on tehtävä CREATE_CONTENT, MANAGE tai MODERATE, sekä pages_manage_metadata ja pages_show_list.
  • messages ja muut Messenger-kentät: lisäksi pages_messaging, token henkilöltä, joka voi suorittaa tehtävän MESSAGING.
  • leadgen: tehtävä ADVERTISE, sekä leads_retrieval, pages_read_engagement ja ads_management.
  • Tilauksen lukeminen GET-pyynnöllä vaatii samat tehtävät ja oikeudet kuin sen luominen.

Mitä tasoa kentät tarvitsevat?

Advanced Accessia sivuille ja henkilöille, jotka eivät ole sovelluksen omia rooleja. Standard Accessilla Messenger-ilmoitukset tulevat vain henkilöiltä, joilla on rooli sovelluksessa, kuten ylläpitäjiltä, kehittäjiltä ja testaajilta. Advanced Access myönnetään oikeuskohtaisesti App Reviewn kautta ja vaatii Business Verificationin. Sen jälkeen ilmoitukset tulevat myös sovelluksen asiakkailta. Metan Messenger-opas luettelee myös sovelluksen julkaisemisen edellytykseksi.

Mikä on sovellustason tilaus?

Toinen puoli: kentät, joita sovellus itse kuuntelee, sekä sen callback-URL. Sen asettaa App Dashboard tai POST /{app-id}/subscriptions sovellustokenilla. Pyynnössä annetaan object=page, callback_url, fields, include_values ja verify_token, ja se käynnistää Metan vahvistuspyynnön. GET samaan päätepisteeseen näyttää kunkin objektin callback_url-, fields- ja tiedon siitä, onko tilaus aktiivinen. Uusi POST muokkaa kenttiä muita kenttiä ylikirjoittamatta, ja DELETE poistaa kaikki kentät tai nimetyt kentät.

Miten tarkistat, mihin sivu on tilattu?

GET samaan päätepisteeseen sivun tokenilla. Data-taulukko listaa jokaisen sivulle asennetun sovelluksen nimen, tunnuksen ja subscribed_fields-kentät. Taulukko on tyhjä, jos sivulle ei ole asennettu sovelluksia:

Reading a Page's subscriptions
GET https://graph.facebook.com/{page-id}/subscribed_apps
  ?access_token=<PAGE_ACCESS_TOKEN>

{
  "data": [
    {
      "category": "Business",
      "link": "https://example.com/app",
      "name": "<APP_NAME>",
      "id": "<APP_ID>",
      "subscribed_fields": ["feed", "messages", "mention"]
    }
  ]
}

Miten tilaus poistetaan?

DELETE /{page-id}/subscribed_apps irrottaa sovelluksen sivulta. Sovellus voi poistaa oman tilauksensa sovellustokenilla, ja vastaus sisältää success- ja messaging_success-kentät. Meta poistaa tilauksen myös itse: kun Messenger-toimituksia on epäonnistunut tunnin ajan, sovellus tilataan sivulta irti, ja sen on tilattava uudelleen, kun päätepiste toimii.

Mitä easyCoexistence tekee yhdistettäessä?

Se tilaa jokaisen sivun, jonka henkilö valitsee, heti tallennettuaan sivun tokenin: POST /{page-id}/subscribed_apps, jossa subscribed_fields on feed,messages,mention. Jos Meta kieltäytyy, sivu pysyy yhdistettynä, ja list_social_accounts näyttää syyn kentässä last_error. Sivun poistaminen lähettää DELETE /{page-id}/subscribed_apps ennen kuin token poistetaan. Mikään työkalu ei yllä subscribed_apps- tai token-polkuihin, joten tilausta hallinnoi yksin easyCoexistence.

Yleiset virheet

  • Päätepisteen kutsuminen käyttäjän käyttöoikeustokenilla. Se vaatii tilattavan Facebook-sivun käyttöoikeustokenin.
  • Sivun tilaaminen, mutta ei sovelluksen. Kenttä saavuttaa callbackin vain, jos myös sovelluksen oma tilaus sisältää sen.
  • pages_messagingin jättäminen pois, kun tilataan messages. Meta vaatii sen tokenilla, jonka takana on henkilö, joka voi suorittaa tehtävän MESSAGING.
  • Tilauksen uusimatta jättäminen katkoksen jälkeen. Tunnin verran epäonnistuneet Messenger-toimitukset irrottavat sovelluksen, ja tapahtumat loppuvat, kunnes POST lähetetään uudelleen.
Näin teet tämän EasyCoexistencen avulla

US$ 9 alkaen, laskien US$ 0.75:een yhteyttä kohden kuukaudessa, kun lisäät yhteyksiä. Ensimmäiset 3 päivää ilmaisia.

Usein kysytyt kysymykset

Pitääkö jokainen sivu tilata erikseen?

Kyllä. subscribed_apps toimii sivukohtaisesti sivun omalla tokenilla, kun taas sovellustason tilaus object=page-objektille koskee sovelluksen asentaneita sivuja.

Miksi subscribed_apps palauttaa virheen 200?

Meta ilmoittaa tämän päätepisteen oikeusvirheeksi koodilla 200. Tarkista, että tokenilla on pages_manage_metadata ja pages_show_list, ja että sen takana on henkilö, jolla on CREATE_CONTENT, MANAGE tai MODERATE.

Voiko sivun tilata Graph API Explorerista?

Kyllä. Metan opas valitsee sovelluksen, hakee käyttäjätokenin pages_manage_metadata-oikeudella, vaihtaa sen sivun tokeniksi ja lähettää POST-pyynnön osoitteeseen {page-id}/subscribed_apps.

Voinko lisätä webhook-kenttiä easyCoexistenceen yhdistettyyn sivuun?

Et työkaluillaan: mikään niistä ei yllä subscribed_apps-polkuihin, ja sivu pysyy tilattuna kenttiin feed, messages ja mention, jotka easyCoexistence välittää.

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