n8n
n8n용 MailInApp 노드를 쓰면 MailInApp에서 무슨 일이 생길 때 워크플로를 시작하고, 워크플로에서 연락처 추가, 거래 이동, 여정에 연락처 등록, 트랜잭션 이메일 발송을 할 수 있습니다. npm에 n8n-nodes-mailinapp으로 공개되어 있습니다.
설치
n8n에서 Settings → Community Nodes → Install로 가서 n8n-nodes-mailinapp을 입력합니다. 자세한 내용은 n8n의 커뮤니티 노드 가이드를 참고하세요.
직접 호스팅하는 n8n에는 지금 바로 설치할 수 있습니다. n8n Cloud는 n8n이 검증한 커뮤니티 노드만 제공하며, 이 패키지는 아직 검증 전입니다. n8n의 검증 규칙에 맞춰 만들었으므로, n8n이 승인하면 Cloud에서도 쓸 수 있게 됩니다.
계정 연결하기
- MailInApp에서 개발자로 가서 API 키를 만듭니다. 키는
mia_live_로 시작하며 한 번만 표시됩니다. - 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.
각 실행은 MailInApp이 보낸 그대로의 이벤트(id, type, createdAt, data)를 받습니다. id는 같은 이벤트의 모든 전달에서 같으므로 중복을 거르는 데 쓸 수 있습니다. 모든 전달에는 서명이 있습니다. 노드는 유효한 서명이 없거나 타임스탬프가 5분 이상 지난 요청을 거부하므로, 웹훅 URL을 안다고 해서 워크플로를 실행할 수는 없습니다.
MailInApp 노드
| 리소스 | 작업 |
|---|---|
| Contact | Create or Update: 연락처 목록에 주소를 추가하거나 업데이트합니다. MailInApp은 저장할 때 주소를 확인합니다. Get: 그 주소의 연락처를 모든 목록 또는 한 목록에서 가져옵니다. |
| Contacts List | Get Many: 목록과 필드, 연락처 수를 가져옵니다. |
| Deal | Create: 이메일로 지정한 연락처에 거래를 만듭니다. 재실행으로 거래가 두 번 만들어지지 않도록 Idempotency Key(예: 주문 번호)를 설정하세요. Update: 거래를 다른 단계(성사, 실패 포함)로 옮기거나 제목, 금액, 통화를 바꿉니다. |
Send Transactional: 직접 쓴 제목과 HTML 또는 텍스트, 혹은 병합 데이터를 넣은 스튜디오 프로젝트를 보냅니다. 발송 실패는 오류로 처리됩니다. suppressed(주소가 반송되었거나 유효하지 않음)는 정상 결과로 반환되므로 이것으로 분기할 수 있습니다. | |
| Journey | Enroll Contact: 트리거가 API 호출인 여정에 연락처를 등록합니다. Get Many: 여정을 가져옵니다. |
| Pipeline | Get 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을 쓸 수 있습니다.