Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Müşterilerinizin Instagram'ı uygulamanıza nasıl bağlamasına izin verirsiniz

Arka ucunuz easyCoexistence'ın POST /connect-sessions uç noktasını channel değeri instagram ile çağırır ve müşteriyi döndürülen url'ye yönlendirir. Orada İşletme veya Creator hesabıyla Instagram Login üzerinden oturum açar. Müşteri channel_id ile birlikte redirect_url adresinize döner. GET /channels/{id}?credentials=1 çağrısı graph.instagram.com için bir token döndürür, böylece uygulamanız gönderi yayımlayabilir, yorumları okuyabilir ve DM'lere yanıt verebilir.

100 posts

Bir Instagram hesabının kayan 24 saat içinde API üzerinden yayımlayabileceği gönderi sayısı; karusel tek gönderi sayılır.

JPEG

Meta'nın API üzerinden Instagram'a yayımlamada desteklediği tek görsel biçim.

24 hours

Çoğu kullanıcı eylemi için, bir kişinin Instagram DM'ine yanıt vermenin standart süresi; kişinin önce yazması gerekir.

1 private reply

Bir hesabın özel yanıt yoluyla yorum yapana gönderebileceği mesajlar, yorumdan itibaren 7 gün içinde.

1 hour

Bir easyCoexistence bağlantı linkinin, oturumu sona ermeden önce ne kadar süre geçerli kaldığı.

Müşteri bağlanmak için ne yapar?

Tek bir düğmeye basar. Uygulamanız, channel değeri instagram olan, bir redirect_url içeren ve müşterinizin kimliğini external_ref olarak taşıyan oturumu oluşturur, ardından müşteriyi oturumun url'sine yönlendirir. Barındırılan sayfada markanızın adı ve 'Instagram ile devam et' düğmesi görünür. Bu düğme aynı sekmede Instagram'ın kendi oturum açma ekranını açar, bu yüzden telefonlarda da çalışır. Müşteri erişimi onaylar ve status=connected ile channel_id değerini taşıyan redirect_url adresinize döner. Arka ucunuz bunu GET /connect-sessions/{id} ile doğrular.

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

Hangi Instagram hesapları bağlanabilir?

Profesyonel hesaplar, yani İşletme veya Creator hesapları; Meta'nın Instagram API'si bu hesaplara hizmet verir. easyCoexistence kullanan başka bir hizmete zaten bağlı bir hesap reddedilir ve oturumun last_error alanı bunu belirtir. Müşteri önce o hizmetten hesabı kaldırır ya da başka bir hesapla oturum açar. DM'ler için hesabın ayrıca Instagram uygulamasında Mesajlara erişime izin ver seçeneğini açması gerekir. Yol için Instagram bağlantı kılavuzuna bakın.

Uygulamanız hangi token'ı alır?

graph.instagram.com/v25.0 için bir Instagram kullanıcı token'ı alır. Bu token, GET /channels/{id}?credentials=1 çağrısından, hesabın Instagram kimliği olan account_id_on_meta ile birlikte gelir. easyCoexistence, 60 günü dolmadan çok önce token'ı yeniler ve yenileme yeni bir token verir. Bu yüzden her işin başında kimlik bilgilerini çekin, tek bir kopyayı saklamak yerine.

Uygulamanız hesaba nasıl yayımlar?

POST /channels/{id}/posts ile. ig_type değeri IMAGE, CAROUSEL, REELS veya STORIES olabilir. Bu değeri bırakırsanız medyadan otomatik belirlenir: birden çok dosya karusel oluşturur, tek video ise Reel olur. Buradaki karusel 2 ila 10 öğe alır, görseller JPEG olmalıdır, metin en fazla 2.200 karakter olabilir ve bir Instagram gönderisinin link alanı yoktur. publish_at alanını göndermezseniz gönderi hemen çıkar. Gönderirseniz o zamanda yayımlanır ve en fazla 90 gün sonrasına kadar planlanabilir.

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

Yorumlar ve DM'ler uygulamanıza nasıl ulaşır?

Bir hedef tanımladığınızda. URL'nizle birlikte PUT /channels/{id}/webhook çağrısı yaptığınızda, o hesabın imza sırrı döner. Bundan sonra hesabın yorumları, bahsetmeleri ve DM'leri gelir gelmez iletilir ve X-EC-Signature ile imzalanır. Gövde; platform, account_id, external_id ve Meta'nın webhook girişini olduğu gibi taşır. Yorumlar ve bahsetmeler changes içinde, DM'ler ise messaging içinde gelir.

Uygulamanız yorumlara ve DM'lere nasıl yanıt verir?

Meta'nın graph.instagram.com üzerindeki Instagram API'si ile, müşterinin token'ıyla. Böylece her yanıt müşterinin hesabından gider:

  • Yoruma yanıt: message alanıyla birlikte POST /<IG_COMMENT_ID>/replies.
  • DM'e yanıt: POST /<IG_ID>/messages ile, recipient alanına kişinin kimliğini ve mesaj metnini yazarak, kişinin son mesajından itibaren 24 saat içinde.
  • Yoruma özel yanıt: aynı messages uç noktası, recipient alanında comment_id ile, her yorum için bir kez, yorumdan itibaren 7 gün içinde.
  • Yorumu gizleyin veya silin: /<IG_COMMENT_ID> üzerinde POST veya DELETE.

Müşterinin erişimi sona erdiğinde ne olur?

Olay URL'niz, Instagram token'ı reddettiğinde ya da hesap sahibi Instagram ayarlarından erişimi geri çektiğinde channel.disconnected olayını alır. Müşteri için yeni bir bağlantı oturumu hesabı geri getirir. Bağlantıyı kendi tarafınızdan sonlandırmak için DELETE /channels/{id} çağrısı erişimi Meta tarafında iptal eder ve kuyrukta bekleyen gönderileri iptal eder. Faturalandırma döngünün sonunda durur.

Yaygın hatalar

  • Instagram'a PNG ya da WebP görseli göndermek. Meta yalnızca JPEG yayımlar, bu yüzden gönderi kuyruğa alınmadan reddedilir. Görselleri önce dönüştürün.
  • Bir Instagram gönderisine link alanı eklemek. Instagram gönderileri link taşımaz, istek reddedilir. URL'yi metnin içine koyun.
  • 24 saatten eski DM'lerde Yanıtla düğmesi göstermek. Meta, yanıtı kişinin son mesajının açtığı süre penceresi içinde izin verir.
  • Aynı yoruma ikinci bir özel yanıt göndermek. Meta yorum başına bir izin verir, takip mesajı ise kişi yanıt verene kadar bekler.
Bunu EasyCoexistence'la yapmak

easyCoexistence, müşterilerinizin Instagram hesaplarını tek bir barındırılan oturum açma ile uygulamanıza bağlamasına olanak tanır. Ardından arka ucunuza yenilenen bir token, bir gönderi uç noktası ve yorum ile DM'lerin webhook üzerinden iletilmesini sunar. Her bağlantı 7/24 izlenir. Aynı çağrılar WhatsApp, Facebook, TikTok, YouTube, LinkedIn ve diğer kanallar için de geçerlidir. Bağlantı başına aylık US$ 9 ile US$ 0,75 arasında, bağlantı sayısı arttıkça düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

Müşterilerin Instagram hesaplarını bağlamak için kendi Meta uygulamanızın olması gerekir mi?

Hayır. Müşteriler easyCoexistence'ın uygulaması üzerinden oturum açar. Arka ucunuz ise kimlik bilgileri çağrısı üzerinden Meta'nın Instagram API'si için token'ı alır.

Bir müşteri birden fazla Instagram hesabı bağlayabilir mi?

Evet, her oturum açmada bir hesap. Aynı external_ref ile her hesap için bir bağlantı oturumu oluşturun. GET /channels?external_ref= o müşteri için hepsini listeler.

Uygulamam Instagram Hikayelerini planlayabilir mi?

Evet. ig_type değerini bir görsel veya videoyla birlikte STORIES yapın ve bir publish_at zamanı verin. Kuyruk onu o zamanda yayımlar.

easyCoexistence Instagram hesabı başına ne kadar tutar?

Bağlanan her hesap, toplam bağlantılarınızın bandına göre aylık US$ 9 ile US$ 0,75 arasında tutar. İlk 3 gün ücretsizdir.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi