IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Webhook ya Instagram messaging_postbacks: ice breakers na vitufe

Field ya messaging_postbacks ya Instagram humjulisha programu mtu anapogusa swali la ice breaker, kitufe cha postback kwenye template, au kipengee cha menyu ya kudumu katika mazungumzo na akaunti ya kitaalamu. Kitu cha postback kina title, maandishi aliyogusa mtu; payload, mfuatano ambao programu iliweka kwa chaguo hilo; na mid, kitambulisho cha ujumbe, kutoka Graph API v11.0.

easyCoexistence hujisajili kwa maoni, ujumbe na kutajwa kwa kila akaunti ya Instagram iliyounganishwa, na kupeleka matukio hayo, pamoja na kugusa kwa majibu ya haraka, kwenye endpoint yako ya HTTPS kadri yanavyofika, yakisainiwa kwa siri ya akaunti hiyo bila nakala yoyote kuhifadhiwa.

4

Idadi kubwa ya maswali ya ice breaker ambayo akaunti inaweza kuweka kupitia Ice Breaker API ya Meta.

v11.0

Toleo la Graph API ambalo matukio ya postback yanajumuisha mid; field yenyewe inahitaji v8.0 au zaidi.

3

Vitufe vingi katika ujumbe wa button template, kila kimoja ni kitufe cha postback au web_url.

24 hours

Muda wa kujibu baada ya mtu kugusa kipengee cha menyu ya kudumu, ambacho hufungua dirisha la kawaida la huduma kwa wateja.

13

Majibu mengi ya haraka ambayo ujumbe mmoja hutoa; jibu la haraka lililoguswa hufika kwenye messages, si kwenye messaging_postbacks.

Je, messaging_postbacks huwashwa lini?

Mtu anapogusa mojawapo ya chaguo zilizopangwa za akaunti katika mazungumzo, mara tu programu na akaunti zimejisajili kwenye field hiyo. Miongozo ya Meta inaorodhesha vyanzo hivi:

  • Swali la ice breaker, mojawapo ya manne ambayo akaunti hutoa mazungumzo yanapoanza. Halipatikani kwenye kompyuta ya mezani.
  • Kitufe cha postback kwenye button template, hadi 3 kwa ujumbe, au kwenye generic template, hadi 3 kwa kila kipengele.
  • Kipengee cha postback kwenye menyu ya kudumu ya akaunti.
  • Ice breaker iliyoguswa kwenye mazungumzo mapya yaliyofunguliwa kutoka kiungo cha ig.me chenye parameta ya ref: postback basi hubeba referral pia.
  • Jaribio la kujituma ujumbe, ambapo akaunti inagusa kitufe chake yenyewe: tukio linaongeza is_self ikiwekwa kuwa true.

Notisi ya postback inaonekanaje?

Tukio la messaging lenye kitu cha postback mahali ambapo DM ingekuwa na ujumbe wake. Mfano wa Meta kwa Instagram Login hubeba mid, title na payload, na mwongozo wake wa ice breaker unaonyesha kitu hicho hicho bila mid. Notisi inaonekana hivi:

A messaging_postbacks notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "postback": {
            "mid": "<MESSAGE_ID>",
            "title": "<ICE_BREAKER_QUESTION_OR_BUTTON_TITLE>",
            "payload": "<PAYLOAD_SET_FOR_THE_OPTION>"
          }
        }
      ]
    }
  ]
}

Kila sehemu inamaanisha nini?

Sehemu ambazo Meta inaandika kwa postback, kutoka nje kwenda ndani:

  • sender.id: kitambulisho cha Instagram cha mtu aliyegusa, ambacho ndicho cha kujibu. recipient.id na entry[].id: akaunti ya kitaalamu.
  • timestamp: wakati mtu aligusa, kulingana na mwongozo wa ice breaker wa Meta.
  • postback.title: swali la ice breaker au kichwa cha kitufe alichokiona mtu.
  • postback.payload: mfuatano uliowekwa kwa chaguo hilo wakati lilipoundwa, uliochaguliwa na programu.
  • postback.mid: kitambulisho cha ujumbe ambao kugusa kulituma kwa akaunti, kutoka Graph API v11.0.
  • postback.referral: ref, source na type, wakati mazungumzo yalifunguliwa kutoka kiungo cha ig.me chenye parameta ya ref.
  • is_self: imewekwa kuwa true, karibu na postback, akaunti inapogusa kitufe chake katika jaribio la kujituma ujumbe.

Ice breakers zinawekwaje?

Kwa POST /<IG_ID>/messenger_profile kwenye graph.instagram.com: platform imewekwa kuwa instagram, na array ya ice_breakers ambayo call_to_actions zake zina jozi hadi 4 za swali na payload, pamoja na locale kwa kila seti iliyotafsiriwa. GET /me/messenger_profile?fields=ice_breakers huorodhesha, na DELETE yenye fields iliyowekwa kuwa ice_breakers huziondoa. Payload iliyochaguliwa hapa ndiyo messaging_postbacks inayorudisha swali linapoguswa.

Setting two ice breakers
POST https://graph.instagram.com/<IG_ID>/messenger_profile?access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "platform": "instagram",
  "ice_breakers": [
    {
      "call_to_actions": [
        { "question": "<QUESTION_1>", "payload": "<PAYLOAD_1>" },
        { "question": "<QUESTION_2>", "payload": "<PAYLOAD_2>" }
      ]
    }
  ]
}

Vitufe vya postback vinatumwaje?

Ndani ya ujumbe ambao akaunti hutuma kwa POST /<IG_ID>/messages. Button template hubeba maandishi ya hadi herufi 640 na vitufe 1 hadi 3; generic template hubeba hadi vipengele 10, kila kimoja na vitufe hadi 3. Kitufe cha aina ya postback hurudisha payload yake kwenye messaging_postbacks kinapoguswa, huku kitufe cha web_url kikifungua ukurasa kwenye kivinjari cha ndani ya programu. Menyu ya kudumu, iliyowekwa kwenye messenger_profile, inakubali aina hizo mbili.

Je, majibu ya haraka hutumia messaging_postbacks?

Hapana: hufika kwenye messages. Jibu la haraka lililoguswa huweka kichwa chake kwenye mazungumzo kama ujumbe, na tukio la messages hubeba text sawa na kichwa hicho na quick_reply.payload sawa na payload ya chaguo. Ujumbe mmoja unaweza kutoa majibu ya haraka hadi 13, kila moja hadi herufi 20, maandishi matupu pekee. Mwongozo wa Meta wa Instagram Messaging pia unaorodhesha uteuzi wa ice breaker na generic template miongoni mwa vitu ambavyo messages huripoti, bila mfano wa payload.

Je, kugusa hufungua dirisha la huduma kwa wateja?

Kwa menyu ya kudumu, Meta inasema hivyo: kugusa kipengee cha menyu hufungua dirisha la kawaida la huduma kwa wateja, na akaunti ina saa 24 kujibu. Jibu kwa POST /<IG_ID>/messages na recipient.id iliyowekwa kuwa sender.id ya postback. Jibu la akaunti hurudi kwenye messages kama echo, ikiwa is_echo imewekwa kuwa true.

Je, easyCoexistence inatuma postback?

Majibu ya haraka pekee. Yanafika kwenye messages, ambayo programu ya easyCoexistence na kila akaunti iliyounganishwa zimejisajili nayo, kwa hiyo yanafikia endpoint yako pamoja na quick_reply.payload yao. Kugusa ice breaker, vitufe na menyu hufika kwenye messaging_postbacks, ambayo easyCoexistence haijisajili nayo, kwa hiyo hayasambazwi.

Makosa ya kawaida

  • Kusubiri majibu ya haraka kwenye messaging_postbacks. Jibu la haraka hufika kwenye messages, na quick_reply.payload kando ya maandishi ya chaguo lililoguswa.
  • Kuelekeza kwa postback.title. Kichwa ndicho mtu alichokiona na kinaweza kutofautiana kwa locale; elekeza kwa payload, ambayo programu huiweka.
  • Kutarajia mid kwenye toleo la zamani la API. Meta inajumuisha postback.mid kuanzia Graph API v11.0 pekee.
  • Kuweka ice breakers zaidi ya 4, au kuzijaribu kwenye kompyuta ya mezani. Ice Breaker API ya Meta inakubali hadi maswali 4, na kipengele hakipatikani kwenye kompyuta ya mezani.
Kufanya hili ukitumia EasyCoexistence

send_social_dm hujibu mtu ndani ya dirisha la saa 24. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, bei ikishuka kadri unavyoongeza muunganisho, na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Ni field gani ya webhook huripoti kugusa ice breaker za Instagram?

messaging_postbacks. Kitu cha postback hubeba swali kama title na payload iliyowekwa kwake, pamoja na mid kutoka Graph API v11.0.

Akaunti ya Instagram inaweza kuwa na ice breakers ngapi?

Hadi maswali 4, yanawekwa kwa POST /<IG_ID>/messenger_profile na platform imewekwa kuwa instagram, hiari kwa kila locale.

Nawezaje kujibu postback ya Instagram?

Kwa POST /<IG_ID>/messages, ukiweka recipient.id kuwa sender.id ya postback, yaani kitambulisho cha Instagram cha mtu aliyegusa. Baada ya kugusa menyu ya kudumu, Meta inaipa akaunti saa 24 za kujibu.

Je, nielekeze postback za Instagram kwa title au payload?

Kwa payload, mfuatano ambao programu iliweka kwa chaguo. title ni maandishi ambayo mtu aliyaona, na yanaweza kutofautiana kwa locale.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye