Miten annat asiakkaidesi yhdistää Instagram-tilinsä sovellukseesi
Backendisi kutsuu easyCoexistencen POST /connect-sessions -päätepistettä channel-arvolla instagram ja ohjaa asiakkaan palautettuun url-osoitteeseen, jossa hän kirjautuu Instagram Login -palvelulla Business- tai Creator-tilillä. Hän palaa redirect_url-osoitteeseesi channel_id:n kanssa, ja GET /channels/{id}?credentials=1 palauttaa tokenin osoitteelle graph.instagram.com, jotta sovelluksesi voi julkaista, lukea kommentteja ja vastata DM-viesteihin.
API:n kautta julkaistut julkaisut, jotka Instagram-tili voi tehdä liukuvan 24 tunnin aikana; karuselli lasketaan yhdeksi.
Ainoa kuvamuoto, jota Meta tukee julkaisuun Instagramiin API:n kautta.
Vakioaika vastata henkilön Instagram-yksityisviestiin useimmissa käyttäjätoimissa; henkilön on kirjoitettava ensin.
Viestit, jotka tili voi lähettää kommentoijalle yksityisvastauksena kommentin jälkeisen 7 päivän sisällä.
Kuinka kauan easyCoexistencen yhdistämislinkki toimii ennen kuin istunto vanhenee.
Mitä asiakkaasi tekee yhdistääkseen?
Painaa yhtä painiketta. Sovelluksesi luo istunnon, jossa channel on instagram, redirect_url ja asiakkaan tunnus external_ref-kenttänä, ja ohjaa asiakkaan sen url-osoitteeseen. Isännöity sivu näyttää sovelluksesi nimen ja painikkeen ”Continue with Instagram”, joka avaa Instagramin oman kirjautumisen samassa välilehdessä, joten se toimii myös puhelimilla. Asiakas hyväksyy käyttöoikeuden ja palaa redirect_url-osoitteeseesi, jossa on status=connected ja channel_id. Backendisi vahvistaa tämän kutsulla GET /connect-sessions/{id}.
Mitkä Instagram-tilit voivat yhdistyä?
Ammattitilit, Business tai Creator, joita Metan Instagram-rajapinta palvelee. Tili, joka on jo yhdistetty toisen easyCoexistencea käyttävän palvelun kautta, hylätään, ja istunnon last_error kertoo tämän. Asiakas poistaa sen siellä ensin tai kirjautuu toisella tilillä. Yksityisviestejä varten tilillä on myös oltava käytössä ”Allow access to messages” Instagram-sovelluksen asetuksissa, ja Instagram-yhdistämisopas näyttää polun.
Minkä tokenin sovelluksesi saa?
Instagram-käyttäjätoken osoitteelle graph.instagram.com/v25.0 ja kentässä account_id_on_meta tilin Instagram-tunnus, GET /channels/{id}?credentials=1 -kutsusta. easyCoexistence uusii tokenin hyvissä ajoin ennen kuin sen 60 päivää päättyy, ja uusiminen luo uuden tokenin. Hae tunnistetiedot siksi jokaisen työn alussa äläkä säilytä yhtä kopiota.
Miten sovelluksesi julkaisee tilille?
Kutsulla POST /channels/{id}/posts. ig_type valitsee IMAGE, CAROUSEL, REELS tai STORIES, ja se päätellään mediasta, jos jätät sen pois: useat tiedostot muodostavat karusellin ja yksi video Reelin. Karusellissa on 2–10 kohdetta, kuvien on oltava JPEG-muodossa, teksti saa olla enintään 2 200 merkkiä, eikä Instagram-julkaisussa ole linkkikenttää. Ilman publish_at-kenttää julkaisu menee heti. Sen kanssa se menee annettuna aikana, enintään 90 päivää eteenpäin.
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" }
]
}'Miten kommentit ja DM-viestit tulevat sovellukseesi?
Kun asetat kohteen. PUT /channels/{id}/webhook palauttaa, kun lähetät osoitteesi, tilin allekirjoitussalaisuuden. Sen jälkeen tilin kommentit, maininnat ja DM-viestit välitetään saapuessaan, allekirjoitettuina X-EC-Signature-otsakkeella. Runko sisältää kentät platform, account_id ja external_id sekä Metan webhook-merkinnän muuttumattomana, jossa ovat changes kommenteille ja maininnoille sekä messaging DM-viesteille.
Miten sovelluksesi vastaa kommentteihin ja DM-viesteihin?
Metan Instagram-rajapinnan kautta osoitteessa graph.instagram.com asiakkaan tokenilla, jolloin jokainen vastaus tulee asiakkaan tililtä:
- Vastaa kommenttiin: POST /<
IG_COMMENT_ID>/replies viestillä. - Vastaa DM-viestiin: POST /<
IG_ID>/messages, recipient asetettuna henkilön tunnukseksi ja viestin teksti, 24 tunnin sisällä henkilön viimeisimmästä viestistä. - Yksityisvastaus kommenttiin: sama messages-päätepiste, recipient
comment_id, kerran kommenttia kohden, 7 päivän sisällä siitä. - Piilota tai poista kommentti: POST tai DELETE kohteeseen /<
IG_COMMENT_ID>.
Mitä tapahtuu, kun asiakkaan käyttöoikeus päättyy?
Tapahtumaosoitteeseesi tulee channel.disconnected, kun Instagram hylkää tokenin tai tilin omistaja peruu käyttöoikeuden Instagramin asetuksista. Uusi yhdistämisistunto kyseiselle asiakkaalle palauttaa tilin. Jos lopetat yhteyden omalta puoleltasi, DELETE /channels/{id} peruu käyttöoikeuden verkossa ja jonossa vielä odottavat julkaisut, ja laskutus loppuu jakson päättyessä.
Yleiset virheet
- PNG- tai WebP-kuvien lähettäminen Instagramiin. Meta julkaisee vain JPEG-kuvat, joten julkaisu hylätään ennen jonoon asettamista. Muunna kuvat ensin.
- Linkkikentän lisääminen Instagram-julkaisuun. Instagram-julkaisuissa ei ole linkkiä, joten pyyntö hylätään. Laita URL tekstiin.
- Vastauspainikkeen näyttäminen yli 24 tunnin ikäisissä DM-viesteissä. Meta sallii vastaukset siinä ikkunassa, jonka henkilön viimeisin viesti avasi.
- Toisen yksityisvastauksen lähettäminen samaan kommenttiin. Meta sallii yhden, ja seuraava odottaa, kunnes henkilö vastaa.
easyCoexistence antaa asiakkaidesi yhdistää Instagramin sovellukseesi yhden isännöidyn kirjautumisen kautta. Backendisi saa uusitun tokenin, julkaisupäätepisteen sekä kommentit ja DM-viestit webhookin kautta, ja jokaista yhteyttä valvotaan ympäri vuorokauden. Samat kutsut kattavat WhatsAppin, Facebookin, TikTokin, YouTuben, LinkedInin ja muita kanavia. US$ 9–US$ 0,75 yhteydeltä kuukaudessa, hinta laskee yhteyksien lisääntyessä, ja 3 ensimmäistä päivää ovat ilmaista kokeilua.
Usein kysytyt kysymykset
Tarvitsenko oman Meta-sovelluksen asiakkaideni Instagram-tilien yhdistämiseen?
Ei. Asiakkaat kirjautuvat easyCoexistencen sovelluksella, ja backendisi saa Metan Instagram-rajapinnan tokenin tunnistetietokutsun kautta.
Voiko asiakas yhdistää useita Instagram-tilejä?
Kyllä, yhden kirjautumista kohden. Luo yhdistämisistunto jokaiselle tilille samalla external_ref-arvolla, ja GET /channels?external_ref= listaa ne kaikki kyseiseltä asiakkaalta.
Voiko sovellukseni ajastaa Instagram-tarinoita?
Kyllä. Aseta ig_type arvoon STORIES yhdellä kuvalla tai videolla ja publish_at-aika, niin jono julkaisee sen silloin.
Mitä easyCoexistence maksaa Instagram-tiliä kohden?
Jokainen yhdistetty tili maksaa US$ 9–US$ 0,75 kuukaudessa kokonaisyhteyksiesi määrän mukaan porrastettuna, ja 3 ensimmäistä päivää ovat ilmaista kokeilua.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu