Facebook-maininnan webhook: kun joku mainitsee sivusi
Facebook-sivun webhookin mention-kenttä ilmoittaa sovellukselle, kun joku @mainitsee sivun julkaisussa tai kommentissa. Meta lähettää muutoksen, jonka kenttä on mention ja jonka arvo voi sisältää kentät post_id ja kommentissa comment_id, viestin tekstin kentässä message, liitetyt linkit ja media sekä kentät item ja verb. Pyyntö on POST-pyyntö, joka on allekirjoitettu otsakkeen X-Hub-Signature-256 avulla.
easyCoexistence tilaa jokaisen yhdistämäsi sivun mention-kentän feedin ja viestien rinnalla ja välittää maininta-tapahtumat HTTPS-päätepisteeseesi heti, kun ne saapuvat.
Sivun webhook-kenttä uusille maininnoille, mukaan lukien maininnat kommenteissa ja julkaisuissa.
Käyttöoikeus, jonka sivun ylläpitäjän, jolla on MODERATE-oikeudet, täytyy myöntää ennen kuin sivun webhookit tavoittavat sovelluksen callback-URL-osoitteen.
Miten ihmiset mainitsevat sivun julkaisussa tai kommentissa: kirjoitetaan @ ja sivun nimi, ja valitaan se.
Kuinka pitkään Meta yrittää uudelleen epäonnistunutta sivu-ilmoitusta, yhä harvemmin, ennen kuin se hylätään.
Kenttä, jonka /{page-id}/tagged-reuna lisää jokaiseen julkiseen julkaisuun, johon sivu on merkitty.
Mikä laukaisee maininta-webhookin?
Joku mainitsee sivun julkaisussa tai kommentissa. Facebookissa maininta tehdään kirjoittamalla @ ja sivun nimi ja valitsemalla se ehdotuksista. Metan viitteessä kenttä kuvataan sivun uusina mainintoina, mukaan lukien maininnat kommenteissa ja julkaisuissa. Facebookin ohjekeskuksen mukaan sivun asetukset voivat estää ihmisiä mainitsemasta sivua.
Miltä maininta-ilmoitus näyttää?
POST-pyyntö, jossa object on page ja yksi entry mainitulle sivulle: sen ID, aika ja changes-taulukko, jonka field on mention. Metan viitteessä luetellaan arvon kentät, mutta esimerkkiä ei anneta, joten alla oleva esimerkki julkaisun maininnasta on muodostettu tuon listan perusteella:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1793520000,
"changes": [
{
"field": "mention",
"value": {
"item": "post",
"verb": "add",
"post_id": "<POST_ID>",
"message": "<TEXT_WITH_THE_MENTION>"
}
}
]
}
]
}Mitä kukin maininnan kenttä tarkoittaa?
Nämä ovat arvon kentät Metan viitteessä. Mitkä niistä ilmoitus sisältää, riippuu julkaisusta tai kommentista:
post_id: sen julkaisun ID, joka mainitsi sivun.comment_id: kommentin ID, kun maininta on kommentissa;parent_id: sen vanhemman ID.- message: teksti, joka sisältää maininnan.
- link, photo, photos ja video: linkit siihen, mitä julkaisu tai kommentti on liittänyt.
- item ja verb: kohteen tyyppi ja se, mitä sille tapahtui, samoista listoista kuin feed-kenttä käyttää.
created_time: milloin julkaisu tai kommentti luotiin.- from ja
message_tags: kirjoittaja ja tekstissä merkityt profiilit, molemmat merkitty vain Workplacelle. - Myös listattu: action,
album_id,event_id,photo_id,video_id,share_id, published,reaction_type,recipient_idjaopen_graph_story_id.
Mikä käyttöoikeus maininta-kenttä tarvitsee?
pages_manage_metadata, jonka Meta vaatii sivun ylläpitäjältä, jolla on MODERATE-oikeudet, myöntämään ennen kuin sivun webhookit tavoittavat sovelluksen. Sivu tilataan POST /{page-id}/subscribed_apps -kutsulla, jossa subscribed_fields sisältää mention, käyttäen sivun tokenia henkilöltä, jolla on CREATE_CONTENT-, MANAGE- tai MODERATE-tehtävä, ja oikeuksilla pages_manage_metadata ja pages_show_list. Sovellus tilaa mention-kentän myös itse, sillä vain molemmilla tasoilla tilatut kentät toimitetaan. Sivut, joita ylläpitävät ihmiset, joilla ei ole roolia sovelluksessa, tarvitsevat nämä oikeudet Advanced Access -tasolla.
Miten luet maininnan sisältävän julkaisun tai kommentin?
Sen ID:llä sivun tokenilla, kun Meta sallii sen. Sivun token lukee sivulle tai sivun toimesta julkaistuja julkaisuja. Muiden sivujen julkisesti jakamat julkaisut vaativat oikeuden pages_manage_posts ja ominaisuuden Page Public Content Access, tokenilla sivun ylläpitäjältä. Metan mukaan henkilön oman julkaisun lukeminen liittyy henkilön user_posts-oikeuteen.
GET https://graph.facebook.com/<POST_ID>
?fields=message,permalink_url,created_time
&access_token=<PAGE_ACCESS_TOKEN>
GET https://graph.facebook.com/<COMMENT_ID>
?fields=message,from,created_time
&access_token=<PAGE_ACCESS_TOKEN>Mistä muualta sivu löytää maininnat?
Tagged-reunassa. GET /{page-id}/tagged listaa julkiset julkaisut, joihin sivu on merkitty. Jokaisessa on tagged_time, ja lista kattaa myös julkaisut ennen webhookin asettamista. Se vaatii sivun tokenin henkilöltä, jolla on CREATE_CONTENT-, MANAGE- tai MODERATE-tehtävä, oikeuksilla pages_read_user_content ja pages_show_list, ja Meta sanoo, että ominaisuus Page Public Content Access voi olla tarpeen. Henkilön omasta julkaisusta Meta palauttaa tiedot vain sille henkilölle, joka sen kirjoitti.
Miten easyCoexistence välittää maininta-tapahtumat?
Se tilaa jokaisen sivun maininnan kentälle feedin ja viestien rinnalla, kun sivu yhdistetään. Sen sovellus tarkistaa otsakkeen X-Hub-Signature-256 jokaisesta toimituksesta, vastaa Metalle heti ja POSTaa jokaisen sivun entryn muuttumattomana HTTPS-päätepisteeseesi, jonka asetat set_social_webhook_destination- tai PUT /channels/:id/webhook -kutsulla Partner API:ssa:
- X-EC-Signature sisältää t=<unix>,v1=<hex>: aikaleiman, pisteen ja raakarungon HMAC-SHA256, avaimena sivun allekirjoitussalaisuus.
- Salaisuus alkaa whsec_-etuliitteellä ja näytetään kerran. URL-osoitteen asettaminen uudelleen luo uuden salaisuuden, ja null-URL lopettaa välittämisen.
- Jokainen entry lähtee kerran, odottaen enintään 8 sekuntia, julkiseen IP-osoitteeseen ratkeavaan HTTPS-osoitteeseen, ilman uudelleenohjauksia ja ilman, että mitään kopiota säilytetään.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793520000,
"changes": [
{
"field": "mention",
"value": {
"item": "post",
"verb": "add",
"post_id": "<POST_ID>",
"message": "<TEXT_WITH_THE_MENTION>"
}
}
]
}
}Yleiset virheet
- Kentän entry.time tulkitseminen maininnan ajankohdaksi. Meta asettaa sen ilmoituksen lähetyshetkeen, ja value-kentän created_time kertoo julkaisun tai kommentin luontiajan.
- Epäonnistuneen haun pitäminen rikkoutuneena tapahtumana. Meta varoittaa, että joitakin post_id- ja comment_id-arvoja maininta-ilmoituksissa ei voi kysyä käyttöoikeuden tai yksityisyyden takia, joten säilytä viestin teksti itse tapahtumasta.
- Julkaisun hakeminen ennen vastausta välitykselle. Välityksiä ei yritetä uudelleen, joten palauta 2xx heti ja hae julkaisu myöhemmin.
Ne on allekirjoitettu sivukohtaisella salaisuudella, eikä kopiota säilytetä, joten agenttisi tietää jokaisesta maininnasta sen tapahtuessa. Alkaen US$ 9 per yhteys kuukaudessa, laskien US$ 0,75:een yhteyksiä lisättäessä, ensimmäiset 3 päivää ilmaiseksi.
Usein kysytyt kysymykset
Kertooko maininta-webhook, kuka mainitsi sivun?
Ei sivun kohdalla: Metan viitteen mukaan from-kenttä on vain Workplacelle. Julkaisun tai kommentin haku sen ID:llä voi palauttaa kirjoittajan, jos Metan käyttöoikeudet sen sallivat.
Voinko saada maininnat ennen kuin sivu tilattiin?
Et webhookista, koska Meta ei säilytä ilmoitushistoriaa, jota voisi kysellä. Tagged-reuna listaa julkiset julkaisut, joihin sivu on merkitty.
Miten maininta-kenttä eroaa feedistä?
feed kertoo muutoksista sivun omassa feedissä, kuten julkaisuista, kommenteista ja reaktioista siellä. mention kertoo, että sivu on mainittu @-merkinnällä julkaisussa tai kommentissa. Kumpikin kenttä tilataan erikseen.
Vaikuttavatko easyCoexistencen kommenttisäännöt maininnoihin?
Eivät. Säännöt ja automaatiot koskevat feed-kentän kommentteja ja Messengerin viestejä. Maininta-muutokset välitetään päätepisteeseesi juuri sellaisina kuin Meta ne lähetti.
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