Da commento a DMAPI

Trasforma i commenti “mandami il link” in messaggi privati

Crea un’automazione e FoPost osserva i commenti sui tuoi account Instagram e Facebook. Quando un commento corrisponde, chi l’ha scritto riceve una risposta privata nei suoi DM, trattenuta prima per la tua approvazione, salvo diversa indicazione.

Ottieni la tua chiave APILeggi la documentazione
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" }]
    }
  }'

Corrispondenza di parole chiave

Una qualsiasi o tutte fino a 20 parole chiave, solo sui commenti o su ogni tipo di messaggio.

Prima l’approvazione

Le nuove automazioni trattengono ogni risposta finché una persona non la approva prima dell’invio.

Una volta per commento

Un commento viene riservato prima dell’invio del DM, quindi non riceve mai due risposte.

Trigger

Decidi quali commenti ricevono un messaggio

Il trigger inbox_message scatta su nuovi commenti, menzioni, risposte, DM, risposte alle storie e recensioni. Restringilo con parole chiave, tipi di messaggio, account specifici o post specifici, e scegli se rispondere solo ai follower o solo al primo messaggio di una persona. Ogni automazione viene eseguita al massimo 3 volte al giorno per impostazione predefinita; porta maxRunsPerDay fino a 20.

Leggi il riferimento del trigger
Automazioni eseguite su pianificazione, su un feed e su più reti

Per post

postIds limita l’automazione ai commenti sotto i post che indichi.

Solo follower

followersOnly salta chi commenta senza seguire l’account.

Limite giornaliero

maxRunsPerDay impedisce a un post virale di inviare centinaia di messaggi.

Messaggio

Una risposta privata, scritta a modo tuo

Il passaggio send_message con channel impostato su private invia a chi ha commentato un DM tramite la risposta privata di Meta. Usa {{contact.name}} e {{message.text}} nel testo, aggiungi fino a 3 pulsanti link o 13 risposte rapide e allega un link che riceve tag UTM e un reindirizzamento conteggiato. Meta accetta una risposta privata solo entro 7 giorni dal commento, quindi i commenti più vecchi falliscono con questo motivo.

Vedi il passaggio send_message
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
}

Prova a vuoto

Visualizza in anteprima il messaggio su un commento recente. Non viene inviato né creato nulla.

Link tracciati

I clic vengono conteggiati e l’URL contiene utm_medium=dm.

Finestra di 7 giorni

Il limite di Meta sulle risposte private, verificato prima di ogni invio.

Controllo

Approva, metti in pausa e verifica ogni esecuzione

A meno che un passaggio imposti requireApproval su false, ogni risposta resta in attesa in GET /v1/inbox/approvals finché qualcuno la approva o la rifiuta. Attiva e disattiva l’automazione con una sola chiamata e leggi la cronologia delle esecuzioni per vedere cosa è scattato, cosa è in attesa e cosa è fallito.

Inizia a sviluppare
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 }

Cronologia delle esecuzioni

GET /v1/automations/:id/runs con stato, ora di inizio ed eventuale errore.

Riesecuzione

Riesegui un’esecuzione passata dopo aver corretto il messaggio o il trigger.

Versioni

Ogni modifica salvata è una versione che puoi visualizzare o ripristinare.

Da commento a DM: le risposte alle tue domande

Quali reti supportano da commento a DM?

Instagram e Facebook. Le risposte private ai commenti sono una funzione di Meta e le altre reti non offrono un equivalente. La stessa automazione può comunque rispondere pubblicamente ai commenti sulle altre reti con channel impostato su same.

La stessa persona può ricevere il messaggio due volte?

Non per lo stesso commento. Il commento viene contrassegnato prima dell’invio del DM e un’automazione scatta una sola volta per commento, quindi nuovi tentativi ed esecuzioni ripetute non inviano nulla di nuovo.

Parte senza che nessuno controlli?

Non per impostazione predefinita. Un passaggio send_message creato senza requireApproval trattiene ogni risposta in attesa di approvazione. Imposta requireApproval su false nel passaggio quando vuoi che parta da solo.

Cosa succede ai commenti più vecchi di 7 giorni?

Meta non consente una risposta privata dopo 7 giorni, quindi l’esecuzione fallisce con questo motivo e non viene inviato nulla.

Di quali scope della chiave API ho bisogno?

Creare e gestire le automazioni richiede lo scope automations. Elencare e approvare le risposte trattenute usa lo scope inbox.

Posso avviare un’automazione dal mio sistema?

Sì, con un trigger diverso. Un’automazione con il trigger api_webhook viene eseguita quando fai POST su /v1/automations/:id/trigger con il suo secret nell’header x-automation-secret.

Sviluppa oggi con Da commento a DM

Iniziare è gratis e l'API completa è inclusa. Crea una chiave e fai la tua prima chiamata in pochi minuti.

Ottieni la tua chiave API