Her ağda doğrudan mesajlar, kendi kodunuzdan
FoPost, bağlı hesaplarınızdaki her DM konuşmasını tek bir yerde tutar. Konuşmaları listeleyin, yenilerini başlatın, kişilerinizin bir segmentine tek seferde mesaj gönderin veya bir mesaj dizisini günlere yayın; hepsi aynı API anahtarıyla.
curl "https://api.fopost.com/v1/inbox/conversations?workspace_id=9b2f6c1e-..." \
-H "X-API-Key: $API_KEY"
{
"data": [
{
"workspace_id": "9b2f6c1e-...",
"account_id": "4a71d80b-...",
"conversation_id": "t_1029384756",
"message_count": 6,
"unread_count": 2,
"last_message_at": "2026-11-10T16:42:08Z",
"last_message_text": "Is the large size back in stock?",
"last_message_outbound": false,
"participant": { "name": "Jordan P.", "handle": "jordanp", "avatar_url": "https://..." },
"account": { "id": "4a71d80b-...", "platform": "instagram", "username": "yourbrand" }
}
],
"meta": { "page": 1, "per_page": 25, "total": 1, "total_pages": 1 }
}Tek konuşma listesi
Bağlı her hesaptaki tüm DM konuşmaları, en yenisi başta.
Broadcast'ler
Filtrelenmiş bir kişi grubunun mevcut konuşmalarına tek bir mesaj.
Sequence'ler
Her biri bir öncekinden belirli saat sonra gönderilen bir mesaj serisi.
Bir konuşmayı okuyun, yanıtlayın ya da yenisini açın
Mevcut bir konuşmaya POST /v1/inbox/:id/reply ile yanıt verin. X, Mastodon, Reddit ve Slack'te kullanıcı adıyla yeni konuşma başlatın ya da bir Instagram veya Facebook yorumunu özelden yanıtlamak için comment_id gönderin. Facebook ve Instagram'da yazıyor göstergesi de gösterebilir, Messenger'da bir konuşmayı başka bir uygulamaya devredip geri alabilirsiniz.
Konuşmalar referansını okuyuncurl -X POST https://api.fopost.com/v1/inbox/conversations \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"account_id": "4a71d80b-...",
"handle": "jordanp",
"text": "Thanks for the order. Your tracking link is on its way."
}'
{ "conversation_id": "t_1029384756", "item": { "id": "2c9d4e81-...", "type": "dm", ... } }Metin ve medya
Ağın izin verdiği yerlerde kitaplığınızdan en fazla 10 medya kimliği eklenebilir.
Yazıyor ve devir
Meta konuşmaları için POST /v1/inbox/conversations/:id/typing ve /handover.
X Chat
Şifreli X konuşmaları şifreli metin olarak iletilir; anahtar tarayıcıda kalır.
Platform kurallarını çiğnemeden bir segmente mesaj gönderin
Bir broadcast, hesabınızın bir kişi grubuyla zaten sahip olduğu konuşmalara düşer; ağ, etiket, kaynak veya özel alana göre filtrelenir. Facebook, Instagram ve WhatsApp, kişinin son mesajından itibaren yalnızca 24 saat içinde işletme mesajına izin verir; bu pencerenin dışındaki alıcılar bir gerekçeyle atlanır, asla denenmez. WhatsApp'ta onaylı bir şablon bu pencerenin ötesine geçebilir.
Broadcast referansına bakıncurl -X POST https://api.fopost.com/v1/broadcasts \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": "9b2f6c1e-...",
"account_id": "4a71d80b-...",
"name": "Restock, November",
"text": "The large size is back in stock this week.",
"audience": { "platforms": ["instagram"], "label_ids": ["d41e7a90-..."] }
}'
curl -X POST https://api.fopost.com/v1/broadcasts/8e2a5c13-.../send -H "X-API-Key: $API_KEY"
{ "id": "8e2a5c13-...", "status": "sending", "recipients": 212 }Şimdi veya sonra gönderin
Sıraya almak için scheduled_at ayarlayın ya da gönderilmeden önce iptal edin.
Alıcı bazında sonuç
GET /v1/broadcasts/:id/recipients gönderildi, atlandı veya başarısız olduğunu ve nedenini gösterir.
Yalnızca bir kez gönderilir
Her alıcı göndermeden önce ayrılır, bu yüzden yeniden deneme asla iki kez mesaj göndermez.
Günlere yayılan takibi otomatik yapın
Sequence, her biri bir mesaj ve bir önceki adımdan sonraki saat cinsinden gecikmeden oluşan, en fazla 20 adımlık bir listedir. Kişileri kimlikle veya broadcast'in kullandığı aynı kitle filtresiyle kaydedin ve istediğiniz zaman kayıttan çıkarın. Mesajlaşma penceresinin dışına düşen adım atlanır ve sequence devam eder.
Sequence referansına bakıncurl -X POST https://api.fopost.com/v1/sequences/5b9c2e40-.../enroll \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{ "contact_ids": ["a7f3c2d1-..."] }'
{ "id": "5b9c2e40-...", "enrolled": 1 }İstediğiniz an duraklatın
status değerini paused yapın; devam ettirene kadar başka adım gönderilmez.
Kayıttan çıkarma
POST /v1/sequences/:id/unenroll bir kişiyi anında durdurur.
Kayıt sayıları
Sequence başına etkin, tamamlanan, durdurulan ve başarısız.
Kiminle konuştuğunuzu bilin
Hesaplarınıza mesaj atan kişiler otomatik olarak kişi olur. Elle daha fazlasını ekleyin ya da platform ve handle sütunu olan, en fazla 5.000 satırlık bir CSV içe aktarın. Çalışma alanı başına en fazla 50 özel alan tanımlayın (metin, sayı, tarih, seçim veya evet/hayır) ve broadcast'leri ile sequence'leri bunlara göre filtreleyin.
Geliştirmeye başlayın
CSV içe aktarma
POST /v1/contacts/import oluşturulan, birleştirilen ve atlanan satırları nedenleriyle döndürür.
Özel alanlar
Bir alan anahtarıyla eşleşen sütunlar içe aktarmada doldurulur.
Tam geçmiş
GET /v1/contacts/:id/conversations her kişinin ne yazdığını listeler.
Mesajlaşma API'si hakkında sorular ve yanıtlar
Hangi ağlara mesaj gönderebilirim?
Mesajlaşma penceresi nedir?
Hangi API anahtarı kapsamlarına ihtiyacım var?
Broadcast bize hiç yazmamış kişilere mesaj gönderebilir mi?
Ben istemeden bir şey gönderiliyor mu?
Hız sınırı var mı?
Mesajlaşma 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ızı alın