Pluggzy문서

Instagram Business

받은 메시지댓글인사이트게시물릴스·스토리
받은 메시지댓글인사이트게시물릴스·스토리

Instagram 공식 API로 비즈니스 계정과 크리에이터 계정을 지원해요. 어떤 AI 앱에서든 Meta의 답장 가능 시간 안에 DM에 답하고, 댓글을 관리하고, 인사이트를 읽고, 게시물·릴스·스토리를 올릴 수 있어요.

연결 방법
브라우저에서 Instagram 로그인
도구
16
하루 25게시물 (바로 게시 또는 예약)
2–5초동작 사이 무작위 간격
2,200캡션 글자 수
하루 200메시지와 답장

한도

동작일일분당최소 간격속도 조절도구
읽기게시 옵션과 계정 목록3,00030——list_chatsget_messagespost_optionslist_postslist_commentsget_insights
받은 메시지 관리읽음 표시, 반응500101초—mark_readreact
메시지200102초2–5초send_messagecommentprivate_reply
게시물25230초2–5초create_post
삭제댓글3035초—moderate_comment
예약 게시물목록 보기와 취소————list_scheduled_postscancel_scheduled_post
읽기3,000/일
게시 옵션과 계정 목록
분당 30 · 속도 조절 없음
list_chatsget_messagespost_optionslist_postslist_commentsget_insights
받은 메시지 관리500/일
읽음 표시, 반응
분당 10 · 최소 간격 1초
mark_readreact
메시지200/일
분당 10 · 최소 간격 2초 · 2–5초 간격
send_messagecommentprivate_reply
게시물25/일
분당 2 · 최소 간격 30초 · 2–5초 간격
create_post
삭제30/일
댓글
분당 3 · 최소 간격 5초
moderate_comment
예약 게시물—
목록 보기와 취소
list_scheduled_postscancel_scheduled_post
  • 메시지 첨부 파일: 메시지당 이미지 1개(JPEG, PNG, WebP, 최대 8MB) 또는 문서 1개(PDF만, 최대 15MB). 상대가 보낸 파일은 링크로 전달돼요.
  • 일일 한도는 00:00 UTC에, 주간 한도는 월요일 00:00 UTC에 초기화돼요.
  • 예약 게시물 목록 보기와 취소는 Instagram Business 호출 없이 Pluggzy 안에서 처리해요.

게시 규칙

Instagram Business에서 허용하는 형식이에요. 보내기 전에 미리 확인하니, 잘못된 게시물로 손해 볼 일이 없어요.

캡션필수text에 최대 2,200자.
미디어필수필수: 이미지 최대 20장(image_urls) 또는 동영상 1개(video_url), 둘 중 하나만 올릴 수 있어요. 기기에 있는 파일은 먼저 upload_media로 업로드하세요.
storyPublish as a Story (one image, or one video ≤60 s) instead of a feed post or Reel.
share_to_feedInstagram Business, Reels: also show the Reel in the feed (default true)
first_commentInstagram Business, Facebook and LinkedIn Pages: posted as the first comment right after publishing (the place for links; not for Stories)
collaboratorsUp to 3 usernames of public Business or Creator accounts invited as collaborators (not for Stories)
thumbnail_urlCover of a Reel

안전 한도

Instagram Business 계정을 안전하게 지켜 주는 장치예요. 이 계정을 쓰는 모든 AI 앱과 API 키에 적용되고, 끌 수 없어요.

속도2–5초
Instagram Business 동작 사이에 무작위 간격을 둬요. 이 계정의 모든 앱과 키에 공통으로 적용돼요.
중복 게시 방지10분
같은 계정에 10분 안에 같은 게시물을 올리면, 두 번 게시하지 않고 첫 번째 응답을 그대로 돌려줘요.
제한 걸리면 쿨다운5분
요청 제한 응답을 받으면 계정이 최소 5분 쉬어요. Instagram Business 쪽에서 직접 대기를 요청하면 30분이에요. 그사이 들어온 호출에는 남은 시간을 알려 줘요.
예약 가능 기간1년
publish_at은 최소 1분 뒤부터 최대 1년 뒤까지 정할 수 있어요. 링크는 그때까지 유효해야 하고, 업로드한 파일은 게시물과 함께 보관돼요.
댓글 삭제하루 30
숨기기보다 한도가 훨씬 낮아요. 반복 작업이 잘못 돌아도 게시물 댓글이 전부 지워지지 않아요.
계정 전체 한도분당 10
읽기를 제외하고 계정당 전체 호출은 분당 최대 10회예요. 동작별 분당 한도와는 별도로 적용돼요.

한도에 도달하면

몰래 대기열에 넣거나 재시도하지 않아요. 도구가 오류로 응답하면, AI 앱이 읽고 설명한 뒤 알맞은 때에 다시 시도해요.

invalid_post게시물이 Instagram Business 규칙에 어긋나요. 메시지에 어떤 규칙인지 나와 있어요.
gap직전 동작과 간격이 너무 짧아요. retry_after_seconds만큼 기다렸다가 다시 시도하세요.
limit일일 또는 주간 한도를 다 썼어요. 언제 초기화되는지 알려 줘요.
cooldownInstagram Business에서 제한을 걸어 계정이 쉬는 중이에요.
permission이 앱에는 해당 권한이 없어요. 다시 연결해서 권한을 허용하세요.
거절 예시
isError
{
  "error": "Instagram Business actions are spaced 2–5 s apart, at random, to look human. Wait 2s.",
  "code": "gap",
  "retry_after_seconds": 2
}

분석

Instagram Business에서 get_insights로 읽는 수치예요. 평소 말투로 물어보면 AI 앱이 리포트를 골라요.

개요overview 기본최근 days일 동안의 조회수, 도달, 참여, 팔로워를 보여 줘요. 플랫폼 고유 지표와 모든 플랫폼에 공통인 헤드라인 수치가 함께 나와요. account를 지정하지 않으면 모든 분석 계정을 나란히 보여 줘요.
팔로워followers 팔로워 수의 일별 추이(YouTube는 구독자)와 늘어난 팔로워, 줄어든 팔로워를 보여 줘요.
오디언스audience 국가별·도시별 팔로워, 그리고 플랫폼이 제공하는 경우 연령별·성별 팔로워를 보여 줘요.
인기 게시물top_posts 기간 중 가장 반응이 좋았던 게시물을 참여 기준 또는 sort(조회수, 도달, 좋아요, 댓글, 공유, 날짜) 기준으로 정렬해요. account를 지정하지 않으면 모든 분석 계정을 대상으로 해요.
게시하기 좋은 시간timing 내 게시물 성과가 가장 좋은 요일과 시간대(UTC), 게시 빈도 대비 참여도, 게시물이 최고치에 도달하는 속도를 보여 줘요. Instagram은 팔로워가 접속해 있는 시간도 보여 줘요.
메시지 활동inbox 받은 메시지와 보낸 메시지 수, 첫 답장까지 걸린 시간의 중앙값, 가장 바쁜 시간대를 보여 줘요.
게시물 1개post list_posts, 인기 게시물 또는 create_post에서 받은 post_id로 게시물 1개의 수치를 보여 줘요. details: true를 넣으면 일별 추이와 플랫폼별 추가 지표도 함께 나와요.

도구

AI 앱이 tools/list에서 받는 내용 그대로예요. 쓰기 도구는 계정에서 무언가를 보내거나 바꿔요. 좋은 AI 어시스턴트는 보내기 전에 텍스트를 먼저 보여 줘요.

도구 16개 · 읽기 7개 · 쓰기 9개
받은 메시지5

Reply in an existing conversation (chat_id from list_chats), on any network: 1-to-1, group, or a Facebook Page's chat (answered as the Page). Plain text. Show the user the exact text (and which file) before calling this. One file can go with the text: image_url (an https link to an image), file_url (an https link to a document) or media_id (from upload_media, for an image or a document the user has on their device or attached in the chat). Documents: PDF, Word, Excel, PowerPoint (docx, xlsx, pptx, doc, xls, ppt), TXT or CSV, at most 15 MB; WhatsApp, Telegram, LinkedIn and Facebook Messenger take PDF, Word, Excel, PowerPoint, TXT and CSV files; Instagram takes PDFs only; Instagram Business takes PDFs only and Facebook Pages any of them. Instagram Business allow replies within 24 hours of the person's last message (Instagram: at most 1000 characters, JPEG or PNG); up to 7 days after it, only a reply the user wrote or approved word for word, with user_written: true (never for text you wrote on your own).

권한 Send messages & posts한도 메시지 · 하루 200속도 조절 2–5초먼저 사용자 확인 필요
입력파라미터 7개 · 필수 2개
accountstring
account_id from list_accounts (a listed chat's account_id). Needed only when several accounts are connected.
chat_idstring필수
textstring필수
최대 8,000자
image_urlstring
https link to a JPEG, PNG or WebP image (at most 8 MB) that is already online. Optional. For an image the user attached in the chat or has on their device, use media_id instead.
https://
file_urlstring
https link to a document that is already online (PDF, Word, Excel, PowerPoint (docx, xlsx, pptx, doc, xls, ppt), TXT or CSV, at most 15 MB). Optional. For a file the user has on their device or attached in the chat, use media_id instead.
https://
media_idstring
An image or a document the user uploaded: call upload_media, then pass its media_id here once the file is uploaded (the user says so, or your own upload_command answered ok).
user_writtenboolean
Instagram Business: true only when the user typed this exact text or approved it word for word: lets the reply go out up to 7 days after the person's last message instead of 24 hours
기본값 false
출력structuredContent
{
  "structuredContent": {
    "chat_id": "gq5Xp3bZUXCt6Zt1Z2rTsA",
    "message_id": "7mKQx2VdTnW8bLr4Yc9ey7",
    "sent": true
  },
  "content": [
    {
      "type": "text",
      "text": "Message sent."
    }
  ]
}
게이트가 한 일예시09:41:02 → 09:41:04
  1. 수신09:41:02
  2. 한도 이내오늘 200회 중 56회
  3. 간격 조절+2 s
  4. 전송09:41:04
오늘 메시지: 200회 중 56회 사용 · UTC 00:00 초기화
텍스트 응답 시작 “Message sent.” · 거절 코드gaplimitcooldownpermission
게시3
게시물1
댓글·리뷰4
예약 게시물2
분석1
pluggzy.com/api/docs에서 생성 · 도구 42개헷갈리는 부분이 있나요? 고객 지원에 문의하기 · 서비스 상태