REST API · n8n
기존 스크립트나 자동화의 HTTP 요청 단계에서 메시지·업무를 보냅니다. 프로그램 키로 인증하고 안정적인 업무 ID를 사용합니다.
REST API · 개발자 문서CONNECTION GUIDE
내 자동화를
대화방에 연결하기.
메시지 한 건으로 연결을 확인한 뒤,
응답을 받고 승인된 업무를 처리하도록 확장하세요.
01 · PREPARE
앱에서 대화방과 권한을 준비하세요.
- 초대받은 내부 테스트 앱에서 계정을 만들고 대화방을 준비합니다.
- 앱 설정의 연결 관리에서 프로그램에 필요한 권한과 대화방만 허용합니다.
- 웹에서 설정하려면 앱으로 QR 로그인을 승인합니다. 키는 발급할 때 한 번만 표시됩니다.
키를 소스 코드나 대화에 넣지 않고, 실행 환경의 비밀 설정 또는 개인 키 파일에 보관하세요. MCP의 앱 승인 연결은 프로그램 키를 직접 복사하지 않아도 됩니다.
02 · CONNECT
실행 환경에 맞는 연결 방식을 고르세요.
MCP · 에이전트
MCP를 지원하는 에이전트에 Pushyou 서버를 추가합니다. 앱에서 접근할 대화방과 권한을 승인하거나 프로그램 키로 연결합니다.
MCP · 개발자 문서응답 수신 · Webhook
수신기는 응답 이벤트를 조회하고 내 핸들러를 실행합니다. Webhook은 지정한 HTTPS 주소로 서명된 이벤트를 전달합니다.
수신기와 예제 보기03 · CONTINUE THE WORK
승인 요청을 실제 실행과 연결하세요.
- API로 제목·입력 항목·카테고리를 담은 업무를 보냅니다.
- 사용자가 앱이나 웹에서 내용을 확인하고 승인합니다.
- 연결한 프로그램이 업무 이벤트를 받아 실행 권한을 점유합니다.
- 실제 결과를 확인하고 성공·실패·확인 필요 상태를 보고합니다.
원래 요청과 결과는 같은 업무에서 확인할 수 있습니다. 시간 초과처럼 결과가 불확실한 업무는 외부 상태를 확인한 뒤 재시도를 결정합니다. 단순 ACK는 업무 완료를 대신하지 않습니다.
04 · RUN & VERIFY
내 프로그램에서 계속 응답받기.
Node 22 이상에서 실행하는 REST 수신기를 제공합니다. 처리 위치와 실행 결과를 저장해 전달 실패 후 이어받습니다. 터미널을 닫은 뒤에도 받으려면 설치 안내의 macOS·Linux 서비스 설정을 사용하세요.
응답 수신기 설치 파일Node 22+ · 로컬 패키지설치·상시 실행·복구 안내사용자 핸들러와 Codex 연결n8n 배포 승인 워크플로주소·대화방·자격증명 설정 후 사용REST 승인 요청 예제배포·장애·보고서 요청업무 처리 핸들러 예제로컬 보고·진단·배포 입력 검증서명 Webhook 수신 예제서명 확인·이벤트 디스크 보존
배포 예제는 실제 인프라를 변경하지 않는 dry run입니다. n8n은 가져올 수 있는 요청 예제를 제공하며, 실제 사용 환경의 실행은 별도 확인이 필요합니다. 프로그램이 꺼져 있거나 컴퓨터가 절전 중이면 작업을 처리할 수 없습니다.
개발자 문서
대화방 하나로 연결을 확인하세요.
메시지 전송과 실제 답장 왕복을 단계별로 확인합니다.