Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Cara membenarkan pelanggan anda menyambungkan Instagram ke aplikasi anda

Backend anda memanggil POST /connect-sessions milik easyCoexistence dengan channel instagram dan menghantar pelanggan ke url yang dipulangkan, tempat mereka log masuk dengan Instagram Login menggunakan akaun Business atau Creator. Mereka kembali ke redirect_url anda dengan channel_id, dan GET /channels/{id}?credentials=1 memulangkan token untuk graph.instagram.com, supaya aplikasi anda boleh menerbitkan siaran, membaca komen dan membalas DM.

100 posts

Siaran yang boleh diterbitkan melalui API oleh akaun Instagram dalam tempoh 24 jam bergerak; karusel dikira sebagai satu.

JPEG

Satu-satunya format imej yang disokong Meta untuk menerbitkan ke Instagram melalui API.

24 hours

Tempoh standard untuk membalas DM Instagram seseorang bagi kebanyakan tindakan pengguna; mereka mesti menulis dahulu.

1 private reply

Mesej yang boleh dihantar akaun kepada pengomen melalui balasan peribadi, dalam tempoh 7 hari dari komen.

1 hour

Tempoh pautan sambungan easyCoexistence berfungsi sebelum sesinya tamat tempoh.

Apa yang pelanggan lakukan untuk menyambung?

Pelanggan hanya perlu tekan satu butang. Aplikasi anda mencipta sesi dengan channel ditetapkan kepada instagram, redirect_url dan ID pelanggan anda sebagai external_ref, kemudian menghantar pelanggan ke url-nya. Halaman dihoskan itu memaparkan nama anda dan Continue with Instagram, yang membuka log masuk Instagram sendiri dalam tab yang sama, jadi ia berfungsi di telefon. Pelanggan meluluskan akses dan kembali ke redirect_url anda dengan status=connected dan channel_id, yang backend anda sahkan melalui 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

Akaun Instagram mana yang boleh disambungkan?

Akaun profesional, Business atau Creator, iaitu yang dilayan oleh API Instagram Meta. Akaun yang sudah disambungkan melalui perkhidmatan lain yang menggunakan easyCoexistence akan ditolak, dan last_error sesi memberitahu perkara itu; pelanggan mesti mengeluarkannya dahulu di sana atau log masuk dengan akaun lain. Untuk DM, akaun itu juga perlu mengaktifkan Allow access to messages dalam aplikasi Instagram, dan panduan sambungan Instagram memberikan laluannya.

Token apa yang aplikasi anda terima?

Token pengguna Instagram untuk graph.instagram.com/v25.0, dengan account_id_on_meta, ID Instagram akaun itu, daripada GET /channels/{id}?credentials=1. easyCoexistence memperbaharui token jauh sebelum 60 hari tamat, dan pembaharuan mengeluarkan token baharu, jadi dapatkan kelayakan pada permulaan setiap tugasan dan jangan simpan satu salinan sahaja.

Bagaimana aplikasi anda menerbitkan ke akaun?

Dengan POST /channels/{id}/posts. ig_type memilih IMAGE, CAROUSEL, REELS atau STORIES, dan ditentukan daripada media jika anda tinggalkannya: beberapa fail membentuk karusel dan satu video menjadi Reel. Karusel di sini mengambil 2 hingga 10 item, imej mesti JPEG, teks boleh mencapai 2,200 aksara dan siaran Instagram tidak mempunyai medan pautan. Tanpa publish_at ia diterbitkan sekarang; dengan publish_at, pada masa itu, sehingga 90 hari ke hadapan.

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

Bagaimana komen dan DM sampai ke aplikasi anda?

Selepas anda menetapkan destinasi. PUT /channels/{id}/webhook dengan URL anda memulangkan rahsia tandatangan akaun itu, dan sejak itu komen, sebutan dan DM diteruskan sebaik tiba, ditandatangani dengan X-EC-Signature. Badannya memuatkan platform, account_id, external_id dan entri webhook Meta tanpa perubahan, dengan changes untuk komen dan sebutan serta messaging untuk DM.

Bagaimana aplikasi anda membalas komen dan DM?

Melalui API Instagram Meta di graph.instagram.com, dengan token pelanggan, supaya setiap balasan datang daripada akaun pelanggan:

  • Balas komen: POST /<IG_COMMENT_ID>/replies dengan message.
  • Balas DM: POST /<IG_ID>/messages dengan recipient ditetapkan kepada ID orang itu dan teks mesej, dalam tempoh 24 jam selepas mesej terakhir mereka.
  • Balasan peribadi kepada komen: edge messages yang sama dengan recipient comment_id, sekali bagi setiap komen, dalam tempoh 7 hari daripadanya.
  • Sembunyi atau padam komen: POST atau DELETE pada /<IG_COMMENT_ID>.

Apa yang berlaku apabila akses pelanggan tamat?

URL peristiwa anda menerima channel.disconnected apabila Instagram menolak token atau pemilik menarik balik akses dalam tetapan Instagram. Sesi sambungan baharu untuk pelanggan itu membawa akaun kembali. Untuk menamatkannya daripada pihak anda, DELETE /channels/{id} membatalkan akses di rangkaian dan membatalkan siaran yang masih menunggu dalam barisan, dan pengebilan berhenti pada akhir kitaran.

Kesilapan biasa

  • Menghantar imej PNG atau WebP ke Instagram. Meta hanya menerbitkan JPEG, jadi siaran ditolak sebelum dimasukkan ke barisan; tukar imej dahulu.
  • Meletakkan medan pautan pada siaran Instagram. Siaran Instagram tidak mempunyai pautan, jadi permintaan ditolak; letakkan URL dalam teks.
  • Memaparkan butang Balas pada DM yang berusia lebih 24 jam. Meta membenarkan balasan dalam tetingkap yang dibuka oleh mesej terakhir orang itu.
  • Menghantar balasan peribadi kedua kepada komen yang sama. Meta membenarkan satu; susulan menunggu sehingga orang itu menjawab.
Menggunakan EasyCoexistence untuk ini

easyCoexistence membolehkan pelanggan anda menyambungkan Instagram ke aplikasi anda melalui satu log masuk dihoskan, kemudian memberikan backend anda token yang diperbaharui, endpoint siaran serta komen dan DM mereka melalui webhook, dengan setiap sambungan dipantau 24/7. Panggilan yang sama juga meliputi WhatsApp, Facebook, TikTok, YouTube, LinkedIn dan lebih banyak saluran. Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari percubaan percuma.

Soalan lazim

Adakah saya perlukan aplikasi Meta sendiri untuk menyambungkan akaun Instagram pelanggan?

Tidak. Pelanggan log masuk melalui aplikasi easyCoexistence, dan backend anda menerima token untuk API Instagram Meta melalui panggilan kelayakan.

Bolehkah pelanggan menyambungkan beberapa akaun Instagram?

Boleh, satu bagi setiap log masuk. Cipta sesi sambungan untuk setiap akaun dengan external_ref yang sama, dan GET /channels?external_ref= menyenaraikan semuanya untuk pelanggan itu.

Bolehkah aplikasi saya menjadualkan Instagram Stories?

Boleh. Tetapkan ig_type kepada STORIES dengan satu imej atau video dan masa publish_at, dan barisan akan menerbitkannya pada masa itu.

Berapa kos easyCoexistence bagi setiap akaun Instagram?

Setiap akaun yang disambungkan berharga US$ 9 hingga US$ 0.75 sebulan, mengikut julat jumlah sambungan anda, dengan 3 hari percubaan percuma.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada