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

Facebook-sivun feed-webhook: kommentti-, julkaisu- ja reaktiotapahtumat

Facebookin sivu-webhookien feed-kenttä ilmoittaa lähes kaikista sivun syötteen muutoksista heti niiden tapahtuessa. Jokaisella muutoksella on item, esimerkiksi julkaisu, kommentti tai reaktio, ja verb, esimerkiksi add, edit tai remove, sekä mukana olevat tunnisteet, lähettäjä from ja teksti message. Meta lähettää sen JSON-muodossa, allekirjoitettuna X-Hub-Signature-256-otsakkeella.

easyCoexistence tilaa jokaisen yhdistämäsi sivun feed-kentän ja välittää sen muutokset HTTPS-endpointiisi heti, kun ne saapuvat, allekirjoitettuina kunkin sivun salaisuudella.

10K likes

Syötteen ilmoituksia sivun tykkäyksistä lähetetään vain sivuille, joilla on vähemmän tykkäyksiä kuin tässä mainittu raja.

Ad posts

Syöte ei lähetä mitään itse mainospostauksista, mutta lähettää niiden kommentit.

pages_manage_metadata

Sivun ylläpitäjän, jolla on MODERATE-oikeudet, on myönnettävä lupa, jotta sivun webhookit tavoittavat sovelluksen.

1,000

Meta yhdistää useimmat päivitykset yhdeksi webhook-toimitukseksi, mutta yhdistämistä ei taata.

36 hours

Kuinka pitkään Meta yrittää uudelleen epäonnistunutta toimitusta sovelluksen endpointiin, yhä harvemmin.

Mitä feed-kenttä ilmoittaa?

Lähes kaikki sivun syötteen muutokset Metan luettelon mukaan, kuten julkaisut, kommentit, reaktiot ja jaot. Se, mitä muutos sisältää, riippuu sen tyypistä. Meta ei lähetä mitään itse mainospostauksista, mutta mainospostauksiin tulleet kommentit saapuvat. Tykkäysilmoituksia Meta lähettää vain silloin, kun sivulla on alle 10 000 tykkäystä.

Mitä item ja verb tarkoittavat?

Kahdella kentällä jokaisen muutoksen arvossa kerrotaan, mitä tapahtui:

  • item: mikä muuttui Metan luettelosta, johon kuuluvat post, status, photo, video, link, share, comment, reaction ja album.
  • verb: mitä muutokselle tapahtui: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute tai update.
  • Uusi kommentti saapuu item-arvolla comment ja verb-arvolla add. Juuri sitä kommentista DM:ksi -säännöt etsivät.
  • Reaktio kantaa mukanaan item-arvon reaction ja reaction_type-kentän, joka nimeää sen.

Miltä feed-muutos näyttää?

POST-pyyntö, jonka JSON-sisällössä object on page ja jokaisessa entry-kohdassa on sivun tunnus, aika sekä taulukko changes-muutoksista. Tämä on Metan oma esimerkki, jossa henkilö julkaisee sivulle:

A feed change, as Meta sends it
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1520544816,
      "changes": [
        {
          "field": "feed",
          "value": {
            "from": { "id": "<USER_ID>", "name": "<NAME>" },
            "item": "post",
            "post_id": "<PAGE_POST_ID>",
            "verb": "add",
            "created_time": 1520544814,
            "is_hidden": false,
            "message": "<POST_TEXT>"
          }
        }
      ]
    }
  ]
}

Mitä kenttiä muutoksella voi olla?

Metan viitteessä luetellaan feed-muutoksen value-kentän kenttiä, jotka ovat mukana muutostyypistä riippuen:

  • post_id, comment_id ja parent_id: julkaisu, kommentti ja se, mihin kommentti kuuluu.
  • from: sen tekijän tunnus ja nimi, joka teki muutoksen.
  • message: teksti, ja link, photo, photos tai video liitetylle sisällölle.
  • created_time sekä edited_time muokkauksille.
  • reaction_type reaktioille ja is_hidden sille, onko julkaisu piilotettu.
  • post: tiedot kuten status_type, is_published, updated_time ja permalink_url.

Miten sivu tilataan?

Sovellus lähettää POST-pyynnön osoitteeseen /{page-id}/subscribed_apps kentällä subscribed_fields=feed ja sivun tokenilla. Pyynnön lähettää henkilö, jolla on CREATE_CONTENT-, MANAGE- tai MODERATE-tehtävä, ja tekijällä on oltava oikeudet pages_manage_metadata ja pages_show_list. Meta lähettää ilmoituksia vain niin kauan kuin sivulla on sovellus asennettuna eikä sovellusalustaa ole poistettu käytöstä sivun asetuksista. easyCoexistence tilaa jokaisen sivun feed-, messages- ja mention-kenttiin, kun se yhdistetään.

Miten feed-tapahtumat saapuvat endpointiisi?

Meta toimittaa ne easyCoexistencen sovellukseen, joka tarkistaa X-Hub-Signature-256-allekirjoituksen, vastaa Metalle heti ja välittää jokaisen yhdistetyn sivun merkinnän sille asettamaasi HTTPS-endpointiin. Välitykseen liitetään X-EC-Signature-otsake, eli HMAC-SHA256 aikaleimasta ja raakasisällöstä, avaimena kyseisen sivun salaisuus. Välitys lähtee kerran, eikä kopiota säilytetä eikä yrityksiä uudelleen tehdä. Aseta endpoint funktiolla set_social_webhook_destination tai Partner API:n PUT /channels/:id/webhook-pyynnöllä.

Mitkä feed-muutokset käynnistävät kommenttisäännöt ja automaatiot?

Vain uudet kommentit: muutos, jossa item on comment ja verb add, sivun jollakin julkaisulla. Comment-to-DM -säännöt tarkistavat sen viestin avainsanat ja ohittavat sivun itse tekemät kommentit, ja automaatiot ottavat ne kommentit, joihin mikään sääntö ei ole vastannut. Muokkaukset, piilotukset, reaktiot ja julkaisut menevät suoraan endpointiisi, jos olet asettanut sellaisen.

Yleiset virheet

  • Kaiken feed-muutoksen käsitteleminen uutena kommenttina. Tarkista item ja verb: reaktiot, muokkaukset, piilotukset ja poistot tulevat samalle kentälle.
  • Sivun omiin kommentteihin vastaaminen. Sivun vastaukset tulevat takaisin myös feed-muutoksina, joten ohita ne, joiden from.id on sivun tunnus.
  • Oletus, että yhdessä toimituksessa on yksi muutos. Meta voi yhdistää jopa 1 000 päivitystä, joten käy läpi jokainen entry ja jokainen sen muutos.
  • entry.time-kentän lukeminen muutoksen tapahtumahetkeksi. Meta asettaa sen ilmoituksen lähetyshetkeen, ja value-kentän created_time on hetki, jolloin kohde luotiin.
Näin teet tämän EasyCoexistencen avulla

Kommenttisäännöt ja automaatiot toimivat uusiin kommentteihin. Hinta on US$ 9 yhteydeltä kuukaudessa ja laskee US$ 0,75:een, kun yhteyksiä lisätään. Ensimmäiset 3 päivää ovat ilmaisia.

Usein kysytyt kysymykset

Sisältääkö feed-webhook kommentit?

Kyllä. Uusi kommentti saapuu feed-muutoksena, jonka item on comment ja verb add. Siinä ovat comment_id, post_id, from ja message.

Saanko sivun tykkäyksistä webhookit?

Vain sivuilta, joilla on alle 10 000 tykkäystä, Metan sivu-webhookien viitteen mukaan.

Ovatko mainospostaukset feed-webhookissa?

Eivät itse mainospostaukset, mutta niiden kommentit lähetetään.

Tarvitsenko oman Meta-sovelluksen sivun feed-tapahtumiin?

Et. Meta toimittaa ne easyCoexistencen sovellukseen, joka välittää jokaisen endpointiin, jonka olet asettanut kyseiselle sivulle.

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