Documentation menu

Zapier

MailInApp을 Zapier의 수천 개 앱과 연결하세요. 새 리드를 스프레드시트에 넣고, 예약된 미팅을 Slack에 올리고, 거래가 성사되면 CRM에 레코드를 만들고, 다른 곳에서 무슨 일이 생기면 MailInApp에 연락처를 추가할 수 있습니다.

MailInApp Zapier 앱

MailInApp 공식 Zapier 앱은 현재 Zapier의 심사 중이며, 아직 앱 디렉터리에 올라와 있지 않습니다. 공개되면 API 키로 연결하고, URL을 복사할 필요 없이 메뉴에서 트리거와 액션을 고를 수 있습니다.

  • 트리거: 계정 이벤트마다 하나씩. New Lead, Lead Turned Hot, Meeting Booked, Deal Stage Changed, Form Submitted, Purchase Completed, Journey Completed 등이 있습니다.
  • 액션: Create or Update Contact, Trigger Journey, Create Deal, Update or Move Deal, Send Transactional Email.
  • 검색: Find Contact. 만들기와 함께 "Find or Create Contact"로 쓸 수 있습니다.

앱이 공개되면 이 페이지에서 앱 페이지로 연결해 드립니다. 그때까지는 아래 내용을 Zapier 기본 앱 Webhooks by Zapier로 바로 쓸 수 있습니다.

MailInApp 이벤트를 Zap으로 보내기

  1. Zapier에서 트리거는 Webhooks by Zapier, 이벤트는 Catch Hook으로 Zap을 만듭니다. Zapier가 주는 URL을 복사합니다.
  2. MailInApp에서 개발자 → 웹훅으로 갑니다. URL을 엔드포인트 URL에 붙여 넣고, 이 Zap이 받을 이벤트를 선택한 뒤 웹훅 추가를 클릭합니다. 나중에 서명을 검증할 계획이라면 서명 시크릿을 보관해 두세요.
  3. 새 웹훅의 테스트 보내기를 클릭한 뒤 Zapier에서 Test trigger를 클릭합니다. 샘플 이벤트가 type과 data 안의 각 필드(연락처 이메일, 거래 단계 등)와 함께 표시됩니다.
  4. 액션 단계를 추가하고 필요한 필드를 매핑한 뒤 Zap을 켭니다.

모든 이벤트는 id, type, createdAt, data 객체라는 같은 형식입니다. 이벤트별 필드는 웹훅 페이지에 정리되어 있습니다. Catch Hook 하나로 여러 유형의 이벤트를 받는다면 type에 대한 Filter by Zapier 단계를 추가하거나, Zap마다 웹훅을 따로 만드세요.

특정 설문 응답처럼 이메일 한 통의 상호작용만 필요하다면, 그 이메일의 응답 페이지에 있는 프로젝트 웹훅에 Catch Hook URL을 붙여 넣으세요.

Zap에서 MailInApp 작업하기

Webhooks by Zapier → Custom Request 액션으로 Authorization: Bearer mia_live_… 헤더에 API 키를 넣어 MailInApp API를 호출합니다. 예를 들면 다음과 같습니다.

  • 연락처 추가 또는 업데이트(다른 곳에서 양식이 작성될 때): POST /api/v1/contacts.
  • 거래 만들기(다른 도구에서 리드가 통화를 예약할 때): POST /api/v1/deals. Zap 재시도로 거래가 두 번 만들어지지 않도록, 다른 도구의 레코드 ID 같은 값을 Idempotency-Key 헤더에 넣으세요.
  • 트리거가 API 호출인 여정에 연락처 등록: POST /api/v1/journeys/{id}/trigger.
  • 영수증이나 알림 보내기: POST /api/v1/send에 "type": "transactional"을 지정합니다. Zap에서 마케팅 이메일은 보내지 마세요. Zap은 수신자의 동의를 증명할 수 없습니다.

전달에 실패했을 때

Zap이 일시 중지되었거나 삭제되었거나, Zapier에 장애가 있으면 전달 실패로 처리됩니다. MailInApp은 몇 시간 동안 자동으로 재시도합니다. 이벤트 자체는 항상 MailInApp에 먼저 저장되므로 MailInApp 쪽에서는 아무것도 잃지 않습니다.