Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Cum să le permiți clienților tăi să conecteze Instagram la aplicația ta

Backend-ul tău apelează POST /connect-sessions al easyCoexistence cu channel instagram și trimite clientul la URL-ul returnat, unde se autentifică prin Instagram Login pe un cont Business sau Creator. Revine la redirect_url-ul tău cu un channel_id, iar GET /channels/{id}?credentials=1 returnează un token pentru graph.instagram.com, astfel încât aplicația ta poate publica, citi comentarii și răspunde la DM-uri.

100 posts

Postări publicate prin API de un cont Instagram într-un interval glisant de 24 de ore; un carusel contează ca una.

JPEG

Singurul format de imagine pe care Meta îl acceptă pentru publicarea pe Instagram prin API.

24 hours

Fereastra standard pentru a răspunde unui DM de Instagram al unei persoane, pentru majoritatea acțiunilor utilizatorului; persoana trebuie să scrie prima.

1 private reply

Mesaje pe care un cont le poate trimite unui comentator printr-un răspuns privat, în termen de 7 zile de la comentariu.

1 hour

Cât timp rămâne valabil un link de conectare easyCoexistence înainte ca sesiunea să expire.

Ce trebuie să facă clientul pentru a se conecta?

Apasă un singur buton. Aplicația ta creează sesiunea cu channel setat la instagram, un redirect_url și ID-ul clientului tău ca external_ref, apoi îl trimite la URL-ul ei. Pagina găzduită îi afișează numele tău și butonul Continue with Instagram, care deschide autentificarea proprie Instagram în aceeași filă, deci funcționează și pe telefon. Clientul aprobă accesul și ajunge la redirect_url-ul tău cu status=connected și channel_id, pe care backend-ul tău îl confirmă cu 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

Ce conturi Instagram se pot conecta?

Conturi profesionale, Business sau Creator, pe care le servește API-ul Instagram al Meta. Un cont deja conectat printr-un alt serviciu care folosește easyCoexistence este refuzat, iar last_error din sesiune o spune; clientul îl elimină mai întâi de acolo sau se autentifică cu alt cont. Pentru DM-uri, contul trebuie să activeze și Allow access to messages în aplicația Instagram, iar ghidul de conectare Instagram arată calea.

Ce token primește aplicația ta?

Un token de utilizator Instagram pentru graph.instagram.com/v25.0, cu account_id_on_meta, ID-ul Instagram al contului, de la GET /channels/{id}?credentials=1. easyCoexistence îl reînnoiește cu mult înainte ca cele 60 de zile să expire, iar reînnoirea emite un token-ul nou, deci cere credențialele la începutul fiecărei sarcini, în loc să păstrezi o copie.

Cum publică aplicația ta în cont?

Cu POST /channels/{id}/posts. ig_type alege IMAGE, CAROUSEL, REELS sau STORIES și se stabilește din media dacă îl omiți: mai multe fișiere fac un carusel, iar un video face un Reel. Aici un carusel are de la 2 la 10 elemente, imaginile trebuie să fie JPEG, textul are până la 2.200 de caractere, iar o postare Instagram nu are câmp pentru link. Fără publish_at pleacă imediat; cu el, la ora indicată, până la 90 de zile înainte.

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" }
    ]
  }'

Cum ajung comentariile și DM-urile în aplicația ta?

Odată ce setezi o destinație. PUT /channels/{id}/webhook cu URL-ul tău returnează secretul de semnare al contului, iar de atunci comentariile, mențiunile și DM-urile lui sunt transmise pe măsură ce sosesc, semnate cu X-EC-Signature. Corpul conține platform, account_id, external_id și intrarea webhook a Meta nemodificată, cu changes pentru comentarii și mențiuni și messaging pentru DM-uri.

Cum răspunde aplicația ta la comentarii și DM-uri?

Prin API-ul Instagram al Meta de la graph.instagram.com, cu token-ul clientului, astfel încât fiecare răspuns vine din contul clientului:

  • Răspuns la un comentariu: POST /<IG_COMMENT_ID>/replies cu un message.
  • Răspuns la un DM: POST /<IG_ID>/messages cu recipient setat la ID-ul persoanei și textul mesajului, în 24 de ore de la ultimul mesaj al acesteia.
  • Răspuns privat la un comentariu: același edge messages cu recipient comment_id, o dată per comentariu, în 7 zile de la acesta.
  • Ascunderea sau ștergerea unui comentariu: POST sau DELETE pe /<IG_COMMENT_ID>.

Ce se întâmplă când accesul clientului se încheie?

URL-ul tău de evenimente primește channel.disconnected când Instagram refuză token-ul sau proprietarul retrage accesul din setările Instagram. O nouă sesiune de conectare pentru clientul respectiv readuce contul. Pentru a încheia conexiunea din partea ta, DELETE /channels/{id} revocă accesul la rețea și anulează postările încă așteptate în coadă, iar facturarea se oprește la finalul ciclului.

Greșeli frecvente

  • Trimiterea imaginilor PNG sau WebP către Instagram. Meta publică doar JPEG, deci cererea este refuzată înainte de a intra în coadă; convertește mai întâi imaginile.
  • Adăugarea unui câmp de link la o postare Instagram. Postările Instagram nu au link, deci cererea este refuzată; pune URL-ul în text.
  • Afișarea unui buton Reply la DM-uri mai vechi de 24 de ore. Meta permite răspunsuri doar în fereastra deschisă de ultimul mesaj al persoanei.
  • Trimiterea unui al doilea răspuns privat la același comentariu. Meta permite unul; un mesaj următor așteaptă până când persoana răspunde.
Faceți acest lucru cu EasyCoexistence

easyCoexistence permite clienților tăi să conecteze Instagram la aplicația ta printr-o singură autentificare găzduită, apoi oferă backend-ului tău un token reînnoit, un endpoint pentru postări și comentariile și DM-urile lor prin webhook, cu fiecare conexiune monitorizată 24/7. Aceleași apeluri acoperă WhatsApp, Facebook, TikTok, YouTube, LinkedIn și alte canale. De la US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adaugi conexiuni, cu perioada de probă gratuită de 3 zile.

Întrebări frecvente

Am nevoie de propria mea aplicație Meta pentru a conecta conturile Instagram ale clienților?

Nu. Clienții se autentifică prin aplicația easyCoexistence, iar backend-ul tău primește token-ul pentru API-ul Instagram al Meta prin apelul de credențiale.

Poate un client să conecteze mai multe conturi Instagram?

Da, unul la fiecare autentificare. Creează o sesiune de conectare pentru fiecare cont cu același external_ref, iar GET /channels?external_ref= le listează pe toate pentru clientul respectiv.

Poate aplicația mea să programeze Instagram Stories?

Da. Setează ig_type la STORIES cu o imagine sau un video și un moment publish_at, iar coada le publică atunci.

Cât costă easyCoexistence per cont Instagram?

Fiecare cont conectat costă de la US$ 9 până la US$ 0,75 pe lună, în funcție de intervalul total al conexiunilor tale, cu perioada de probă gratuită de 3 zile.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la