Webhook messaging_postbacks na Instagramie: ice breakery i przyciski
Pole webhooka messaging_postbacks Instagrama informuje aplikację, gdy osoba kliknie pytanie ice breaker, przycisk postback w szablonie albo pozycję stałego menu w rozmowie z kontem profesjonalnym. Obiekt postback zdarzenia zawiera title, czyli tekst, który osoba kliknęła; payload, czyli ciąg ustawiony przez aplikację dla tej opcji; oraz mid, identyfikator wiadomości, począwszy od Graph API v11.0.
easyCoexistence subskrybuje każde podłączone konto Instagram do pól comments, messages i mentions i przekazuje te zdarzenia, w tym kliknięcia szybkich odpowiedzi, na Twój endpoint HTTPS w chwili ich nadejścia, podpisane sekretem tego konta i bez przechowywania kopii.
Maksymalna liczba pytań ice breaker, jakie konto może ustawić przez Ice Breaker API Meta.
Wersja Graph API, od której zdarzenia postback zawierają mid; samo pole wymaga v8.0 lub nowszej.
Maksymalna liczba przycisków w szablonie z przyciskami, każdy typu postback lub web_url.
Czas na odpowiedź po kliknięciu pozycji stałego menu, która otwiera standardowe okno wiadomości.
Maksymalna liczba szybkich odpowiedzi w jednej wiadomości; kliknięta szybka odpowiedź trafia na messages, nie na messaging_postbacks.
Kiedy uruchamiane jest messaging_postbacks?
Gdy osoba kliknie jedną z gotowych opcji konta w rozmowie, pod warunkiem że aplikacja i konto są zasubskrybowane do tego pola. Przewodniki Meta wymieniają te źródła:
- Pytanie ice breaker, jedno z maksymalnie 4, które konto oferuje na początku rozmowy. Niedostępne na komputerze.
- Przycisk postback w szablonie z przyciskami, do 3 w jednej wiadomości, lub w ogólnym szablonie, do 3 w każdym elemencie.
- Pozycja postback w stałym menu konta.
- Ice breaker kliknięty w nowym wątku otwartym z linku ig.me z parametrem ref: wtedy postback zawiera także referral.
- Test wysyłania do samego siebie, w którym konto klika własny przycisk: zdarzenie dodaje
is_selfustawione na true.
Jak wygląda powiadomienie o postbacku?
Zdarzenie wiadomości z obiektem postback w miejscu, w którym zwykła wiadomość DM miałaby swoją zawartość. Przykład Meta dla Instagram Login zawiera mid, title i payload, a przewodnik po ice breakerach pokazuje ten sam obiekt bez mid. Powiadomienie wygląda tak:
{
"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>"
}
}
]
}
]
}Co oznacza każde pole?
Pola, które Meta dokumentuje dla postbacka, od zewnątrz do środka:
- sender.id: identyfikator Instagram-scoped osoby, która kliknęła, czyli ID, na który należy odpowiedzieć. recipient.id oraz entry[].id: konto profesjonalne.
- timestamp: moment kliknięcia według przewodnika Meta po ice breakerach.
- postback.title: pytanie ice breaker albo tytuł przycisku, który widziała osoba.
- postback.payload: ciąg ustawiony dla tej opcji w chwili jej tworzenia, wybrany przez aplikację.
- postback.mid: identyfikator wiadomości, którą kliknięcie wysłało na konto, od Graph API v11.0.
- postback.referral: ref, source i type, gdy wątek został otwarty z linku ig.me z parametrem ref.
is_self: ustawione na true obok postback, gdy konto klika własny przycisk w teście wysyłania do siebie.
Jak ustawia się ice breakery?
Przez POST /<IG_ID>/messenger_profile na graph.instagram.com: platform ustawiony na instagram oraz tablica ice_breakers, której call_to_actions zawiera do 4 par pytanie i payload, z locale dla każdego przetłumaczonego zestawu. GET /me/messenger_profile?fields=ice_breakers je wyświetla, a DELETE z fields ustawionym na ice_breakers usuwa. Payload wybrany tutaj to ten, który messaging_postbacks zwraca po kliknięciu pytania.
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>" }
]
}
]
}Jak wysyła się przyciski postback?
W wiadomości, którą konto wysyła przez POST /<IG_ID>/messages. Szablon z przyciskami zawiera tekst do 640 znaków oraz od 1 do 3 przycisków; ogólny szablon zawiera do 10 elementów, każdy z maksymalnie 3 przyciskami. Przycisk typu postback zwraca swój payload w messaging_postbacks po kliknięciu, a przycisk web_url zamiast tego otwiera stronę w przeglądarce w aplikacji. Stałe menu, ustawiane w messenger_profile, przyjmuje te same dwa typy.
Czy szybkie odpowiedzi używają messaging_postbacks?
Nie: trafiają na messages. Kliknięta szybka odpowiedź wysyła swój tytuł do rozmowy jako wiadomość, a zdarzenie messages zawiera text ustawiony na ten tytuł oraz quick_reply.payload ustawiony na payload opcji. Wiadomość może oferować do 13 szybkich odpowiedzi, każda do 20 znaków, wyłącznie zwykły tekst. Przewodnik Meta po Instagram Messaging wymienia też wybory ice breakera i ogólnego szablonu wśród tego, co raportuje messages, bez przykładu payloadu.
Czy kliknięcie otwiera okno wiadomości?
W przypadku stałego menu Meta mówi, że tak: kliknięcie pozycji menu otwiera standardowe okno wiadomości, a konto ma 24 godziny na odpowiedź. Odpowiedz przez POST /<IG_ID>/messages z recipient.id ustawionym na sender.id postbacka. Odpowiedź konta wraca na messages jako echo, z is_echo ustawionym na true.
Czy easyCoexistence przekazuje postbacki?
Tylko kliknięcia szybkich odpowiedzi. Trafiają na messages, do których subskrybowane są aplikacja easyCoexistence i każde połączone konto, więc docierają do Twojego endpointu wraz z quick_reply.payload. Kliknięcia ice breakerów, przycisków i pozycji menu trafiają na messaging_postbacks, do których easyCoexistence nie subskrybuje, więc nie są przekazywane.
Typowe błędy
- Oczekiwanie szybkich odpowiedzi w messaging_postbacks. Szybka odpowiedź trafia na messages, z quick_reply.payload obok tekstu wybranej opcji.
- Kierowanie ruchu po postback.title. Tytuł to to, co zobaczyła osoba, i może różnić się zależnie od locale; kieruj po payloadzie, który ustawia aplikacja.
- Oczekiwanie mid w starszej wersji API. Meta dołącza postback.mid dopiero od Graph API v11.0.
- Ustawianie więcej niż 4 ice breakerów lub testowanie ich na komputerze. Ice Breaker API Meta przyjmuje do 4 pytań, a funkcja nie jest dostępna na komputerze.
send_social_dm odpowiada osobie w 24-godzinnym oknie. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, im więcej połączeń, tym taniej, z pierwszymi 3 dniami bezpłatnie.
Najczęściej zadawane pytania
Które pole webhooka zgłasza kliknięcia ice breakerów w Instagramie?
messaging_postbacks. Obiekt postback zawiera pytanie jako title oraz ustawiony dla niego payload, a także mid od Graph API v11.0.
Ile ice breakerów może mieć konto Instagram?
Do 4 pytań, ustawianych przez POST /<IG_ID>/messenger_profile z platform ustawionym na instagram, opcjonalnie dla każdego locale.
Jak odpowiedzieć na postback w Instagramie?
Przez POST /<IG_ID>/messages z recipient.id ustawionym na sender.id postbacka, czyli identyfikator Instagram-scoped osoby, która kliknęła. Po kliknięciu pozycji stałego menu Meta daje kontu 24 godziny na odpowiedź.
Czy kierować postbacki Instagrama po title czy po payload?
Po payload, czyli ciągu ustawionym przez aplikację dla opcji. title to tekst, który widziała osoba, i może różnić się zależnie od locale.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w