FAQ

常見問題

M+服務圈提供哪些API功能?分別有什麼特色?
M+服務圈提供三支API,讓您可依據需求選擇搭配使用,打造獨具特色的服務圈。三支API分別說明如下:
  1. VIP會員認證API:可透過提供給M+的會員認證網址,在粉絲成功認證是您的會員後,將粉絲的M+ UID與自家會員身分做綁定匹配並運用在CRM。CRM運用情境舉例說明如下:
    1. 日後當粉絲於您的服務圈發訊,就可以知道是哪位會員而得以更貼切的個人化訊息回應。
    2. 可透過服務圈管理後台或是搭配自動發訊API 以特定名單發送特定的個人化/客製化訊息給會員。以電商為例,當顧客透過VIP會員認證API完成身份認證後,可依歷史瀏覽記錄推播商品促銷訊息,或折價券入帳提醒,甚至是購物車結帳通知,以刺激購物
  2. 自動發訊API:可在特定情境/狀況或時間點自動發送多元化訊息給所有粉絲或特定粉絲,既即時又節省人力,並可省下大量傳統簡訊費用。以保險業為例,可針對所有粉絲發送保健知識或新的保險資訊,當投保客戶的保費繳交期限將至但尚未繳費時,即可透過自動發訊API發送保費繳費提醒訊息;另以醫療業搭配VIP會員認證API認證患者身分為例,當病患於現場或透過電話完成掛號,可透過自動發訊API發送掛號號碼以及看診相關資訊。
  3. 機器人API:當紛絲在您的服務圈傳訊息時,可透過機器人API針對粉絲傳送的訊息自動回覆對應的訊息給粉絲,讓粉絲可於線上即時得到一些基本問題或資訊的回應並節省處置人力。以證券公司為例,可應用在股價查詢,當粉絲在服務圈聊天室內輸入上市公司股票代碼,透過機器人API,便可自動發訊回覆粉絲查詢的股票代碼的股價資訊給用戶。
如何申請服務圈這個服務?
在開發API前,請先上服務圈(https://club.mplusapp.com/MplusCelebrityManager/RegisterType.jsp)申請企業商用帳號後,將由專人與您聯繫相關事宜。
使用M+服務圈API是否需要付費?是否有發訊數量的限制?
三支API皆需各別收取一次性的設定費,另外,針對自動發訊API及機器人API皆需採購每月的發訊數量,最低採購訊息量為100萬則。API設定費和API發訊數量的採購費用將由專人依您的需求報價。
如何取得串接API的帳號、密碼和AESKEY等資料?
在成功申請服務圈帳號,並有專人與您聯繫時,您可提出使用API需求,將可由專人提供API的帳號、密碼和AESKEY等串接API所需資料。

自動發訊 API

呼叫API的方式為何?
透過HTTPS POST方法並使用multipart作為資料傳輸格式。
可以發多筆訊息嗎?
目前僅有文字訊息(msgType = T)可以一次多筆訊息於API發送。
可支援圖片的類型有哪些?
目前僅支援jpg格式圖檔。
是否有呼叫的範例?
API文件內有提供範例,詳細內容請參考文件。
發訊有時間限制嗎?
為避免打擾M+用戶,發訊時間限制為05:00~22:00;若不在前述可發訊的限制時間範圍內發訊,用戶將不會收到任何發送的訊息。
每日發訊有次數限制嗎?
您可以同時發送訊息給少於100人或超過100人,若發送人數超過100人則稱為大量發訊,若發送人數少於100人則稱為小量發訊。
每日發送的訊息次數將視小量發訊或大量發訊而有所不同。若當天發送的訊息皆為小量發訊,則最高可發送4,000則;若為大量發訊,則最高可發送30則;若發送的訊息有大量訊息也有小量訊息,則除前述各自發訊數量上限外,當天發訊總則數(小量發訊則數+大量發訊則數)亦不得超過4,030則。
自動發訊使用情境
以設備商為例,當設備發生異常時,可透過自動發訊API直接將障礙訊息傳送給合作的客戶,省去溝通聯絡的成本

機器人API

服務圈機器人可以使用的情境
舉例來說,您可以應用在股價查詢,圈粉於聊天室輸入上市公司股票代碼後,機器人將股票代碼轉發至您提供的接收網址後,機器人會將網址回應的股票資訊轉發給圈粉。
所謂接收網址需要符合甚麼規範?
網址必須使用有效且未過期的憑證,且支援POST method,接收訊息的方式請參考企業提供的URL
是否有呼叫的範例?
機器人API內有提供範例,詳細內容請參考判斷用戶輸入訊息類型
是否有流量的限制?
接收網址需考量大量圈粉發送訊息的負載,若機器人發送訊息後接收網址逾時無回應超過三次,訊息將無法接收。
機器人API所設定的接收網址能否設在防火牆內?
可以,由於M+系統需連線呼叫,若您所設定的接收網址在防火牆內,請依M+所提供的系統來源IP先開通連線防火牆
呼叫有問題如何除錯? 錯誤代碼表?
最常遇到的錯誤為接收的訊息無法解密,錯誤代碼表請參考Output Parameter

VIP會員認證API

VIP API使用情境?
可運用VIP API與自家會員資料庫做串接,透過傳送過去的M+ UID與登入會員mapping後加以運用,以媒體業為例,可設計訂閱項目供用戶選擇,若用戶對生活類新聞有興趣,可透過自動發訊推播相關訊息
VIP會員認證綁定後是否可以取消
可以,有下列幾種情況VIP會員的認證綁定會被取消。
  1. 若因粉絲已非會員等原因,您可主動取消VIP會員認證:您的系統可透過呼叫取消VIP會員認證API解除綁定,在成功取消後M+會發送解綁通知給粉絲。
  2. 粉絲主動取消:當粉絲進入服務圈後在功能選單點選管理VIP會員,進入您的VIP會員頁面,點選取消VIP會員,則您的系統需呼叫並通知M+更新會員解綁的結果,而M+會發送解綁通知給粉絲。