문서 메뉴

n8n

n8n용 MailInApp 노드를 쓰면 MailInApp에서 무슨 일이 생길 때 워크플로를 시작하고, 워크플로에서 연락처 추가, 거래 이동, 여정에 연락처 등록, 트랜잭션 이메일 발송을 할 수 있습니다. npm에 n8n-nodes-mailinapp으로 공개되어 있습니다.

영어 동영상

설치

n8n이 MailInApp 노드를 검증했습니다. n8n Cloud에서는 인스턴스 소유자나 관리자가 캔버스에서 노드 패널을 열고 MailInApp을 검색한 뒤 More from the community에서 골라 Install을 선택합니다. 그 뒤로는 인스턴스의 모두가 쓸 수 있습니다.

직접 호스팅하는 n8n에서는 Settings → Community Nodes → Install로 가서 n8n-nodes-mailinapp을 입력합니다. 자세한 내용은 n8n의 커뮤니티 노드 가이드를 참고하세요.

계정 연결하기

  1. MailInApp에서 개발자로 가서 API 키를 만듭니다. 키는 mia_live_로 시작하며 한 번만 표시됩니다.
  2. n8n에서 MailInApp API 자격 증명을 만들고 키를 붙여 넣습니다. Base URL은 https://mailinapp.com 그대로 둡니다.

이 키는 MailInApp 계정 전체로 동작하므로 비밀번호처럼 다루세요. MailInApp에서 키를 폐기하면 그 키로 설정한 트리거도 모두 꺼집니다.

MailInApp Trigger 노드

이벤트를 하나 이상 고릅니다. 워크플로를 활성화하면 노드가 MailInApp에서 그 이벤트를 구독하고, 비활성화하면 구독을 삭제합니다. 구독은 개발자 → 웹훅에 n8n으로 표시됩니다.

이벤트는 열다섯 가지 계정 이벤트입니다: Interaction Received, Form Submitted, Contact Created, Contact Updated, Lead Turned Hot, New Lead, Meeting Booked, Meeting Cancelled, Deal Created, Deal Stage Changed, Purchase Completed, Journey Completed, Experiment Decided, Experiment Results Ready, Response Completed.

각 실행은 MailInApp이 보낸 그대로의 이벤트(id, type, createdAt, data)를 받습니다. id는 같은 이벤트의 모든 전달에서 같으므로 중복을 거르는 데 쓸 수 있습니다. 모든 전달에는 서명이 있습니다. 노드는 유효한 서명이 없거나 타임스탬프가 5분 이상 지난 요청을 거부하므로, 웹훅 URL을 안다고 해서 워크플로를 실행할 수는 없습니다.

MailInApp 노드

리소스작업
ContactCreate or Update: 연락처 목록에 주소를 추가하거나 업데이트합니다. MailInApp은 저장할 때 주소를 확인합니다. Get: 그 주소의 연락처를 모든 목록 또는 한 목록에서 가져옵니다.
Contacts ListGet Many: 목록과 필드, 연락처 수를 가져옵니다.
DealCreate: 이메일로 지정한 연락처에 거래를 만듭니다. 재실행으로 거래가 두 번 만들어지지 않도록 Idempotency Key(예: 주문 번호)를 설정하세요. Update: 거래를 다른 단계(성사, 실패 포함)로 옮기거나 제목, 금액, 통화를 바꿉니다. Get Many: 최근에 움직인 순서로 거래를 가져오며, 연락처 이메일, 상태, 파이프라인으로 걸러낼 수 있습니다. 연락처의 거래를 찾은 뒤 업데이트하세요.
EmailSend Transactional: 직접 쓴 제목과 HTML 또는 텍스트, 혹은 병합 데이터를 넣은 스튜디오 프로젝트를 보냅니다. 발송 실패는 오류로 처리됩니다. suppressed(주소가 반송되었거나 유효하지 않음)는 정상 결과로 반환되므로 이것으로 분기할 수 있습니다.
JourneyEnroll Contact: 트리거가 API 호출인 여정에 연락처를 등록합니다. Get Many: 여정을 가져옵니다.
PipelineGet Many: 파이프라인과 단계를 가져옵니다.

드롭다운에는 목록, 목록 필드, 여정, 파이프라인, 단계가 표시됩니다. n8n의 Continue On Fail도 지원합니다.

마케팅 이메일 발송은 없습니다. 워크플로는 수신자의 동의를 증명할 수 없기 때문입니다. 마케팅은 MailInApp에서 보내거나 연락처를 여정에 등록하세요.

AI 에이전트와 함께 쓰기

MailInApp 노드는 n8n AI Agent의 도구로 쓸 수 있습니다. 더 많은 도구를 쓰려면 MCP Client Tool 노드로 에이전트를 MailInApp의 MCP 서버에도 연결하세요. 엔드포인트는 https://mailinapp.com/api/mcp이며, API 키를 Bearer 자격 증명으로 사용합니다.

패키지에는 바로 쓸 수 있는 예제 워크플로(패키지 안의 examples/ai-agent-mcp.workflow.json)가 들어 있습니다. 이 에이전트는 연락처, 결과, 양식 응답, 세그먼트, 여정을 읽고 새 여정의 초안을 만들 수 있지만, 이메일을 보내는 도구는 없습니다. 에이전트가 만든 여정은 항상 꺼진 상태로 저장되므로, 사람이 검토한 뒤 켭니다.

노드 없이 쓰기

어떤 n8n 워크플로든 개발자 → 웹훅에서 추가한 웹훅을 받는 일반 Webhook 트리거와, API를 호출하는 HTTP Request 노드로 MailInApp을 쓸 수 있습니다.