Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Instagram messaging_postbacks webhook'u: ice breaker'lar ve düğmeler

Instagram'ın messaging_postbacks webhook alanı, bir kişi profesyonel bir hesapla olan bir konuşmada ice breaker sorusuna, bir şablondaki postback düğmesine veya kalıcı menü öğesine dokunduğunda uygulamayı bilgilendirir. Olayın postback nesnesi, kişinin dokunduğu metni içeren title, uygulamanın bu seçenek için ayarladığı dizgiyi içeren payload ve Graph API v11.0'dan itibaren mesaj kimliğini içeren mid bilgilerini taşır.

easyCoexistence, bağlı her Instagram hesabını yorumlara, mesajlara ve bahsetmelere abone eder ve bu olayları, hızlı yanıt dokunuşları dahil, geldikleri anda HTTPS uç noktanıza iletir; her olay o hesabın gizli anahtarıyla imzalanır ve hiçbir kopya saklanmaz.

4

Bir hesabın Meta'nın Ice Breaker API'si üzerinden ayarlayabildiği ice breaker sorularının çoğu.

v11.0

Postback olaylarında mid alanının bulunduğu Graph API sürümü; alanın kendisi v8.0 veya daha yeni bir sürüm gerektirir.

3

Bir button template mesajındaki düğmelerin çoğu; her biri postback veya web_url düğmesi.

24 hours

Kişi kalıcı menü öğesine dokunduktan sonra yanıt verme süresi; bu, standart mesajlaşma penceresini açar.

13

Bir mesajın sunabileceği en fazla hızlı yanıt; dokunulan hızlı yanıt messages alanına gelir, messaging_postbacks alanına değil.

messaging_postbacks ne zaman tetiklenir?

Uygulama ve hesap alana abone olduğunda, bir kişi bir konuşmada hesabın yapılandırılmış seçeneklerinden birine dokunduğunda tetiklenir. Meta'nın kılavuzları şu kaynakları listeler:

  • Konuşma başladığında hesabın sunduğu, en fazla 4 sorudan biri olan bir ice breaker sorusu. Masaüstünde kullanılamaz.
  • Button template içindeki bir postback düğmesi (mesaj başına en fazla 3) veya generic template içindeki bir postback düğmesi (öğe başına en fazla 3).
  • Hesabın kalıcı menüsündeki bir postback öğesi.
  • ref parametresi içeren bir ig.me bağlantısından açılan yeni bir konuşmada dokunulan ice breaker; bu durumda postback ayrıca referral bilgisini taşır.
  • Kendi kendine mesajlaşma testi; hesap kendi düğmesine dokunur. Olay, is_self alanını true olarak ekler.

Bir postback bildirimi nasıl görünür?

Bir DM'in mesajını taşıyacağı yerde, postback nesnesi içeren bir messaging olayı. Meta'nın Instagram Login için verdiği örnek mid, title ve payload taşır; ice breaker kılavuzu ise aynı nesneyi mid olmadan gösterir. Bildirim şöyle görünür:

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>"
          }
        }
      ]
    }
  ]
}

Her alan ne anlama gelir?

Meta'nın bir postback için belgelediği alanlar, dıştan içe doğru:

  • sender.id: dokunan kişinin Instagram kapsamlı kimliği, yani yanıt verilecek kimlik. recipient.id ve entry[].id: profesyonel hesap.
  • timestamp: Meta'nın ice breaker kılavuzuna göre kişinin dokunduğu an.
  • postback.title: kişinin gördüğü ice breaker sorusu veya düğme başlığı.
  • postback.payload: seçenek oluşturulurken uygulama tarafından belirlenen dizgi.
  • postback.mid: dokunuşun hesaba gönderdiği mesajın kimliği; Graph API v11.0'dan itibaren.
  • postback.referral: ref, source ve type; konuşma ref parametresi içeren bir ig.me bağlantısından açıldığında.
  • is_self: postback'in yanında, hesap kendi mesajlaşma testinde kendi düğmesine dokunduğunda true olarak ayarlanır.

Ice breaker'lar nasıl ayarlanır?

graph.instagram.com üzerinde POST /<IG_ID>/messenger_profile ile: platform değeri instagram, ice_breakers dizisi ise call_to_actions içinde en fazla 4 soru ve payload çifti tutar; her çeviri kümesi için bir locale eklenir. GET /me/messenger_profile?fields=ice_breakers ile listelenir, fields değeri ice_breakers olan bir DELETE ile kaldırılır. Burada seçilen payload, soruya dokunulduğunda messaging_postbacks'in döndürdüğü değerdir.

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>" }
      ]
    }
  ]
}

Postback düğmeleri nasıl gönderilir?

Hesabın POST /<IG_ID>/messages ile gönderdiği bir mesajın içinde. Button template en fazla 640 karakterlik bir text alanı ve 1 ila 3 düğme taşır; generic template ise her biri en fazla 3 düğme içeren en fazla 10 öğe taşır. postback tipindeki düğme, dokunulduğunda payload değerini messaging_postbacks üzerinden döndürür; web_url düğmesi ise bunun yerine uygulama içi tarayıcıda bir sayfa açar. messenger_profile üzerinde ayarlanan kalıcı menü aynı iki tipi kabul eder.

Hızlı yanıtlar messaging_postbacks kullanır mı?

Hayır: onlar messages alanına gelir. Dokunulan bir hızlı yanıt, başlığını konuşmada bir mesaj olarak gönderir; messages olayı, text alanını bu başlığa, quick_reply.payload alanını ise seçeneğin payload değerine ayarlanmış olarak taşır. Bir mesaj, her biri en fazla 20 karakterli ve yalnızca düz metin olan en fazla 13 hızlı yanıt sunabilir. Meta'nın Instagram Messaging kılavuzu, ice breaker ve generic template seçimlerini messages alanının bildirdikleri arasında sayar; ancak örnek bir payload vermez.

Bir dokunuş mesajlaşma penceresini açar mı?

Kalıcı menü için Meta bunu söyler: menü öğesine dokunmak standart mesajlaşma penceresini açar ve hesabın yanıt vermesi için 24 saati vardır. POST /<IG_ID>/messages ile yanıt verin ve recipient.id değerini postback'in sender.id değerine ayarlayın. Hesabın yanıtı, is_echo değeri true olarak, messages üzerinden echo olarak geri döner.

easyCoexistence postback'leri iletir mi?

Yalnızca hızlı yanıt dokunuşları. Bunlar, easyCoexistence'ın uygulamasının ve bağlı her Instagram hesabının abone olduğu messages alanına gelir; dolayısıyla quick_reply.payload ile birlikte uç noktanıza ulaşır. Ice breaker, düğme ve menü dokunuşları ise easyCoexistence'ın abone olmadığı messaging_postbacks alanına gelir; bu nedenle iletilmezler.

Yaygın hatalar

  • Hızlı yanıtları messaging_postbacks üzerinde beklemek. Hızlı yanıt messages alanına gelir; quick_reply.payload, dokunulan seçeneğin metniyle birlikte gelir.
  • postback.title üzerinden yönlendirme yapmak. Title, kişinin gördüğü metindir ve dile göre farklılık gösterebilir; yönlendirmeyi uygulamanın ayarladığı payload üzerinden yapın.
  • Eski bir API sürümünde mid beklemek. Meta, postback.mid alanını yalnızca Graph API v11.0'dan itibaren içerir.
  • 4'ten fazla ice breaker ayarlamak ya da masaüstünde test etmek. Meta'nın Ice Breaker API'si en fazla 4 soru kabul eder ve özellik masaüstünde kullanılamaz.
Bunu EasyCoexistence'la yapmak

send_social_dm, kişiye 24 saatlik pencere içinde yanıt verir. Bağlantı başına aylık US$ 9'dan US$ 0,75'e kadar, bağlantı eklendikçe düşen fiyatla; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Instagram ice breaker dokunuşlarını hangi webhook alanı bildirir?

messaging_postbacks. Postback nesnesi, soruyu title olarak ve ona atanan payload'ı taşır; ayrıca Graph API v11.0'dan itibaren mid de içerir.

Bir Instagram hesabının kaç ice breaker'ı olabilir?

En fazla 4 soru. POST /<IG_ID>/messenger_profile ile ve platform değeri instagram olacak şekilde ayarlanır; isteğe bağlı olarak locale bazında.

Bir Instagram postback'ine nasıl yanıt veririm?

POST /<IG_ID>/messages ile ve recipient.id değerini postback'in sender.id değerine ayarlayarak; sender.id, dokunan kişinin Instagram kapsamlı kimliğidir. Kalıcı menü dokunuşundan sonra Meta, hesaba yanıt vermesi için 24 saat tanır.

Instagram postback'lerini title mı yoksa payload mı üzerinden yönlendirmeliyim?

Payload üzerinden; uygulamanın seçenek için ayarladığı dizge. Title, kişinin gördüğü metindir ve dile göre farklılık gösterebilir.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi