字節(jié)跳動(dòng)小程序接入消息通知指南

能力概況

為便于開發(fā)者對用戶進(jìn)行服務(wù)消息觸達(dá)，簡化小程序模板消息下發(fā)流程，小程序提供統(tǒng)一的服務(wù)消息下發(fā)接口，以便實(shí)現(xiàn)服務(wù)的閉環(huán)并提供更佳的體驗(yàn)。

宿主支持

今日頭條已上線，其他宿主陸續(xù)接入中。

入口位置

• 「我的-消息通知」入口

• 「頭條內(nèi)氣泡」入口（只有部分消息通知會(huì)展示該入口，由平臺審核）

接入流程

步驟一：獲取模版 ID

前往開發(fā)者平臺，在「消息通知」板塊，點(diǎn)擊添加模版；

添加模版有兩種方式：

• 選擇模版庫中的模版 添加模版庫中的模版，可直接添加使用，選中某個(gè)模版點(diǎn)擊添加后，選擇相關(guān)關(guān)鍵詞配置，如果還想添加更多的關(guān)鍵詞或者定義好的關(guān)鍵詞不符合預(yù)期，可申請新的關(guān)鍵詞（提交后需審核），右邊為該消息模版的展示預(yù)覽。

• 自定義模版 若模版庫中的模版不符合預(yù)期，可申請自定義模版，點(diǎn)擊右上角的申請新模版；

根據(jù)相應(yīng)的提示文字進(jìn)行自定義模版填寫（該申請需要審核）。

步驟二：使用 formid 作為發(fā)送消息通知的憑證

• 獲取途徑

  • 頁面的 form 組件，屬性 report-submit 為 true 時(shí)，可以聲明為需要發(fā)送模板消息，此時(shí)點(diǎn)擊按鈕提交表單可以獲取 formId，用于發(fā)送模板消息
  • 點(diǎn)擊一次隨機(jī)生成一個(gè) formid，類似 uuid（32 位），傳給開發(fā)者

• 消耗途徑

  • 每發(fā)送一條消息，消耗一個(gè) formid
  • 調(diào)取 send 來發(fā)送消息（已支持、send 接口文檔：http://www.o2fo.com/microapp/microapp-3l5g36b3.html ）
    

下發(fā)條件說明

有效期及限制

1.每個(gè) formid 從生成時(shí)間開始，7 天內(nèi)有效

2.1 次提交表單可下發(fā) 1 條，多次提交下發(fā)條數(shù)獨(dú)立，相互不影響

3.登錄才能收集用戶 formid

常見問題：

Q：如果后臺添加的時(shí)候 是兩個(gè)關(guān)鍵詞，發(fā)送的時(shí)候小于兩個(gè)會(huì)報(bào)錯(cuò)嗎？

A：會(huì)的，需要填滿數(shù)據(jù)。

Q：小氣泡的入口可以點(diǎn)擊進(jìn)入小程序嗎？可以進(jìn)入指定頁面嗎？

A：可以點(diǎn)擊進(jìn)入小程序內(nèi)配置的對應(yīng)頁面。

Q：有定向的用戶限制嗎？

A：面向使用過的用戶，需要收集用戶的 formID。