Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

100 posts

Posty publikowane przez API, które konto Instagram może wysłać w ruchomym oknie 24 godzin; karuzela liczy się jako jeden.

JPEG

Jedyny format obrazu, który Meta obsługuje przy publikowaniu na Instagramie przez API.

24 hours

Standardowe okno na odpowiedź na wiadomość prywatną (DM) na Instagramie w większości działań użytkownika; osoba musi napisać pierwsza.

1 private reply

Wiadomości, które konto może wysłać do osoby komentującej przez prywatną odpowiedź, w ciągu 7 dni od komentarza.

1 hour

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}.

1Your appPOST /connect-sessions with channel instagram
2Hosted pageYour name and Continue with Instagram
3Instagram LoginThe professional account approves access
4Back to youredirect_url with status and channel_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.

A carousel on the customer's Instagram account
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.
Z EasyCoexistence zrobisz to

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