Yorumlar ve Gelen Kutusu API'siAPI

Her yorum ve mesaj, kodla yönetebileceğiniz tek bir kuyrukta

FoPost, her bağlı hesabın yorumlarını ve doğrudan mesajlarını tek bir gelen kutusunda toplar. Listeleyin, okunmamışları sayın, öğeleri ele alındı olarak işaretleyin ve yanıtlayın; hepsi panelinizin kullandığı API'nin aynısıyla.

API Anahtarını Al Belgeleri Okuyun

GET /v1/inbox

curl "https://api.fopost.com/v1/inbox?workspace_id=9b2f6c1e-...&state=unread" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "1f8b6a37-...", "type": "comment", "state": "unread", "platform": "instagram", "author_name": "Customer", "author_handle": "customer", "text": "Does this ship to Canada?", "post": { "id": "7d3e0a52-...", "title": "Launch day" }, "platform_created_at": "2026-08-29T14:02:11Z", "can_reply": true, "account": { "id": "4a71d80b-...", "platform": "instagram", "username": "yourbrand" }, "workspace_id": "9b2f6c1e-..." },
    { "id": "2c9d4e81-...", "type": "dm", "state": "unread", "platform": "facebook", "author_name": "Jordan P.", "author_handle": null, "text": "Hi, I need help with an order.", "post": null, "platform_created_at": "2026-08-29T13:48:30Z", "can_reply": true, "account": { "id": "c30e9f12-...", "platform": "facebook", "username": "yourbrand" }, "workspace_id": "9b2f6c1e-..." }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 2, "total_pages": 1 }
}

Tek liste

Tüm hesaplardan yorumlar ve mesajlar, en yeniden eskiye, aynı alanlarla.

Okunmamış sayısı

Rozet sayısı için tek çağrı; çalışma alanı başına veya hepsinde birden.

Koddan yanıtlayın

Bir yorumu veya mesajı yanıtlayın, yanıt ağa geri gider.

Oku

Gelen konuşmaları doğru yere yönlendirin

Gelen kutusunu belirli aralıklarla ya da istediğiniz zaman sorgulayın; türe, hesaba veya duruma göre filtreleyin ve her öğeyi destek masanıza, sohbet kanalınıza veya bir kişiye iletin. Varsa her öğe ait olduğu gönderiye bağlanır.

Gelen Kutusu Referansını Okuyun

GET /v1/inbox/unread-count

curl "https://api.fopost.com/v1/inbox/unread-count?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY"

{ "count": 14 }

Filtrele

Türe, hesaba, platforma veya okunma durumuna göre, sayfalamayla.

Gönderiye bağlı

Yorumlar ait oldukları gönderiyi taşır, böylece onları analitik verilerle birleştirebilirsiniz.

Gelen kutusu hesapları

GET /v1/inbox/accounts, gelen kutusunu hangi bağlı hesapların beslediğini listeler.

Yanıtla

Müşteriye sorduğu yerde yanıt verin

Bir gelen kutusu öğesine POST ile yanıt gönderin; yanıt, kaynak ağda bağlı hesap üzerinden bir yorum yanıtı veya doğrudan mesaj olarak paylaşılır. İki sistemin asla aynı öğeyi ele almaması için öğeleri PATCH ile okundu, çözüldü veya ertelendi olarak işaretleyin.

Yanıt Uç Noktasını Görün

POST /v1/inbox/:id/reply

curl -X POST https://api.fopost.com/v1/inbox/1f8b6a37-.../reply \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Yes, we ship to Canada. Delivery takes 3 to 5 days." }'

curl -X PATCH https://api.fopost.com/v1/inbox/1f8b6a37-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "state": "read" }'

Yerel yanıt

Yorum yanıtları ve DM'ler ağın kendi API'si üzerinden gönderilir.

Durum güncellemeleri

okundu, çözüldü veya ertelendi; böylece ele alınan öğeler kuyruktan düşer.

Açık gönderimler

Hiçbir şey kendiliğinden yanıt vermez. Her giden mesaj sizin yaptığınız bir istektir.

Senkronize et

Gerektiğinde güncel, gerekmediğinde sessiz

Gelen kutusu her bağlı hesap için düzenli aralıklarla senkronize olur. En son veriye hemen ihtiyacınız olduğunda çalışma alanı için yenileme uç noktasını çağırın ve tekrar okuyun. Çalışma alanı kapsamı sayesinde bir ajans anahtarı yalnızca kendi müşterisinin konuşmalarını görür.

Geliştirmeye Başlayın

Tek bir çalışma alanında tüm ağlardaki bağlı hesaplar

İsteğe bağlı yenileme

POST /v1/inbox/refresh, çalışma alanındaki her hesap için en güncel verileri çeker.

Zamanlanmış senkronizasyon

Arka plan senkronizasyonu, sizin hiçbir çağrı yapmanıza gerek kalmadan listeyi güncel tutar.

Çalışma alanına özel

Yazar kimliği ve mesaj metni asla ait oldukları çalışma alanının dışına çıkmaz.

Yorumlar ve Gelen Kutusu API'si hakkında sorular ve yanıtlar

Gelen kutusunu hangi ağlar besliyor?

Yorumları veya mesajları API'si üzerinden sunan bir ağdaki her bağlı hesap. GET /v1/inbox/accounts, hesaplarınızdan hangilerinin dahil olduğunu tam olarak söyler.

Doğrudan mesajları yanıtlayabilir miyim?

Evet; ağın izin verdiği ve hesabın mesajlaşma izni verdiği durumlarda. Bir ağ izin vermediğinde yanıt uç noktası nedeni belirten bir hata döndürür.

Yeni yorumlar ne kadar hızlı görünür?

Arka plan senkronizasyonu her hesap için düzenli aralıklarla çalışır. En yeni öğelere hemen ihtiyacınız olduğunda okumadan önce yenileme uç noktasını çağırın.

API otomatik yanıt verebilir mi?

Hayır. API sizden bir istek gelmeden asla yanıt göndermez. Otomatik yanıtlar oluşturursanız, gönderme kararı sizin kodunuzda olur.

Yazarın profilini alıyor muyum?

Ağın sunduğu şekliyle görünen adı ve kullanıcı adını, ayrıca orijinal öğeye bir bağlantı alırsınız. Veriler, hesabın ait olduğu çalışma alanının içinde kalır.

İstek sınırı var mı?

Evet, anahtar başına dakikada 100 istek. Sorgulama için okunmamış sayısını kullanın ve tam listeyi yalnızca değiştiğinde çekin.

Yorumlar ve Gelen Kutusu API'si ile bugün geliştirmeye başlayın

Başlamak ücretsizdir ve eksiksiz API dahildir. Bir anahtar oluşturun ve ilk çağrınızı dakikalar içinde yapın.

API Anahtarını Al