Shopify를 연결하면 고객이 가입하거나, 주문 결제가 완료되거나, 고객이 결제를 시작하거나, 주문 상품이 발송될 때 브랜드에 맞는 이메일을 보낼 수 있어요. Brew는 고객, 주문, 결제 페이지, 주문 처리에 걸친 Shopify 웹훅 이벤트 13개를 지원해요.
설정에는 Shopify 관리자에서 직접 만드는 웹훅을 사용해요. Shopify 앱, 클라이언트 ID, OAuth는 필요 없어요. 주문, 결제, 주문 처리는 계속 Shopify가 담당해요. Brew는 이메일을 만들고 보내요.
checkouts/create 이벤트는 고객이 결제를 중단할 때가 아니라 결제를 시작할 때 발생해요. 리마인더 플로우는 이 시점에 시작해서 대기해요. 고객이 주문을 완료해도 이미 시작된 실행은 멈추지 않아요.
대기 단계가 지나면 조건이 shopify_last_order_status, shopify_last_order_at 같은 연락처 필드의 현재 값을 읽어요. 이 필드는 지금 이 결제가 아니라 Brew가 마지막으로 확인한 주문을 나타내므로, 이 결제가 주문으로 이어졌는지 증명할 수 없어요.
checkouts/update 이벤트는 정해진 시간이 지난 뒤가 아니라 결제 정보가 바뀔 때마다 발생하므로, 그것만으로는 시간을 두고 보내는 두 번째 리마인더로 쓸 수 없어요.
이메일 주소가 없는 결제는 Brew가 같은 Shopify 고객 ID의 이메일을 이미 확인한 경우가 아니면 자동화를 시작하지 않아요. 게시하기 전에 주문으로 이어지는 결제와 그렇지 않은 결제를 모두 테스트하세요.
Brew는 다음 웹훅 이벤트 13개를 지원해요:
실제 이메일 주소가 담긴 검증된 이벤트는 자동화에서 쓰이는지와 관계없이, 이메일 주소를 기준으로 Brew 연락처를 만들거나 업데이트해요. 데이터가 있으면 Brew가 이름과 성, shopify_customer_id, shopify_shop_domain을 설정해요.
주문 이벤트는 shopify_last_order_number, shopify_last_order_total, shopify_last_order_currency, shopify_last_order_at을 업데이트해요. orders/create, orders/paid, orders/cancelled 이벤트는 shopify_last_order_status도 설정하고, orders/fulfilled 이벤트는 shopify_last_fulfillment_status를 설정해요. 주문 처리 이벤트는 shopify_last_tracking_number, shopify_last_tracking_url, shopify_last_fulfillment_status를 업데이트해요. 결제 페이지 이벤트는 shopify_last_checkout_url을 업데이트해요.
customers/delete, customers/disable, customers/enable 이벤트는 shopify_account_status를 각각 deleted, disabled, active로 설정해요. Brew는 연락처를 삭제하거나 수신 거부 처리하지 않으므로, 필요한 곳에서는 이 필드로 필터링하세요.
개인화 태그에는 선택한 이벤트에 선언된 페이로드 스키마를 사용하세요. 모든 이벤트에는 값이 있는 경우 email, firstName, lastName, currency, shopDomain, createdAt이 포함돼요. 주문 이벤트에는 orderNumber, totalPrice, financialStatus, fulfillmentStatus가, 결제 페이지 이벤트에는 totalPrice와 abandonedCheckoutUrl이, 주문 처리 이벤트에는 trackingNumber, trackingUrl, fulfillmentStatus가 추가돼요.
totalPrice는 Shopify가 주문 통화로 보내는 금액으로, 센트 단위가 아니라 49.95 같은 값이에요. 페이로드에는 주문 품목이 포함되지 않으며, Shopify 객체 ID는 개인화 태그로 쓸 수 없어요.
Shopify 고객 웹훅에는 더 이상 마케팅 수신 동의 정보가 포함되지 않아서 Brew도 이 정보를 받지 못해요. 수신 동의는 따로 기록하고, 프로모션 이메일을 보내기 전에 확인하세요.
아니요. Shopify에는 orders/refunded 이벤트가 없고, 환불 웹훅에는 고객 정보가 없어요. carts/update 이벤트에는 수신자를 식별할 정보가 없어서 Brew가 이 이벤트로는 안전하게 이메일을 보낼 수 없어요. 이런 이벤트용 웹훅은 추가하지 마세요.
이벤트 수신과 이메일 발송은 별개의 단계예요. 일치하는 자동화가 활성 상태인지 확인한 다음, 필터와 실행 기록, 수신자가 발송 대상인지, 발신 도메인을 확인하세요. Shopify에서 보낸 테스트는 테스트 이벤트로 표시되며 자동화를 시작하지 않아요. 알 수 없는 고객의 이벤트에 이메일 주소가 없으면 수신자를 찾지 못한 것으로 기록돼요.
