Yorumdan DM'eAPI

“Linki gönder” yorumlarını özel mesajlara çevirin

Bir otomasyon oluşturun, FoPost Instagram ve Facebook hesaplarınızdaki yorumları izlesin. Bir yorum eşleştiğinde yorum yapan kişi DM'inde özel bir yanıt alır; aksi belirtmediğiniz sürece yanıt önce onayınız için bekletilir.

POST /v1/automations
curl -X POST https://api.fopost.com/v1/automations \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": "9b2f6c1e-...",
    "name": "Price comments to DM",
    "triggerType": "inbox_message",
    "triggerConfig": { "keywords": ["price", "link"], "types": ["comment"], "maxRunsPerDay": 20 },
    "graph": {
      "nodes": [
        { "id": "t1", "kind": "trigger" },
        { "id": "m1", "kind": "send_message", "config": {
          "channel": "private",
          "text": "Hi {{contact.name}}, here is the link you asked for.",
          "buttons": [{ "title": "Shop now", "url": "https://yourbrand.com/shop" }]
        } }
      ],
      "edges": [{ "id": "e1", "source": "t1", "target": "m1" }]
    }
  }'

Anahtar kelime eşleşmesi

En fazla 20 anahtar kelimeden herhangi biri veya tümü; yalnızca yorumlarda ya da her mesaj türünde.

Önce onay

Yeni otomasyonlar her yanıtı, gönderilmeden önce bir kişinin onaylaması için bekletir.

Yorum başına bir kez

Yorum, DM gitmeden önce ayrılır; böylece asla iki kez yanıtlanmaz.

Tetikleyici

Hangi yorumların mesaj alacağına karar verin

inbox_message tetikleyicisi yeni yorumlarda, bahsetmelerde, yanıtlarda, DM'lerde, hikaye yanıtlarında ve değerlendirmelerde çalışır. Anahtar kelimeler, mesaj türleri, belirli hesaplar veya belirli gönderilerle daraltın; yalnızca takipçilere ya da yalnızca bir kişinin ilk mesajına yanıt vermeyi seçin. Her otomasyon varsayılan olarak günde en fazla 3 kez çalışır; maxRunsPerDay değerini 20'ye kadar artırın.

Tetikleyici referansını okuyun
Zamanlanmış, bir akışta ve ağlar arasında çalışan otomasyonlar

Gönderi bazında

postIds, otomasyonu adını verdiğiniz gönderilerin altındaki yorumlarla sınırlar.

Yalnızca takipçiler

followersOnly, hesabı takip etmeyen yorumcuları atlar.

Günlük üst sınır

maxRunsPerDay, viral bir gönderinin yüzlerce mesaj göndermesini önler.

Mesaj

Sizin tarzınızda yazılmış özel bir yanıt

channel değeri private olan send_message adımı, yorum yapan kişiye Meta'nın özel yanıtı üzerinden DM gönderir. Metinde {{contact.name}} ve {{message.text}} kullanın, en fazla 3 bağlantı düğmesi veya 13 hızlı yanıt ekleyin ve UTM etiketi alan, sayılan bir yönlendirmeli bağlantı ekleyin. Meta özel yanıtı yalnızca yorumdan sonraki 7 gün içinde kabul eder; daha eski yorumlar bu nedenle başarısız olur.

send_message adımına bakın
POST /v1/automations/:id/dry-run
curl -X POST https://api.fopost.com/v1/automations/f2b7d9a4-.../dry-run \
  -H "X-API-Key: $API_KEY"

{
  "would_defer": false,
  "approval_mode": false,
  "steps": [
    { "node_id": "t1", "action_type": "trigger", "status": "completed", ... },
    { "position": 1, "node_id": "m1", "action_type": "send_message", "status": "completed",
      "handle": "out", "error_message": null,
      "output": { "messagePreview": "Hi Jordan, here is the link you asked for.", "channel": "private" } }
  ],
  "drafts": [],
  "total_delay_ms": 0,
  "credits_charged": 0
}

Deneme çalıştırması

Mesajı yakın tarihli bir yorum üzerinde önizleyin. Hiçbir şey gönderilmez veya oluşturulmaz.

İzlenen bağlantılar

Tıklamalar sayılır ve URL utm_medium=dm taşır.

7 günlük pencere

Meta'nın özel yanıt sınırı, her gönderimden önce kontrol edilir.

Kontrol

Her çalıştırmayı onaylayın, duraklatın ve denetleyin

Bir adım requireApproval değerini false yapmadıkça, her yanıt biri onaylayana veya reddedene kadar GET /v1/inbox/approvals içinde bekler. Otomasyonu tek çağrıyla açıp kapatın ve neyin tetiklendiğini, neyin beklediğini ve neyin başarısız olduğunu görmek için çalıştırma geçmişini okuyun.

Geliştirmeye başlayın
POST /v1/automations/:id/toggle
curl "https://api.fopost.com/v1/inbox/approvals?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY"

curl -X POST https://api.fopost.com/v1/inbox/approvals/:id/approve -H "X-API-Key: $API_KEY"

curl -X POST https://api.fopost.com/v1/automations/f2b7d9a4-.../toggle -H "X-API-Key: $API_KEY"

{ "id": "f2b7d9a4-...", "active": false }

Çalıştırma geçmişi

GET /v1/automations/:id/runs; durum, başlangıç zamanı ve varsa hata ile.

Yeniden oynatma

Mesajı veya tetikleyiciyi düzelttikten sonra geçmiş bir çalıştırmayı yeniden çalıştırın.

Sürümler

Kaydedilen her değişiklik, görüntüleyebileceğiniz veya geri yükleyebileceğiniz bir sürümdür.

Yorumdan DM'e hakkında sorular ve yanıtlar

Hangi ağlar yorumdan DM'e özelliğini destekliyor?

Instagram ve Facebook. Yorumlara özel yanıt bir Meta özelliğidir; diğer ağlarda bir eşdeğeri yoktur. Aynı otomasyon, channel değeri same olarak diğer ağlarda yorumlara yine herkese açık yanıt verebilir.

Aynı kişi mesajı iki kez alabilir mi?

Aynı yorum için hayır. Yorum, DM gönderilmeden önce işaretlenir ve bir otomasyon yorum başına yalnızca bir kez çalışır; yeniden denemeler ve tekrarlanan çalıştırmalar yeni bir şey göndermez.

Kimse kontrol etmeden gönderiyor mu?

Varsayılan olarak hayır. requireApproval olmadan oluşturulan bir send_message adımı her yanıtı onay için bekletir. Kendi başına göndermeye hazır olduğunuzda adımda requireApproval değerini false yapın.

7 günden eski yorumlara ne olur?

Meta, 7 günden sonra özel yanıta izin vermez; bu yüzden çalıştırma bu nedenle başarısız olur ve hiçbir şey gönderilmez.

Hangi API anahtarı kapsamlarına ihtiyacım var?

Otomasyon oluşturmak ve yönetmek için automations kapsamı gerekir. Bekletilen yanıtları listelemek ve onaylamak inbox kapsamını kullanır.

Bir otomasyonu kendi sistemimden başlatabilir miyim?

Evet, farklı bir tetikleyiciyle. api_webhook tetikleyicili bir otomasyon, /v1/automations/:id/trigger adresine x-automation-secret başlığında gizli anahtarıyla POST yaptığınızda çalışır.

Yorumdan DM'e 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