Jak pozwolić klientom połączyć Instagram z Twoją aplikacją
Twój backend wywołuje POST /connect-sessions w easyCoexistence z channel instagram i wysyła klienta pod zwrócony url, gdzie loguje się przez Instagram Login na konto Business lub Creator. Wraca na Twój redirect_url z channel_id, a GET /channels/{id}?credentials=1 zwraca token dla graph.instagram.com, dzięki czemu Twoja aplikacja może publikować, czytać komentarze i odpowiadać na DM.
Posty publikowane przez API, które konto Instagram może wysłać w ruchomym oknie 24 godzin; karuzela liczy się jako jeden.
Jedyny format obrazu, który Meta obsługuje przy publikowaniu na Instagramie przez API.
Standardowe okno na odpowiedź na wiadomość prywatną (DM) na Instagramie w większości działań użytkownika; osoba musi napisać pierwsza.
Wiadomości, które konto może wysłać do osoby komentującej przez prywatną odpowiedź, w ciągu 7 dni od komentarza.
Jak długo link do połączenia easyCoexistence działa, zanim sesja wygaśnie.
Co klient musi zrobić, żeby się połączyć?
Wystarczy jeden przycisk. Twoja aplikacja tworzy sesję z channel ustawionym na instagram, redirect_url i identyfikatorem klienta jako external_ref, po czym wysyła klienta na jej url. Hostowana strona pokazuje Twoją nazwę i przycisk Continue with Instagram, który otwiera logowanie Instagrama w tej samej karcie, więc działa też na telefonach. Klient zatwierdza dostęp i trafia na Twój redirect_url z status=connected oraz channel_id, który Twój backend potwierdza przez GET /connect-sessions/{id}.
Które konta Instagram mogą się połączyć?
Konta profesjonalne, Business lub Creator, czyli te, które obsługuje Instagram API Mety. Konto już podłączone przez inną usługę korzystającą z easyCoexistence zostaje odrzucone, a last_error sesji to wyjaśnia; klient najpierw usuwa je tam albo loguje się innym kontem. W przypadku DM konto musi też włączyć opcję „Zezwól na dostęp do wiadomości” w aplikacji Instagram, a przewodnik po połączeniu z Instagramem podaje ścieżkę.
Jaki token dostaje Twoja aplikacja?
Token użytkownika Instagrama dla graph.instagram.com/v25.0, z account_id_on_meta, czyli identyfikatorem konta na Instagramie, z GET /channels/{id}?credentials=1. easyCoexistence odnawia go na długo przed upływem 60 dni, a odnowienie wystawia nowy token, więc pobieraj dane uwierzytelniające na początku każdego zadania zamiast przechowywać jedną kopię.
Jak Twoja aplikacja publikuje na koncie?
Przez POST /channels/{id}/posts. ig_type wybiera IMAGE, CAROUSEL, REELS lub STORIES i jest ustalany na podstawie mediów, jeśli go pominiesz: kilka plików tworzy karuzelę, a jedno wideo Reel. Karuzela przyjmuje od 2 do 10 elementów, obrazy muszą być w JPEG, tekst może mieć do 2 200 znaków, a post na Instagramie nie ma pola link. Bez publish_at post idzie od razu; z nim o wskazanej godzinie, najwyżej 90 dni naprzód.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ig_post_2291" \
-d '{
"text": "Three looks for the weekend.",
"ig_type": "CAROUSEL",
"media": [
{ "url": "https://cdn.example.com/look-1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/look-2.jpg", "type": "image" },
{ "url": "https://cdn.example.com/look-3.jpg", "type": "image" }
]
}'Jak komentarze i DM trafiają do Twojej aplikacji?
Po ustawieniu miejsca docelowego. PUT /channels/{id}/webhook z Twoim URL zwraca sekret podpisu tego konta, a od tego momentu jego komentarze, wzmianki i DM są przekazywane na bieżąco, podpisane nagłówkiem X-EC-Signature. Treść zawiera platform, account_id, external_id oraz wpis webhooka Mety bez zmian, z changes dla komentarzy i wzmianek oraz messaging dla DM.
Jak Twoja aplikacja odpowiada na komentarze i DM?
Przez Instagram API Mety pod adresem graph.instagram.com, z tokenem klienta, więc każda odpowiedź pochodzi z konta klienta:
- Odpowiedź na komentarz: POST /<
IG_COMMENT_ID>/replies z wiadomością. - Odpowiedź na DM: POST /<
IG_ID>/messages z recipient ustawionym na identyfikator osoby oraz treścią wiadomości, w ciągu 24 godzin od jej ostatniej wiadomości. - Prywatna odpowiedź na komentarz: ta sama krawędź messages z recipient
comment_id, raz na komentarz, w ciągu 7 dni od niego. - Ukrycie lub usunięcie komentarza: POST lub DELETE na /<
IG_COMMENT_ID>.
Co się dzieje, gdy dostęp klienta się kończy?
Twój URL zdarzeń dostaje channel.disconnected, gdy Instagram odrzuci token albo właściciel cofnie dostęp w ustawieniach Instagrama. Nowa sesja połączenia dla tego klienta przywraca konto. Żeby zakończyć to po swojej stronie, DELETE /channels/{id} unieważnia dostęp w sieci i anuluje posty czekające w kolejce, a rozliczenie zatrzymuje się na końcu cyklu.
Typowe błędy
- Wysyłanie obrazów PNG lub WebP do Instagrama. Meta publikuje tylko JPEG, więc post zostaje odrzucony, zanim trafi do kolejki; najpierw konwertuj obrazy.
- Dodawanie pola link do posta na Instagramie. Posty na Instagramie nie mają linków, więc żądanie zostaje odrzucone; wpisz URL w tekście.
- Pokazywanie przycisku Odpowiedz przy DM starszych niż 24 godziny. Meta pozwala odpowiadać w oknie, które otworzyła ostatnia wiadomość osoby.
- Wysyłanie drugiej prywatnej odpowiedzi na ten sam komentarz. Meta dopuszcza jedną; kolejna czeka, aż osoba odpowie.
easyCoexistence pozwala klientom połączyć Instagram z Twoją aplikacją przez jedno hostowane logowanie, a następnie daje Twojemu backendowi odnawiany token, endpoint do postów oraz komentarze i DM przez webhook, przy czym każde połączenie jest monitorowane 24/7. Te same wywołania obsługują WhatsApp, Facebooka, TikToka, YouTube, LinkedIn i kolejne kanały. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, mniej w miarę dodawania połączeń, z pierwszymi 3 dniami bezpłatnie.
Najczęściej zadawane pytania
Czy potrzebuję własnej aplikacji Meta, żeby łączyć konta Instagram klientów?
Nie. Klienci logują się przez aplikację easyCoexistence, a Twój backend odbiera token do Instagram API Mety przez wywołanie credentials.
Czy klient może połączyć kilka kont Instagram?
Tak, jedno przy każdym logowaniu. Utwórz sesję połączenia dla każdego konta z tym samym external_ref, a GET /channels?external_ref= wyświetli je wszystkie dla tego klienta.
Czy moja aplikacja może planować relacje na Instagramie?
Tak. Ustaw ig_type na STORIES z jednym obrazem lub wideo i czasem publish_at, a kolejka opublikuje je wtedy.
Ile kosztuje easyCoexistence za konto Instagram?
Każde połączone konto kosztuje od US$ 9 do US$ 0.75 miesięcznie, zależnie od przedziału łącznej liczby połączeń, z pierwszymi 3 dniami bezpłatnie.
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