Comments to DMAPI

Maak van “stuur me de link”-reacties privéberichten

Maak één automatisering en FoPost houdt reacties op je Instagram- en Facebook-accounts in de gaten. Als een reactie overeenkomt, krijgt de reageerder een privéantwoord in zijn DM's, eerst vastgehouden voor jouw goedkeuring tenzij je anders aangeeft.

Vraag je API-sleutel aanLees de documentatie
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" }]
    }
  }'

Trefwoordmatch

Een of alle van maximaal 20 trefwoorden, alleen op reacties of op elk berichttype.

Eerst goedkeuring

Nieuwe automatiseringen houden elk antwoord vast tot iemand het goedkeurt voordat het wordt verstuurd.

Eén keer per reactie

Een reactie wordt geclaimd voordat de DM wordt verstuurd, dus ze wordt nooit twee keer beantwoord.

Trigger

Bepaal welke reacties een bericht krijgen

De inbox_message-trigger gaat af bij nieuwe reacties, vermeldingen, antwoorden, DM's, storyreacties en reviews. Beperk hem met trefwoorden, berichttypen, specifieke accounts of specifieke posts, en kies ervoor alleen volgers te beantwoorden of alleen het eerste bericht van iemand. Elke automatisering draait standaard maximaal 3 keer per dag; verhoog maxRunsPerDay tot 20.

Lees de naslag over triggers
Automatiseringen die volgens schema draaien, op een feed en over netwerken heen

Per post

postIds beperkt de automatisering tot reacties onder de posts die je noemt.

Alleen volgers

followersOnly slaat reageerders over die het account niet volgen.

Dagelijks maximum

maxRunsPerDay voorkomt dat een virale post honderden berichten verstuurt.

Bericht

Een privéreactie, op jouw manier geschreven

De send_message-stap met channel ingesteld op private stuurt de reageerder een DM via Meta’s privéreactie. Gebruik {{contact.name}} en {{message.text}} in de tekst, voeg tot 3 linkknoppen of 13 snelle antwoorden toe en voeg een link toe die UTM-tags krijgt en een getelde redirect. Meta accepteert een privéreactie alleen binnen 7 dagen na de reactie, dus oudere reacties mislukken met die reden.

Bekijk de send_message-stap
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
}

Dry run

Bekijk een voorbeeld van het bericht op basis van een recente reactie. Er wordt niets verstuurd of aangemaakt.

Gevolgde links

Klikken worden geteld en de URL bevat utm_medium=dm.

Venster van 7 dagen

Meta’s limiet voor privéreacties, gecontroleerd vóór elke verzending.

Beheer

Keur goed, pauzeer en controleer elke run

Tenzij een stap requireApproval op false zet, wacht elk antwoord in GET /v1/inbox/approvals tot iemand het goedkeurt of afwijst. Schakel de automatisering met één aanroep in en uit, en lees de runhistorie om te zien wat is afgegaan, wat wacht en wat is mislukt.

Begin met bouwen
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 }

Runhistorie

GET /v1/automations/:id/runs met status, starttijd en eventuele fout.

Opnieuw afspelen

Draai een eerdere run opnieuw nadat je het bericht of de trigger hebt aangepast.

Versies

Elke opgeslagen wijziging is een versie die je kunt bekijken of herstellen.

Vragen over Comments to DM, beantwoord

Welke netwerken ondersteunen reactie naar DM?

Instagram en Facebook. Privéreacties op reacties zijn een Meta-functie, en andere netwerken bieden geen equivalent. Dezelfde automatisering kan op andere netwerken nog wel openbaar op reacties antwoorden met channel ingesteld op same.

Kan dezelfde persoon het bericht twee keer krijgen?

Niet voor dezelfde reactie. De reactie wordt gemarkeerd voordat de DM wordt verstuurd en een automatisering gaat maar één keer af per reactie, dus nieuwe pogingen en herhaalde runs versturen niets nieuws.

Wordt er verstuurd zonder dat iemand controleert?

Niet standaard. Een send_message-stap die zonder requireApproval is aangemaakt, houdt elk antwoord vast voor goedkeuring. Zet requireApproval op de stap op false als je klaar bent om het zelfstandig te laten versturen.

Wat gebeurt er met reacties ouder dan 7 dagen?

Meta staat na 7 dagen geen privéreactie meer toe, dus de run mislukt met die reden en er wordt niets verstuurd.

Welke API-sleutelscopes heb ik nodig?

Voor het aanmaken en beheren van automatiseringen is de scope automations nodig. Voor het tonen en goedkeuren van vastgehouden antwoorden geldt de scope inbox.

Kan ik een automatisering starten vanuit mijn eigen systeem?

Ja, met een andere trigger. Een automatisering met de api_webhook-trigger draait wanneer je een POST doet naar /v1/automations/:id/trigger met het geheim in de x-automation-secret-header.

Bouw vandaag nog op de Comments to DM

Starten is gratis en de volledige API is inbegrepen. Maak een sleutel aan en doe binnen enkele minuten je eerste aanroep.

Vraag je API-sleutel aan