모든 네트워크의 다이렉트 메시지를 내 코드에서
FoPost는 연결된 계정의 DM 스레드를 한곳에 모아 줍니다. 대화 목록 조회, 새 대화 시작, 연락처 세그먼트에 한 번에 메시지 발송, 며칠에 걸친 메시지 드립 발송까지 모두 같은 API 키로 처리할 수 있습니다.
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 }
}하나의 스레드 목록
연결된 모든 계정의 DM 대화를 최신순으로 보여 줍니다.
일괄 발송
필터링한 연락처들과 이미 열려 있는 스레드에 메시지 하나를 보냅니다.
시퀀스
이전 메시지로부터 정해진 시간(시간 단위)이 지난 뒤 차례로 발송되는 일련의 메시지.
스레드를 읽고, 답하고, 새 대화를 시작하세요
기존 스레드에는 POST /v1/inbox/:id/reply로 답장합니다. X, Mastodon, Reddit, Slack에서는 핸들로 새 대화를 시작할 수 있고, Instagram이나 Facebook 댓글에는 comment_id를 전달해 비공개로 답할 수 있습니다. Facebook과 Instagram에서는 입력 중 표시를 띄울 수 있으며, Messenger에서는 스레드를 다른 앱에 넘겼다가 다시 가져올 수 있습니다.
대화 레퍼런스 읽기curl -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", ... } }텍스트와 미디어
네트워크가 허용하는 경우 라이브러리의 미디어 ID를 최대 10개까지 함께 보낼 수 있습니다.
입력 중 표시와 핸드오버
Meta 대화용 POST /v1/inbox/conversations/:id/typing 및 /handover.
X Chat
암호화된 X 대화는 암호문 그대로 전달되며, 키는 브라우저에만 남습니다.
플랫폼 규정을 지키면서 세그먼트에 메시지 보내기
일괄 발송은 계정이 이미 연락처와 나누고 있는 대화로 전달되며, 네트워크, 라벨, 유입 경로, 커스텀 필드로 대상을 거를 수 있습니다. Facebook, Instagram, WhatsApp은 연락처의 마지막 메시지로부터 24시간 이내에만 비즈니스 메시지를 허용하므로, 이 범위를 벗어난 수신자는 시도하지 않고 사유와 함께 건너뜁니다. WhatsApp에서는 승인된 템플릿으로 이 제한을 넘어 보낼 수 있습니다.
일괄 발송 레퍼런스 보기curl -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 }지금 또는 나중에 발송
scheduled_at을 설정해 예약하고, 발송 전에 취소할 수도 있습니다.
수신자별 결과
GET /v1/broadcasts/:id/recipients에서 발송됨, 건너뜀, 실패와 그 이유를 확인합니다.
한 번만 발송
각 수신자는 발송 전에 선점되므로 재시도해도 두 번 보내지 않습니다.
며칠에 걸쳐 자동으로 후속 메시지 보내기
시퀀스는 최대 20개의 단계로 이루어진 목록이며, 각 단계는 메시지와 이전 단계 이후의 지연 시간(시간 단위)으로 구성됩니다. 연락처는 ID로, 또는 일괄 발송과 같은 오디언스 필터로 등록할 수 있고 언제든 등록을 해제할 수 있습니다. 메시징 윈도우를 벗어난 단계는 건너뛰고 시퀀스는 계속 진행됩니다.
시퀀스 레퍼런스 보기curl -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 }언제든 일시 중지
status를 paused로 설정하면 다시 시작할 때까지 이후 단계가 발송되지 않습니다.
등록 해제
POST /v1/sequences/:id/unenroll로 연락처에 대한 발송을 즉시 중단합니다.
등록 현황
시퀀스별로 활성, 완료, 중단, 실패 건수를 확인합니다.
대화 상대를 파악하세요
계정에 메시지를 보낸 사람은 자동으로 연락처가 됩니다. 직접 추가하거나, 플랫폼과 핸들 열이 있는 최대 5,000행의 CSV를 가져올 수도 있습니다. 워크스페이스당 최대 50개의 커스텀 필드(텍스트, 숫자, 날짜, 선택, 예/아니요)를 정의하고 이를 기준으로 일괄 발송과 시퀀스를 필터링하세요.
개발 시작하기
CSV 가져오기
POST /v1/contacts/import는 생성, 병합, 건너뛴 행을 사유와 함께 반환합니다.
커스텀 필드
필드 키와 일치하는 열은 가져올 때 자동으로 채워집니다.
전체 기록
GET /v1/contacts/:id/conversations로 각 연락처가 남긴 내용을 조회합니다.