Wprowadzenie
Webhook API Instagram
Przegląd Webhooks
Konfiguracja z Unipile
Zdarzenia webhook na Instagramie
Zarządzanie wieloma kontami na Instagramie
Webhooki z Instagrama
Punkty końcowe API Instagrama
Wnioski
Wsparcie
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?
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ę.
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ć.
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ć.
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.
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.
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.
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.
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
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
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 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...
Microsoft Graph OAuth: Uwierzytelnianie skrzynek pocztowych Outlook i Microsoft 365 (Przewodnik 2026)
Microsoft Graph OAuth 2026 Microsoft Graph OAuth: Automatyzacja skrzynek pocztowych Outlook i Microsoft 365 Kompletny przewodnik z 2026 roku po Microsoft Graph OAuth dla deweloperów SaaS. Obejmuje rejestrację aplikacji Microsoft Entra, punkty końcowe autorytetu, zakresy poczty, uprawnienia delegowane w porównaniu z uprawnieniami aplikacji, zgodę administratora,...
API pocztowe dla SaaS: Połącz skrzynki pocztowe użytkowników (Gmail, Outlook, IMAP) w 2026 roku
API e-mail dla SaaS Daj swojemu SaaS dostęp do skrzynek odbiorczych użytkowników za pomocą API e-mail API e-mail dla SaaS pozwala Twojemu produktowi odczytywać, wysyłać i synchronizować e-maile bezpośrednio z kont Gmail, Outlook lub IMAP Twoich użytkowników – bez używania haseł. Buduj integracje z CRM, narzędzia sprzedażowe, helpdeski i asystentów AI na...


