댓글을 DM으로API

“링크 보내주세요” 댓글을 비공개 메시지로

자동화를 하나 만들면 FoPost가 Instagram과 Facebook 계정의 댓글을 지켜봅니다. 댓글이 조건에 맞으면 작성자의 DM으로 비공개 답장이 전송되며, 별도로 설정하지 않으면 먼저 승인 대기 상태로 보류됩니다.

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" }]
    }
  }'

키워드 일치

최대 20개 키워드 중 하나 또는 전부와 일치하며, 댓글만 또는 모든 메시지 유형을 대상으로 합니다.

먼저 승인

새 자동화는 각 답장을 보류하고, 담당자가 승인한 뒤에 발송합니다.

댓글당 한 번

DM을 보내기 전에 댓글을 선점하므로 같은 댓글에 두 번 답하지 않습니다.

트리거

어떤 댓글에 메시지를 보낼지 정하세요

inbox_message 트리거는 새 댓글, 멘션, 답글, DM, 스토리 답장, 리뷰에서 실행됩니다. 키워드, 메시지 유형, 특정 계정, 특정 게시물로 범위를 좁히고, 팔로워에게만 또는 상대의 첫 메시지에만 답하도록 설정할 수 있습니다. 각 자동화는 기본적으로 하루 최대 3회 실행되며, maxRunsPerDay를 최대 20까지 올릴 수 있습니다.

트리거 레퍼런스 읽기
일정, 피드, 여러 네트워크에 걸쳐 실행되는 자동화

게시물별

postIds는 자동화를 지정한 게시물의 댓글로만 제한합니다.

팔로워 전용

followersOnly는 계정을 팔로우하지 않은 댓글 작성자를 건너뜁니다.

일일 상한

maxRunsPerDay는 바이럴 게시물에서 수백 건의 메시지가 나가는 것을 막아 줍니다.

메시지

내 방식대로 쓰는 비공개 답장

channel을 private으로 설정한 send_message 단계는 Meta의 비공개 답장을 통해 댓글 작성자에게 DM을 보냅니다. 본문에 {{contact.name}}과 {{message.text}}를 쓸 수 있고, 링크 버튼은 최대 3개, 빠른 답장은 최대 13개까지 추가할 수 있으며, UTM 태그가 붙고 리디렉션 횟수가 집계되는 링크도 첨부할 수 있습니다. Meta는 댓글 작성 후 7일 이내에만 비공개 답장을 허용하므로, 그보다 오래된 댓글은 해당 사유로 실패합니다.

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
}

드라이 런

최근 댓글을 기준으로 메시지를 미리 확인합니다. 아무것도 발송되거나 생성되지 않습니다.

추적 링크

클릭 수가 집계되고 URL에 utm_medium=dm이 붙습니다.

7일 윈도우

Meta의 비공개 답장 제한으로, 발송 전에 항상 확인합니다.

제어

모든 실행을 승인, 일시 중지, 감사하세요

단계에서 requireApproval을 false로 설정하지 않는 한, 각 답장은 누군가 승인하거나 거부할 때까지 GET /v1/inbox/approvals에서 대기합니다. 호출 한 번으로 자동화를 켜고 끌 수 있으며, 실행 기록에서 무엇이 실행되었고, 무엇이 대기 중이고, 무엇이 실패했는지 확인할 수 있습니다.

개발 시작하기
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 }

실행 기록

GET /v1/automations/:id/runs로 상태, 시작 시각, 오류를 조회합니다.

재실행

메시지나 트리거를 고친 뒤 이전 실행을 다시 실행합니다.

버전

저장된 모든 변경 사항이 버전으로 남아 확인하거나 복원할 수 있습니다.

댓글을 DM으로에 대해 자주 묻는 질문

어떤 네트워크에서 댓글 DM을 지원하나요?

Instagram과 Facebook입니다. 댓글에 대한 비공개 답장은 Meta의 기능이며, 다른 네트워크에는 동일한 기능이 없습니다. 같은 자동화로 channel을 same으로 설정하면 다른 네트워크에서는 댓글에 공개로 답할 수 있습니다.

같은 사람이 메시지를 두 번 받을 수 있나요?

같은 댓글에 대해서는 받지 않습니다. DM을 보내기 전에 댓글에 표시를 남기고 자동화는 댓글당 한 번만 실행되므로, 재시도나 반복 실행으로 새로 발송되는 일은 없습니다.

아무도 확인하지 않고 발송되나요?

기본값은 그렇지 않습니다. requireApproval 없이 만든 send_message 단계는 모든 답장을 승인 대기로 보류합니다. 자동으로 발송해도 좋을 때 해당 단계에서 requireApproval을 false로 설정하세요.

7일이 지난 댓글은 어떻게 되나요?

Meta는 7일이 지난 뒤의 비공개 답장을 허용하지 않으므로 해당 사유로 실행이 실패하고 아무것도 발송되지 않습니다.

어떤 API 키 스코프가 필요한가요?

자동화를 만들고 관리하려면 automations 스코프가 필요합니다. 보류된 답장을 조회하고 승인할 때는 inbox 스코프를 사용합니다.

내 시스템에서 자동화를 시작할 수 있나요?

네, 다른 트리거를 사용합니다. api_webhook 트리거를 쓰는 자동화는 x-automation-secret 헤더에 시크릿을 담아 /v1/automations/:id/trigger로 POST하면 실행됩니다.

오늘 바로 댓글을 DM으로로 개발하세요

무료로 시작할 수 있고 전체 API가 포함돼요. 키를 만들고 몇 분 만에 첫 호출을 해 보세요.

API 키 받기