Jak używać Webhooks API Instagrama do powiadomień w czasie rzeczywistym?

E

Wprowadzenie

E

Webhook API Instagram

E

Przegląd Webhooks

E

Konfiguracja z Unipile

E

Zdarzenia webhook na Instagramie

E

Zarządzanie wieloma kontami na Instagramie

E

Webhooki z Instagrama

E

Punkty końcowe API Instagrama

E

Wnioski

E

Wsparcie

E

Najczęściej zadawane pytania

Webhooki to sekretny sos stojący za automatyzacją w czasie rzeczywistym w nowoczesnych platformach SaaS. Jeśli chodzi o Instagram, korzystanie z webhooków pozwala oprogramowaniu natychmiast reagować na nowe wiadomości bez ciągłego odpytywania interfejsu API. Dla redaktorów oprogramowania tworzących narzędzia CRM, ATS lub outreach oznacza to szybsze przepływy pracy i lepsze wrażenia użytkownika. W tym przewodniku zbadamy, jak skonfigurować i zoptymalizować webhooki API Instagrama przy użyciu ujednoliconego interfejsu API Unipile. Gotowy do zasilania swojej aplikacji natychmiastowymi danymi z Instagrama? Zanurzmy się w to.

Czym jest Instagram API Webhook?

Interfejs skrzynki odbiorczej wyświetlający wiadomości od wielu kontaktów za pośrednictwem Instagrama, LinkedIn, WhatsApp i Outlooka.

Instagram API Webhook to narzędzie, które pozwala aplikacji otrzymywać w czasie rzeczywistym aktualizacje z Instagrama. Zamiast pobierać dane, backend otrzymuje natychmiastowe powiadomienie, umożliwiając szybszą i inteligentniejszą automatyzację.

Integracja czatu z wieloma kontami na Instagramie za pośrednictwem interfejsu API Unipile w ujednoliconym interfejsie SaaS

Przegląd webhooków

Webhooks w Unipile to solidna funkcja, która umożliwia aplikacji otrzymywanie informacji w czasie rzeczywistym za każdym razem, gdy w systemie Unipile wystąpią określone zdarzenia. W przeciwieństwie do okresowego odpytywania, w którym aplikacja sprawdza aktualizacje, webhooki wykorzystują protokół powiadomień push, zapewniając natychmiastowe otrzymywanie powiadomień, gdy coś się zmieni. Unipile sprawia, że integracja webhooków jest łatwa, wysyłając żądanie HTTP POST do wybranego adresu URL, co pozwala skonfigurować aplikację tak, aby szybko reagowała na te powiadomienia.

Konfigurowanie webhooków Instagrama za pomocą Unipile

Tworzenie webhooków

Istnieją dwa sposoby tworzenia Webhooków:

Korzystanie z metody POST /webhooks lub odpowiedniej metody SDK
Na pulpicie nawigacyjnym Unipile

Próby

Upewnij się, że kod statusu 200 zostanie wysłany w czasie krótszym niż 30 sekund, ponieważ Webhook podejmuje pięć prób ponowienia, gdy kod odpowiedzi HTTP nie jest równy 200 w czasie krótszym niż 30 sekund, z przyrostowym opóźnieniem między każdą próbą.

Typy webhooków

Unipile oferuje cztery rodzaje Webhooków:

- Aktualizacje statusu konta
- Nowe wiadomości

Webhook Content-Type

W przeciwieństwie do webhooka utworzonego z Dashboard, webhook utworzony przez API domyślnie nie zawiera nagłówka typu JSON. Niektóre aplikacje, takie jak Bubble, Make... wymagają nagłówka typu zawartości, aby otrzymać dobry JSON. Możesz użyć parametru "headers", aby go ustawić.

Typ zawartości Webhook
    
curl --request POST \
     --url https://{YOUR_DSN}/api/v1/webhooks \
     --header 'X-API-KEY: XXXXXXXX' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "request_url": "https://endpoint",
  "source": "messaging",
  "headers": [
    {
      "key": "Content-Type",
      "value": "application/json"
    }
  ]
}'
    
  

Webhook Content-Type

W przeciwieństwie do webhooka utworzonego z Dashboard, webhook utworzony przez API domyślnie nie zawiera nagłówka typu JSON. Niektóre aplikacje, takie jak Bubble, Make... wymagają nagłówka typu zawartości, aby otrzymać dobry JSON. Możesz użyć parametru "headers", aby go ustawić.

Typ zawartości Webhook
    
curl --request POST \
     --url https://{YOUR_DSN}/api/v1/webhooks \
     --header 'X-API-KEY: XXXXXXXX' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "request_url": "https://endpoint",
  "source": "messaging",
  "headers": [
    {
      "key": "Unipile-Auth",
      "value": "yourecretkey"
    }
  ]
}'
    
  

Uwierzytelnianie

Możesz dodać nagłówek z tajnym kluczem, aby uwierzytelnić webhook pochodzący z Unipile

Konfigurowanie webhooków Instagrama za pomocą Unipile

Zarejestruj się w Unipile

Zaloguj się do pulpitu nawigacyjnego

Uzyskaj dostęp do swojego obszaru roboczego i zarządzaj połączonymi kontami.

Pulpit nawigacyjny Unipile z kontami LinkedIn, WhatsApp, Gmail i Instagram połączonymi przez API

Odzyskiwanie poświadczeń Instagram

Aby przeprowadzić uwierzytelnianie na Instagramie, użytkownik potrzebuje jego INSTAGRAM nazwa użytkownika i hasło. Uwierzytelnianie za pomocą poświadczeń Facebooka nie jest obecnie obsługiwane.

Uwierzytelnianie

Wyślij żądanie POST do ten punkt końcowy interfejsu API Unipile lub użyć odpowiedniej metody SDK.

Połącz konto na Instagramie
    
curl --request POST
     --url https://{YOUR_DSN}/api/v1/accounts
     --header 'X-API-KEY: {YOUR_ACCESS_TOKEN}'
     --header 'accept: application/json'
     --header 'content-type: application/json'
     --data '
{
  "provider": "INSTAGRAM",
  "username": "unipile",
  "hasło": "********"
}
'
    
  

Obsługa punktu kontrolnego 2FA

Jeśli konto na Instagramie ma aktywowane uwierzytelnianie dwuskładnikowe, napotkasz punkt kontrolny w statusie 202. Oto przykład odpowiedzi punktu kontrolnego.

    
{
  "object": "Checkpoint",
  "account_id": "098dez89d",
  "checkpoint": {
    "type": "2FA"
  }
}
    
  

W takim przypadku rozpoczyna się nowa intencja uwierzytelniania. Intencja ta trwa 5 minut, a punkty kontrolne muszą zostać rozwiązane w tym czasie.

Rozwiązanie punktu kontrolnego 2FA

Aby rozwiązać punkt kontrolny 2FA, wykonaj żądanie POST do interfejsu API Unipile przy użyciu punktu końcowego Solve checkpoint lub użyj metody SDK, podając metodę account_id zwrócone przez pierwsze żądanie.

    
curl --request POST
     --url https://{YOUR_DSN}/api/v1/accounts/checkpoint
     --header 'X-API-KEY: {YOUR_ACCESS_TOKEN}'
     --header 'accept: application/json'
     --header 'content-type: application/json'
     --data '
{
  "provider": "INSTAGRAM",
  "account_id": "098dez89d",
  "code": "******"
}
'
    
  

Limit czasu obsługi intencji

Jeśli użytkownik potrzebuje więcej niż 5 minut na rozwiązanie punktu kontrolnego, konto nie zostanie połączone. Każde kolejne żądanie rozwiązania punktu kontrolnego po upływie 5 minut spowoduje najpierw odpowiedź 408 - przekroczenie limitu czasu żądania, a następnie 400 - nieprawidłowe żądanie, ponieważ intencja uwierzytelnienia ulegnie samozniszczeniu.

Obsługiwane zdarzenia Webhook na Instagramie

Webhooki czasu rzeczywistego dla wiadomości bezpośrednich
Otrzymuj natychmiastowe powiadomienia za każdym razem, gdy w jednej z połączonych skrzynek odbiorczych na Instagramie pojawi się nowa wiadomość DM. Dzięki obsłudze webhooków przez Unipile możesz wyzwalać automatyczne odpowiedzi, synchronizować konwersacje z CRM lub natychmiast powiadamiać właściwego członka zespołu, bez żadnego odpytywania lub opóźnień.

Obejście dla innych zdarzeń: Okresowe śledzenie historii
W przypadku zdarzeń nieobsługiwanych przez natywne webhooki (polubienia, obserwujący, komentarze do postów itp.) można regularnie sprawdzać aktywność użytkowników, porównywać ją z wcześniej zapisanymi danymi i wykrywać wszelkie zmiany. Ta metoda pozwala rejestrować interakcje, śledzić wzorce zaangażowania i synchronizować aktualizacje z systemem, zapewniając zachowanie i analizy w czasie rzeczywistym, nawet bez dostępu do webhooków.

    Zarządzanie wieloma kontami na Instagramie za pomocą Webhooks

    Uwierzytelnianie i przepływy subskrypcji na dużą skalę

    Obsługa wielu kont biznesowych na Instagramie wymaga usprawnionego systemu uwierzytelniania OAuth lub hostowanego. Dzięki Unipile każde konto jest bezpiecznie połączone, a subskrypcje webhook są tworzone automatycznie podczas wdrażania. Pozwala to redaktorom oprogramowania oferować obsługę wielu kont bez skomplikowanej logiki konfiguracji lub ręcznych wywołań API.

    Interfejs użytkownika pokazujący zarządzanie wieloma kontami na Instagramie

    Routing webhooków i mapowanie kont

    Po wyzwoleniu webhooków identyfikacja konta, do którego należą, jest niezbędna. Unipile osadza identyfikatory kont w ładunku, dzięki czemu system może precyzyjnie kierować zdarzenia, nawet podczas zarządzania setkami profili na Instagramie. Jest to idealne rozwiązanie dla CRM lub pakietów marketingowych ze scentralizowanymi skrzynkami odbiorczymi lub współdzielonymi pulpitami nawigacyjnymi.

    Mechanizmy obsługi błędów i ponawiania prób

    Problemy z siecią lub awarie zaplecza mogą przerwać dostarczanie webhooków. Unipile wdraża automatyczną logikę ponawiania prób i kolejkowanie zdarzeń, aby zagwarantować dostawę. Ponadto alerty i dzienniki awarii są dostępne dla programistów, umożliwiając zespołowi wykrywanie i naprawianie problemów, zanim wpłyną one na użytkowników końcowych.

    Kluczowe zalety korzystania z Unipile dla Instagram Webhooks

    Jeden ujednolicony interfejs API dla wszystkich kanałów

    Unipile konsoliduje interfejsy API wiadomości, poczty e-mail i kalendarza w jedną warstwę integracji. Zamiast żonglować wieloma dostawcami dla Instagrama, WhatsApp, LinkedIn i Gmaila, redaktorzy oprogramowania mogą usprawnić rozwój i konserwację przy użyciu jednej spójnej struktury API. Dzięki Unipile API mediów społecznościowychObsługa webhooków, uwierzytelnianie i wdrażanie funkcji są ujednolicone na wszystkich platformach, co pozwala zaoszczędzić czas, zmniejszyć liczbę błędów i przyspieszyć dostarczanie produktów.

    Wbudowana skalowalność i bezobsługowa architektura

    Infrastruktura Unipile została zaprojektowana z myślą o dużym wolumenie i niskim tarciu. Dostarczanie webhooków jest zarządzane za pomocą kolejkowania, ponawiania prób i monitorowania, więc Twój zespół nie musi tworzyć ani utrzymywać niestandardowego oprogramowania pośredniczącego. Niezależnie od tego, czy zarządzasz 10 kontami, czy 10 000, Unipile zapewnia stabilny przepływ webhooków z czasem pracy 99,9%.

    Krótszy czas wprowadzania produktów na rynek dla wydawców SaaS

    Dzięki wstępnie skonfigurowanym punktom końcowym webhook, przepływom OAuth i kompletnemu pulpitowi programisty, Unipile skraca czas integracji. Zamiast tygodni pracy nad backendem, możesz wdrożyć funkcje webhook Instagrama w ciągu kilku dni, pozwalając skupić się na budowaniu wartości dla użytkowników, a nie na hydraulice.

    Kryteria Meta API Unipile
    Czas na integrację Tygodnie/miesiące 2-3 dni
    Wysiłek deweloperski Wysoki Niski (REST + SDK)
    Konserwacja Podręcznik W pełni zarządzany
    Dostęp do funkcji Częściowy (po zatwierdzeniu) Pełny, teraz
    Wsparcie Tylko samoobsługa Dedykowany zespół techniczny

     Odblokuj potężne webhooki z Instagrama w swojej aplikacji

    Webhooki pozwalają aplikacji natychmiast reagować na to, co ważne na Instagramie, bez odpytywania i opóźnień. Dzięki ujednoliconemu interfejsowi API Unipile możesz subskrybować bogaty zestaw zdarzeń webhook na Instagramie i oferować swoim użytkownikom wrażenia w czasie rzeczywistym bezpośrednio w CRM, ATS lub narzędziu kontaktowym.

    Ujednolicona skrzynka odbiorcza pokazująca zsynchronizowane wiadomości z Instagrama i LinkedIn dla Michel Opra

    Webhooki, które można wykorzystać

    • Bezpośrednie wiadomości (DM): Natychmiastowe powiadamianie użytkowników o otrzymaniu nowej wiadomości. Idealne rozwiązanie do monitorowania sprzedaży lub angażowania kandydatów.

    Korzyści dla wydawców oprogramowania

    • Automatyzacja w czasie rzeczywistym: Twórz inteligentne sekwencje, które natychmiast reagują na DM.

    • Ujednolicona skrzynka odbiorcza: Scentralizuj wiadomości z Instagrama obok LinkedIn, WhatsApp i poczty e-mail.

    • Przyjazny bez użycia kodu: Łatwe kierowanie zdarzeń do narzędzi takich jak Make, Zapier lub wewnętrznych przepływów pracy za pomocą interfejsu API Unipile.

    Jakie funkcje Instagrama można odblokować za pomocą API Unipile?

    Interfejs API Instagram firmy Unipile nie tylko zapewnia webhooki, ale także daje edytorom oprogramowania dostęp do pełnego zestawu programowych punktów końcowych. Można wysyłać i odbierać wiadomości DM. Możliwości te pozwalają budować kompleksowe przepływy automatyzacji, wzbogacać CRM o informacje społecznościowe i zasilać zaawansowane narzędzia do planowania lub angażowania, a wszystko to z jednej ujednoliconej integracji.

    Funkcje Instagrama

    instagram api

    Połączenie z kontem

    Wiadomości

    Webhooks

    Hosted Auth: Biała etykieta do łączenia użytkowników końcowych ✓
    Niestandardowe uwierzytelnianie: połączenie użytkownika z poświadczeniami, plikami cookie, rozszerzeniem Chrome ✓
    Wysyłanie i odpowiadanie na wiadomości ✓
    Lista wiadomości, czatów i uczestników ✓
    Wysyłanie notatek głosowych ✓
    Lista reakcji ✓
    Odczytywanie paragonów ✓
    Wysyłanie załączników do plików ✓
    Odbieranie załączników do plików ✓
    Status konta ✓
    Nowa wiadomość ✓
    Nowa reakcja / odczyt / wydarzenie ✓
    Połączenie z kontem
    ✓
    Hosted Auth: Biała etykieta do łączenia użytkowników końcowych
    ✓
    Niestandardowe uwierzytelnianie: połączenie użytkownika z poświadczeniami, plikami cookie, rozszerzeniem Chrome
    Wiadomości
    ✓
    Wysyłanie i odpowiadanie na wiadomości
    ✓
    Lista wiadomości, czatów i uczestników
    ✓
    Historia synchronizacji
    ✓
    Lista reakcji
    ✓
    Odczytywanie paragonów
    ✓
    Wysyłanie załączników do plików
    ✓
    Odbieranie załączników do plików
    Webhooks
    ✓
    Status konta
    ✓
    Nowa wiadomość
    ✓
    Nowa reakcja / odczyt / wydarzenie

    Podsumowanie - Tworzenie przepływów pracy na Instagramie w czasie rzeczywistym za pomocą Webhooks i Unipile

    Webhooki API Instagrama zmieniają zasady gry dla każdej platformy SaaS, która chce dostarczać doświadczenia w czasie rzeczywistym. Dzięki natychmiastowym powiadomieniom o wiadomościach, webhooki umożliwiają szybszą i inteligentniejszą reakcję produktu. Dzięki ujednoliconemu interfejsowi API Unipile możesz odblokować te funkcje na wielu kontach przy minimalnym wysiłku, nie martwiąc się o skalowanie, zgodność lub konserwację. Niezależnie od tego, czy budujesz CRM, ATS czy platformę zasięgową, integracja webhooków Instagrama za pośrednictwem Unipile oznacza szybsze wprowadzanie produktów na rynek, lepszą synchronizację danych i szczęśliwszych użytkowników.

    Gotowy do startu? Buduj teraz z Unipile i odblokuj pełną moc Instagrama, LinkedIn, poczty e-mail i nie tylko!

    Webhooki API Instagrama: Wsparcie i zasoby Unipile

    1 Ikona

    Połączenie integracyjne
    Zapewnienie spotkania na żądanie z naszymi założycielami (CTO i CEO) w celu uzgodnienia strategii technicznej i produktowej.

    1 Ikona

    Połączenie integracyjne
    Zapewnienie spotkania na żądanie z naszymi założycielami (CTO i CEO) w celu uzgodnienia strategii technicznej i produktowej.

    Ikona dostarczalności

    Połącz się z pomocą techniczną na żywo
    Nasze wsparcie na żywo jest do Twojej dyspozycji przed, w trakcie i po integracji, zapewniając wskazówki na każdym kroku bez dodatkowych kosztów.

    Ikona dostarczalności

    Połącz się z pomocą techniczną na żywo
    Nasze wsparcie na żywo jest do Twojej dyspozycji przed, w trakcie i po integracji, zapewniając wskazówki na każdym kroku bez dodatkowych kosztów.

    Dedykowana pomoc podczas integracji

    Nasz zespół wsparcia jest z Tobą na każdym kroku, przed, w trakcie i po integracji, aby zapewnić płynne działanie. Jesteśmy tutaj, aby zapewnić pomoc w czasie rzeczywistym, pomagając uniknąć wszelkich czkawek i dodatkowych kosztów.

    Kompleksowe zasoby dla deweloperów

    Nasze API zawiera szczegółową dokumentację i przykładowy kod, aby uprościć integrację. Zasoby te zostały zaprojektowane w celu zwiększenia możliwości aplikacji, dzięki czemu proces wysyłania wiadomości i innych komunikatów jest płynniejszy i bardziej wydajny.

    Bieżące aktualizacje i konserwacja

    Dzięki proaktywnym aktualizacjom i regularnej konserwacji nasz interfejs API pozostaje zgodny z najnowszymi standardami i ulepszeniami Instagrama, zapewniając stałą wydajność i minimalizując wszelkie potencjalne przestoje.

    Najczęściej zadawane pytania

    Czym jest Webhook API Instagrama?

    Webhook API Instagram to system powiadomień push w czasie rzeczywistym, który wysyła aktualizacje do zaplecza, gdy na Instagramie wystąpią określone zdarzenia, takie jak otrzymanie bezpośredniej wiadomości. Eliminuje to potrzebę wielokrotnego odpytywania interfejsu API.

    Które wydarzenia mogę subskrybować za pomocą API Instagram Unipile?

    Unipile obsługuje zdarzenia webhook dla DM, zaprojektowane, aby pomóc zautomatyzować zaangażowanie użytkowników i synchronizację danych w aplikacji.

    Czy muszę przestrzegać zasad Meta podczas korzystania z Unipile?

    Tak. Mimo że Unipile upraszcza integrację, każde użycie musi być zgodne z Warunkami korzystania z usługi Meta. Oznacza to zakaz skrobania, spamu i nieautoryzowanej automatyzacji. Nasze API koncentruje się wyłącznie na interoperacyjności komunikatów, a każda implementacja musi być zgodna z oficjalnymi zasadami Meta.

    Czy Unipile jest zgodny z ustawą o rynkach cyfrowych (DMA)?

    Tak. Unipile został zaprojektowany zgodnie z DMA, umożliwiając interoperacyjność wiadomości w kanałach takich jak Instagram, WhatsApp i Messenger. Nie omijamy zabezpieczeń platformy ani nie przechowujemy nieautoryzowanych danych, zamiast tego zapewniamy ujednolicony i zgodny z przepisami sposób integracji funkcji przesyłania wiadomości przez edytorów oprogramowania.

    Jak uwierzytelnić wiele kont Instagram i zarządzać nimi za pomocą webhooków?

    Unipile zapewnia hostowany przepływ podobny do OAuth lub uwierzytelnianie oparte na danych uwierzytelniających. Po połączeniu kont subskrypcje webhook są automatycznie tworzone i kierowane przy użyciu unikalnych identyfikatorów kont, dzięki czemu zarządzanie wieloma kontami jest skalowalne i niezawodne.

    Co się stanie, jeśli mój punkt końcowy webhook będzie tymczasowo niedostępny?

    Unipile automatycznie kolejkuje zdarzenia i ponawia próby ich dostarczenia. Będziesz mieć dostęp do dzienników webhooków i raportów błędów, dzięki czemu możesz identyfikować awarie, naprawiać problemy i wznawiać przetwarzanie zdarzeń bez utraty danych.

    Jak bezpieczne są dane przesyłane za pośrednictwem webhooków API Instagrama?

    Wszystkie ładunki webhook są dostarczane przez HTTPS i zawierają nagłówki walidacyjne w celu weryfikacji integralności. Unipile jest zgodny z RODO i przestrzega standardów branżowych, aby zapewnić bezpieczną, szyfrowaną komunikację.

    Jak długo trwa wdrożenie webhooków Instagrama przy użyciu Unipile?

    Większość zespołów integruje system webhooków Unipile w mniej niż 2 dni. Dzięki gotowym do użycia punktom końcowym, przepływom generowania tokenów i szczegółowej dokumentacji możesz być gotowy do produkcji szybciej niż przy użyciu samych natywnych interfejsów API Meta.

    Możesz także polubić

    API poczty e-mail dla deweloperów: Twórz z Gmail, Outlook i IMAP (Przewodnik 2026)

    API e-mailowe dla programistów: Twórz z Gmail, Outlook i IMAP (Przewodnik 2026)

    Budowa vs. zakup Natywne API poczty e-mail vs. zunifikowane API poczty e-mail: porównanie rzeczywistego kodu Zobaczenie obu podejść obok siebie – w rzeczywistym kodzie – konkretyzuje kompromis. Wybierz poniżej język, aby porównać odczytywanie wiadomości e-mail natywnie lub za pośrednictwem zunifikowanego API poczty e-mail Unipile. Node.js Python Go / cURL Natywny - Gmail...

    czytaj dalej
    pl_PLPL