Pluggzy문서

Messenger

받은 메시지메시지 요청페이지
받은 메시지메시지 요청페이지

Messenger는 Facebook 로그인을 그대로 쓰는 별도 채널이에요. 어떤 AI 앱에서든 채팅, 메시지 요청, 페이지 대화를 10–20초 간격으로 읽고 답장할 수 있어요. 대화 도구는 다른 채널과 똑같아요.

연결 방법
브라우저에서 이메일과 비밀번호 입력
도구
10
하루 3게시물 (바로 게시 또는 예약)
10–20초동작 사이 무작위 간격
10,000텍스트 글자 수
하루 50메시지와 답장

한도

연결된 Messenger 계정 1개 기준이에요. 이 계정을 쓰는 모든 AI 앱과 API 키가 한도를 함께 써요. 도구는 모든 플랫폼에서 같지만, 한도는 계정마다 따로예요.

동작일일분당최소 간격속도 조절도구
읽기받은 메시지, 1촌 신청, 게시물 목록3,00030——list_chatsget_messagesget_attachmentlist_group_membersfacebook_list_pages
받은 메시지 관리읽음 표시, 반응500101초—mark_readreact
메시지50215초10–20초send_messageaccept_message_request
새 대화1011분10–20초start_chat
읽기3,000/일
받은 메시지, 1촌 신청, 게시물 목록
분당 30 · 속도 조절 없음
list_chatsget_messagesget_attachmentlist_group_membersfacebook_list_pages
받은 메시지 관리500/일
읽음 표시, 반응
분당 10 · 최소 간격 1초
mark_readreact
메시지50/일
분당 2 · 최소 간격 15초 · 10–20초 간격
send_messageaccept_message_request
새 대화10/일
분당 1 · 최소 간격 1분 · 10–20초 간격
start_chat
  • 메시지 첨부 파일: 메시지당 이미지 1개(JPEG, PNG, WebP, 최대 8MB) 또는 문서 1개(PDF, Word, Excel, PowerPoint, TXT, CSV, 최대 15MB). 상대가 보낸 이미지는 AI가 직접 보고(최대 3.75MB), PDF, Word, Excel, TXT, CSV 파일은 텍스트로 읽어요(최대 15MB).
  • 일일 한도는 00:00 UTC에, 주간 한도는 월요일 00:00 UTC에 초기화돼요.

게시 규칙

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

텍스트필수text에 최대 10,000자.
미디어선택: 이미지 1장(image_urls) 또는 동영상 1개(video_url; 최대 500MB, 1초~240분), 둘 중 하나만 올릴 수 있어요. 기기에 있는 파일은 먼저 upload_media로 업로드하세요.
visibilityLinkedIn: anyone (default) or relations_only (connections). Facebook: anyone (default: everyone) or relations_only (friends; not as a Page). YouTube: public (default), private or unlistedanyonerelations_onlypublicprivateunlisted
as_pageFacebook: publish as this Page (page_id from facebook_list_pages) instead of the personal account
share_post_idFacebook: post_id of a post to share (text optional, no image; not schedulable)

안전 한도

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

사람 같은 속도10–20초
프로필 조회, 검색, 메시지, 새 대화, 1촌 신청, 게시물 사이에 무작위 간격을 둬요. 모든 앱과 키에 공통으로 적용돼요.
계정 전체 한도분당 10
읽기를 제외하고 계정당 전체 호출은 분당 최대 10회예요. 동작별 분당 한도와는 별도로 적용돼요.
제한 걸리면 쿨다운5분
요청 제한 응답을 받으면 계정이 최소 5분 쉬어요. Messenger 쪽에서 직접 대기를 요청하면 30분이에요. 그사이 들어온 호출에는 남은 시간을 알려 줘요.
캐시된 읽기는 무료1시간
대화와 프로필은 캐시에서 읽어서 한도를 쓰지 않아요. fresh: true를 넣으면 실시간으로 다시 읽어요.
새 대화하루 10
계정이 제한되는 가장 큰 이유는 모르는 사람에게 먼저 말을 거는 거예요. 그래서 새 대화는 적게 열어요. 기존 채팅에 답장하는 건 상관없어요.
친구 요청·팔로우하루 15
조금만 보내요(주 최대 60건). Facebook은 요청을 많이 보내는 계정을 차단해요.

한도에 도달하면

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

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

도구

Messenger에서는 Facebook의 채팅 도구를 써요. 로그인도 같고, 한도도 같아요.

도구 10개 · 읽기 5개 · 쓰기 5개
받은 메시지10

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한도 메시지 · 하루 50속도 조절 10–20초먼저 사용자 확인 필요
입력파라미터 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:14
  1. 수신09:41:02
  2. 한도 이내오늘 50회 중 14회
  3. 간격 조절+12 s
  4. 전송09:41:14
오늘 메시지: 50회 중 14회 사용 · UTC 00:00 초기화
텍스트 응답 시작 “Message sent.” · 거절 코드gaplimitcooldownpermission
모든 메시지 채널에서 같은 도구list_chats, get_messages, send_message, start_chat, mark_read 도구는 Messenger에서도, 다른 모든 메시지 채널에서도 똑같이 작동해요. 한도는 계정마다 따로 적용돼요.
대화 도구
pluggzy.com/api/docs에서 생성 · 도구 42개헷갈리는 부분이 있나요? 고객 지원에 문의하기 · 서비스 상태