教學｜Webhook

💁🏻‍♀️ 可做到

1. 擴大 MAAC 模組即時資料串接，實現行銷自動化及多系統即時協作。如您可即時接收符合 MAAC 發票模組條件的資料至 CRM 系統 or 集點系統分析資料或及時給予會員點數；可即時接收 SurveyCake 表單填寫資料，傳輸至內部派案系統，第一時間預約實體據點賞屋、賞車、試穿！ 
2. 資料傳輸事件包含 SurveyCake 表單、發票登錄模組等
3. 不只 MAAC 模組，如您有使用通知型訊息功能，Webhook 更讓您能打破過往通知型訊息無法取得資訊，實現如自動化完成完整資料比對綁定、串接自家簡訊系統、延伸通知型訊息僅能通知重要資訊，轉化為個人化且自動化的行銷體驗（ 即時取得通知型訊息發送資訊後，再進行推播行銷訊息或上標籤觸發自動旅程等 ）

➤ 適用對象

此為擴充市集中進階功能，需額外加購，且需要搭配相對應事件的模組功能，未含在入門版及電商功能當中，目前 Webhook 功能共有 2 區、分區計費，如有興趣歡迎洽詢負責您品牌的 CSM 喔！

• Webhook zone 1
  • 發票事件：驗證發票同步
  • 問卷事件：問卷上傳
  • 通知型訊息事件：發送狀態同步
  • 通知型訊息事件：發送成功資訊
  • 派發點數事件：點數同步
• Webhook zone 2
  • 訊息開封事件：Message first open

▶︎ 設定步驟

💡 提醒：
- 完成此功能設定需要與 Engineer 人員協作，讓 MAAC 與您要串接系統串接，交換必要的 Webhook URL 及 Secret 設定值
- 請於功能選單中點選 API > Webhook，如您完全尚未建立過 Webhook，將會呈現以下畫面，畫面中含有技術文件（ 亦可點選下方連結 ），可提供給 Engineer 人員設定 Webhook URL 接口（ 稍後設置我們會使用到 ）

🔑 參考：MAAC OpenAPI - Webhook

1. 為要建立 Webhook 命名
2. 輸入 Webhook 端點 URL（ 和 Engineer 人員索取 ）
3. 選擇 Webhook 事件類型（ 例如 receipt 為發票登錄模組、form.surveycake 為 SurveyCake 表單 、pnp.status_updated 為通知型訊息、prize.points_added 為點數券）
4. 接著按「建立」
   
   
   
   
5. 建立完成後，會跳轉至 Webhook 列表頁，點按報表小圖示，可進入該 Webhook 詳細資訊
6. 可針對特定 Webhook 進行暫停、刪除
7. 購買期限將會顯示您加購的期間，訂閱組數每個 MAAC 後台限制運行中狀態為三組，如有更多需要請洽 CS 團隊 
   
   
   
   
8. 請將 Share Secret 隱藏顯示打開並複製提供給 Engineer 完成串接設置
9. Engineer 完成設置後，您可以使用「發送測試」即時發送模擬事件看看是否能成功獲得事件資料
10. 為保資料安全，如 Webhook 要更換資料傳輸系統或對象時，您可以更換 Share Secret 來刷新並停止先前的 Secret 值
    
    
11. 發送測試前，請選擇事件的類型
12. 點按「發送測試」
    
    
13. 您可以從結果來查看是否有成功串接 Webhook 事件資料
    
    
    

🚨 注意：

• receipt.receipt_validated：
  目前 MAAC Webhook 僅支援傳送符合發票模組設定符合條件之發票詳細資料
• form.surveycake_submitted：
  判斷不同問券題目的方式，需要行銷人員在問券中設置「設定題目別名與預設值」，並將設定的值，知會 Engineer
  
• message.first_open：
  如果不是使用 MAAC 後台、而是使用 Open API - Push (Zone 3) 推播，必須加上 event_id 才能收到此 webhook event

🔍 祕技：

目前 MAAC 提供以下兩種方式自動獲得訊息開封數的數據，可依需求和品牌資料庫或自動化行銷工具整合。

• Webhook - 訊息開封事件（Message first open）：
  獲得每位好友開封推播的時間點，品牌能記錄每一位 LINE 好友的行為、觸發 MA 工具。
• Open API - 取得追蹤成效報表：
  獲得每則推播的總開封數，品牌能自動化追蹤每則推播成效、進一步優化行銷活動策略。