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

Messenger-profiilin API: tervehdys, Get Started -painike, jäänrikkojat ja pysyvä valikko

Facebook-sivun Messenger-profiili asetetaan päätepisteen /{page-id}/messenger_profile kautta. Käytössä on sivun käyttöoikeustunnus ja oikeus pages_messaging. POST kirjoittaa ominaisuuksia, kuten get_started, greeting, ice_breakers, persistent_menu ja commands, GET lukee ne fields-parametrilla ja DELETE poistaa fields-taulukossa nimetyt. Meta sallii 10 kutsua 10 minuutissa sivua kohden, ja vain lähetetyt ominaisuudet korvataan.

easyCoexistence vastaa sivun Messenger-keskusteluihin send_social_dm-työkalulla 24 tunnin ikkunassa, Claudesta, ChatGPT:stä tai omasta koodistasi, ja uudet viestit välitetään endpointiisi saapuessaan.

10 per 10 min

Messenger Profile API -kutsuja sallitaan sivua kohden jokaisella 10 minuutin välillä.

4 questions

Enimmäismäärä jäänrikkojia, jotka API voi asettaa. Kun molemmat on asetettu, API-jäänrikkojat ovat etusijalla Get Started -painikkeeseen nähden.

20 items

Enimmäismäärä ylimmän tason kohteita pysyvässä valikossa. Kunkin kohteen otsikko on rajattu 30 merkkiin.

24 hours

Kuinka kauan sivutason pysyvän valikon päivitys voi kestää. Yhdelle ihmiselle asetettu valikko päivittyy reaaliajassa.

Deprecated

Tervehdysteksti, joka Metan greeting-ohjeen mukaan ei enää toimi Messengerissä Androidilla eikä iOS:llä.

Mitä Messenger-profiili sisältää?

Asetukset, joista sivun Messenger-kokemus lähtee liikkeelle. Metan Messenger Profile API listaa nämä ominaisuudet, ja jokainen asetetaan ja luetaan samasta päätepisteestä. Sovelluksella, joka on kehitystilassa, asetukset näkyvät vain ihmisille, joilla on rooli sovelluksessa:

get_startedThe payload sent as a messaging_postbacks event when someone taps Get Started
greetingLocale-specific welcome screen text, which Meta marks deprecated as of November 2026
ice_breakersUp to 4 questions a person can tap to start the conversation
persistent_menuUp to 20 buttons kept in the conversation, per locale
commandsKeywords a person can tap or type, each with a description
whitelisted_domainsUp to 50 HTTPS domains for the Messenger Extensions SDK and the checkbox plugin
account_linking_urlThe HTTPS callback for linking a person's account with the business
subject_to_new_eu_privacy_rulesRead-only flag for Pages affected by Meta's Messenger API updates for Europe

Miten ominaisuuksia luetaan, asetetaan ja poistetaan?

Kolmella metodilla samassa päätepisteessä, sivun tunnuksella. POST ottaa JSON-rungon ominaisuuksista ja korvaa vain ne, jotka nimetään. GET ottaa fields-arvon pilkulla erotettuna listana, ja DELETE ottaa JSON-rungon, jonka fields-taulukko nimeää poistettavat. POST ja DELETE vastaavat result success. Get Started -painikkeen ja valikon asettaminen yhdellä kutsulla:

Get Started and a persistent menu in one POST
POST /{page-id}/messenger_profile
{
  "get_started": { "payload": "GET_STARTED" },
  "persistent_menu": [
    {
      "locale": "default",
      "composer_input_disabled": false,
      "call_to_actions": [
        { "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
        { "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
      ]
    }
  ]
}

{ "result": "success" }

Miten Get Started -painike toimii?

Se on tervetulonäytössä, joka näyttää sivun nimen, profiilikuvan ja kansikuvan sekä sen, kuinka kauan yritys yleensä vastaa. Napautus lähettää Get Started -viestin keskusteluun, lähettää get_started.payload-arvon sovellukselle messaging_postbacks-tapahtumana ja avaa tavallisen viestiikkunan. Meta huomauttaa, ettei painiketta tueta, kun Messenger toimii Facebook-sovelluksen sisäisessä selaimessa, ja pysyvä valikko vaatii, että painike on ensin asetettu.

Toimiiko tervehdysteksti vielä?

Ei puhelimilla. Metan ohje on nyt nimeltään [Deprecated] Greeting Text: ominaisuus ei enää toimi Messengerissä Androidilla eikä iOS:llä. API saattaa yhä hyväksyä greeting-ominaisuuden, mutta asiakkaat eivät näe sitä, joten Meta pyytää kehittäjiä välttämään sitä. Dokumentoidusti greeting sisältää yhden tekstin kieltä kohden, oletuskieli vaaditaan, teksti voi olla enintään 160 merkkiä ja sitä voi personoida muuttujilla {{user_first_name}}, {{user_last_name}} tai {{user_full_name}}. Asettaminen vaatii sivun ylläpitäjän roolin.

Miten jäänrikkojat toimivat?

Ne listaavat enintään 4 kysymystä, joita ihminen voi napauttaa avatakseen keskustelun. Kysymys lähetetään ketjuun ikään kuin ihminen olisi kysynyt sen, ja sen payload palautuu postback-tapahtumana. Huhtikuusta 2022 alkaen ne ovat lokalisoituja: jokainen ice_breakers-objekti sisältää call_to_actions- ja locale-kentät, oletuskieli vaaditaan, ja ice_breakers-kentän DELETE-kutsu poistaa ne kaikki. Meta järjestää uusien keskustelujen kilpailevat elementit seuraavasti:

  • API-jäänrikkojat ovat etusijalla Get Started -painikkeeseen nähden, kun molemmat on asetettu.
  • Molemmat tulevat ennen Sivun postilaatikossa asetettuja mukautettuja kysymyksiä, ja niiden muokkaus on pois käytöstä, kun API-jäänrikkojat ovat asetettuina.

Miten pysyvä valikko rakennetaan?

Menuina, taulukkona, jossa on yksi valikko kieltä kohden ja oletuskieli vaadittuna. Jokainen sisältää enintään 20 call_to_actions-kohdetta tyyppiä web_url tai postback. Otsikko saa olla enintään 30 merkkiä ja postback-payload enintään 1 000. Kun composer_input_disabled on asetettu arvoon true, valikko, painikkeet ja webview-näkymät jäävät ainoaksi vuorovaikutustavaksi. Metan vaatimukset ennen kuin valikko ilmestyy:

  • Get Started -painike on jo asetettu ja käytössä on oikeus pages_messaging.
  • Sivu on julkaistu ja sovellus on asetettu julkiseksi.
  • Sivun ylläpitäjän rooli sille, joka asettaa valikon.
  • Messenger v106 tai uudempi iOS:llä tai Androidilla, Facebook-sovelluksen sisäisen selaimen ulkopuolella.
  • Sivutason muutokset voivat kestää jopa 24 tuntia. Yhdelle ihmiselle asetettu valikko custom_user_settings-kentän kautta PSID-tunnuksella päivittyy reaaliajassa.

Mitä komennot ovat?

Avainsanoja, joita ihminen voi kutsua milloin tahansa kirjoittamisalueen vieressä olevasta komentovalikosta kirjoittamalla vinoviivan tai at-merkin, tai ponnahdusikkunasta, kun hän kirjoittaa vastaavan sanan. Jokaisella kielellä on 1–100 komentoa. Nimi on 1–32 merkkiä ilman alkuvinoviivaa ja kuvaus 1–64 merkkiä. Kun komennot on asetettu, ne menevät pysyvän valikon edelle. Kutsutut komennot saapuvat sovellukseen messages-tapahtuman sisällä kohdassa message.commands.

Mitä whitelisted_domains ja account_linking_url tekevät?

Molemmat palvelevat kokemuksia keskustelun ulkopuolella. whitelisted_domains listaa enintään 50 domainia, joita Messenger-webview saa avata Messenger Extensions SDK:lle ja checkbox-liitännäiselle. Jokaisen täytyy olla palveltu HTTPS:llä täysin määritellyllä domain-nimellä, ei koskaan IP-osoitteena tai localhostina, ja sen asettaminen vaatii sivun ylläpitäjän roolin. account_linking_url on HTTPS-takaisinkutsu, joka yhdistää ihmisen Messenger-tilin hänen tiliinsä yrityksen kanssa.

Miten easyCoexistence asettaa Facebook-sivun Messenger-profiilin?

Ei: mikään työkalu ei kutsu polkua {page-id}/messenger_profile, eikä sivun tokeneita luovuteta, joten profiilin asettaminen jää tämän yhteyden ulkopuolelle. Komennot, joita ihmiset kutsuvat, saapuvat messages-tapahtumassa, jonka easyCoexistence välittää ja automaatiot lukevat. Napautukset, jotka Meta raportoi messaging_postbacks-tapahtumina Get Started -painikkeesta, postback-valikon kohdista ja jäänrikkojista, eivät välity, koska sivut ovat tilattuina tapahtumiin feed, messages ja mention.

Yleiset virheet

  • Pysyvän valikon asettaminen ennen Get Started -painiketta. Metan vaatimuksiin kuuluu Get Started -painike, joten aseta get_started ensin.
  • Oletuskielen unohtaminen. Jäänrikkojat, valikot ja komennot tarvitsevat kukin objektin, jonka locale on default, varakieleksi.
  • Messenger Profile API:n kutsuminen silmukassa. Meta sallii 10 kutsua 10 minuutissa sivua kohden, joten yhdistä useat ominaisuudet yhteen POST-kutsuun.
  • Odotetaan valikon muutosta heti. Sivutason valikon päivitys voi kestää jopa 24 tuntia ennen kuin se näkyy ihmisille.
Näin teet tämän EasyCoexistencen avulla

Messenger-profiilin asettaminen ei kuulu sen työkaluihin. US$ 9:stä alkaen, laskien US$ 0.75:een yhteyttä kohden kuukaudessa, kun yhteyksiä lisätään, ja ensimmäiset 3 päivää ovat ilmaista kokeilua.

Usein kysytyt kysymykset

Voiko pysyvä valikko vaihdella ihmisittäin?

Kyllä. custom_user_settings-kenttä ihmisen PSID:llä ohittaa sivun valikon kyseiselle ihmiselle, päivittyy reaaliajassa ja sallii 10 kutsua 10 minuutissa ihmistä kohden.

Mitä kieliä Messenger-profiili tukee?

Metan tukemien kielten listan kielet, kuten en_GB, pt_BR tai ja_JP, sekä default, varakieli, jota käytetään, kun mikään kieli ei vastaa ihmisen kieltä.

Kuka voi muuttaa Facebook-sivun Messenger-profiilia?

Sovellus, jolla on sivun tunnus ja oikeus pages_messaging. Pysyvä valikko, tervehdysteksti ja domain-lista vaativat myös sivun ylläpitäjän roolin.

Paljonko easyCoexistence maksaa Facebook-sivulle?

Jokainen sivu on yksi yhteys: US$ 9:stä alkaen, laskien US$ 0.75:een yhteyttä kohden kuukaudessa, kun yhteyksien määrä kasvaa. Ensimmäiset 3 päivää ovat ilmaista kokeilua.

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