Meta Graph 자격 증명과 서명된 웹훅으로 Instagram 프로 계정 DM을 연결합니다.
Meta Graph 자격 증명과 서명된 웹훅으로 Instagram 프로 계정 DM을 연결합니다.
이 커넥터가 하는 일#
고객이 Instagram 프로 계정으로 다이렉트 메시지를 보냅니다. Make Agent Fast는 웹사이트 임베드와 같은 지식 기반 에이전트로 답합니다. Facebook 페이지에 연결된 프로 계정에서 공식 Instagram Messaging API를 사용합니다.
범위 밖: 댓글-to-DM, 스토리 답장, 피드 댓글, 스크래핑, 비공식 Instagram 로그인. 이 커넥터의 DM이 아닙니다.
같은 Meta 앱으로 Messenger와 WhatsApp도 연결할 수 있습니다. Instagram은 청구·대화 스레드·웹훅 바인딩이 섞이지 않도록 별도 채널 행입니다.
Meta 앱과 Instagram 계정 준비#
Meta 공식 Instagram Messaging 시작 가이드를 따르세요. 다음이 필요합니다.
- Instagram 프로 계정(비즈니스 또는 크리에이터).
- 관리하는 Facebook 페이지에 연결된 계정.
- Instagram / Messenger 제품과 Instagram 메시징이 켜진 Meta 앱.
- 해당 페이지의 페이지 액세스 토큰과 앱의 32자 16진수 앱 시크릿.
수집 값:
| Make Agent Fast 필드 | 제공자 값 | 용도 |
|---|---|---|
| 페이지 액세스 토큰 | 연결된 Facebook 페이지용 토큰 | 연결된 Instagram 계정을 읽고 DM 답장을 보냄 |
| 앱 시크릿 | 32자 16진수 Meta 앱 시크릿 | 서명된 수신 웹훅을 검증 |
사용자 액세스 토큰이나 다른 페이지 토큰을 붙여 넣지 마세요. 페이지에 연결된 Instagram 프로 계정이 없으면 Graph 검증이 실패합니다.
Make Agent Fast에는 플랫폼 소유의 Instagram Login OAuth가 없습니다. 자신의 Meta 앱 자격 증명을 사용합니다.
자격 증명 저장 및 검증#
사이트의 커넥터 페이지에서 Instagram을 선택하고 페이지 액세스 토큰과 앱 시크릿을 입력한 뒤 연결을 누릅니다.
Make Agent Fast는 appsecret_proof로 Graph를 호출하고 instagram_business_account을 요구하며, 수신 이벤트를 그 Instagram 계정 ID에 묶습니다. 카드에 웹훅 URL과 인증 토큰이 표시됩니다.
새 채널 연결은 Operate 또는 Scale이 필요합니다.
Instagram 웹훅 설정#
같은 Meta 앱에서:
- Instagram(또는 Messenger) 웹훅 설정을 엽니다.
- 커넥터 웹훅 URL과 인증 토큰을 붙여 넣습니다.
- 검증 챌린지를 완료합니다.
- Instagram
messages필드를 구독합니다. - 페이지와 Instagram 프로 계정이 앱에 연결되어 있는지 확인합니다.
- 앱 모드가 테스트 사용자를 허용하는지 확인합니다.
인증 토큰은 초기 챌린지에만 사용됩니다. 런타임 이벤트는 앱 시크릿과 일치하는 X-Hub-Signature-256이 있어야 합니다. 같은 Meta 앱에서 온 이벤트라도 다른 Instagram 계정으로 주소가 지정되면 거절하며, 이 URL의 Messenger object: "page" 페이로드는 무시합니다.
기능 테스트#
허용된 비관리 테스트 계정에서 일반 DM을 보내고 응답과 대화 스레드를 확인하세요. 음성 수신이 필요하면 오디오 노트도 테스트합니다.
텍스트와 지원되는 수신 오디오가 처리됩니다. 답장은 텍스트만입니다. 자신의 에코, 스토리 멘션, 이미지 등 미지원 첨부는 무시됩니다.
프로덕션 준비#
권한, 앱 검토(instagram_manage_messages 및 관련 페이지 권한), 비즈니스 인증, 개인정보 URL, 게시 단계를 완료하세요. 앱 역할 계정으로 개발 모드가 성공해도 일반 사용자가 DM할 수 있다는 뜻은 아닙니다.
운영자를 위해 소유 Meta 앱, 페이지 ID, Instagram 계정 ID를 기록하세요. 페이지 토큰은 소유자·권한·비즈니스 연결·제공자 정책이 바뀌면 동작이 멈출 수 있습니다.
교체 또는 연결 해제#
대체 페이지 토큰을 만들고 커넥터를 업데이트한 뒤 허용된 사용자로 테스트하고 이전 토큰을 폐기하세요. 앱 시크릿을 교체한 직후 Make Agent Fast도 업데이트하세요.
커넥터를 끄거나 삭제해도 Meta에서 Instagram 구독은 해제되지 않습니다. 영구 폐기 시 구독과 사용하지 않는 자격 증명을 제거하세요.
문제 해결#
| 증상 | 조치 |
|---|---|
| 토큰 거부 | 의도한 페이지의 페이지 토큰인지, 앱 시크릿이 같은 앱인지 확인 |
| 페이지는 유효하지만 “연결된 Instagram 계정 없음” | Meta Business Suite에서 Instagram 프로 계정을 페이지에 연결 |
| 웹훅 검증 실패 | 현재 URL과 인증 토큰을 정확히 복사하고 공개 HTTPS를 사용 |
| 검증은 되지만 메시지가 오지 않음 | Instagram messages 필드를 구독하고 앱 모드, 사용자 역할, Meta 전달 로그를 확인 |
| 요청이 무단 | 앱 시크릿을 고치세요. 서명된 POST는 인증 토큰을 쓰지 않습니다 |
| 수신은 보이지만 답장이 없음 | 페이지 토큰, instagram_manage_messages, 전송 오류, 커넥터 상태 확인 |
| 음성에 텍스트로 답함 | 정상입니다. Instagram 발신 음성은 현재 지원하지 않습니다 |
| 일반 고객이 DM할 수 없음 | Meta 앱 검토를 마치세요. 개발 모드는 앱 역할 테스터만 전달합니다 |
제공자 자격 증명은 인증된 커넥터 폼 또는 신뢰할 수 있는 서버 측 API 호출에만 넣으세요.