跳到內容

創建計劃消息

帖子

/ /計劃/創建的消息

使用這個端點來安排活動、帆布、或其他在指定時間發送消息(在未來90天),為您提供一個標識符引用信息的更新。

如果你是針對一段,記錄將存儲在你的請求開發人員控製台畢竟計劃已經發送消息。

速率限製

我們應用默認釺速率限製每小時250000個請求的端點,作為記錄API率限製

釺端點支持批處理API請求。單個請求消息端點可以達到下列:

  • 50特定external_ids,每個與單個消息參數
  • 一段釺儀表板中創建的任何尺寸,由其指定的segment_id
  • 任何大小的特殊受眾細分,作為一個定義的請求連接觀眾對象

請求體


            
1 2
內容類型:application / json授權:無記名YOUR-REST-API-KEY

            
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30
{/ /需要包括至少一個“segment_id”,“external_user_ids”,“觀眾”/ /包括“segment_id”發送成員/ /包括“external_user_ids”和/或“user_aliases”發送那些用戶/ /包括這兩個一個用戶發送提供用戶如果他們“廣播”:(可選,布爾型)看到廣播- - -違約8/31日/17,必須真正的如果用戶指定的,“external_user_ids”:(可選,數組字符串)看到外部用戶標識符,“user_aliases”:(可選,數組用戶別名對象)看到用戶別名,“觀眾”:(可選,連接觀眾對象)看到連接觀眾,“segment_id”:(可選,字符串)看到標識符,“campaign_id”:(可選,字符串)看到運動標識符,“send_id”:(可選,字符串)看到發送標識符,“override_messaging_limits”:(可選,bool)忽略頻率限製規則,違約,“recipient_subscription_state”:(可選,字符串)使用發送消息隻有用戶選擇(“opted_in”),隻有用戶訂閱選擇(“訂閱”)所有用戶,包括沒訂閱用戶(所有的),後者有用的事務電子郵件消息傳遞。違約“訂閱”,“安排”:{“時間”:(需要,datetime作為ISO8601年字符串)時間發送消息,(90年未來),“in_local_time”:(可選,bool),“at_optimal_time”:(可選,bool),},“消息”:{“apple_push”:(可選,蘋果對象),“android_push”:(可選,安卓對象),“kindle_push”:(可選,kindle / fireOS對象),“web_push”:(可選,網絡對象),“電子郵件”:(可選,電子郵件對象),“webhook”:(可選,webhook對象),“content_card”:(可選,內容對象),“短信”:(可選,短信對象)}}

請求參數

參數 要求 數據類型 描述
廣播 可選 布爾 必須設置廣播為true時傳遞一個消息給整個市場活動或畫布上的目標。這個參數默認值為false(2017年8月31日)。

如果廣播被設置為true,收件人列表不能包括在內。然而,設置時要特別小心廣播:真,因為無意中設置此標誌可能導致你將你的信息發送到大於預期的觀眾。
external_user_ids 可選 字符串數組 看到外部用戶標識符
user_aliases 可選 用戶別名對象的數組 看到用戶別名對象
觀眾 可選 連接受眾對象 看到連接觀眾
segment_id 可選 字符串 看到段標識符
campaign_id 可選 字符串 看到活動標識符
收件人 可選 接受者對象的數組 看到收件人對象
send_id 可選 字符串 看到將標識符
override_messaging_limits 可選 布爾 忽視全球運動速度限製,默認值為false
recipient_subscription_state 可選 字符串 用這隻發送消息給用戶選擇(opted_in),隻有用戶認購或選擇在(訂閱)或所有用戶,包括沒訂閱用戶(所有)。

使用所有用戶是有用的事務性的郵件消息。默認為訂閱
時間表 要求 計劃的對象 看到計劃的對象
消息 可選 消息對象 看到可用的消息對象

示例請求


            
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75
curl——位置請求發布的https://rest.iad - 01. braze.com/messages/schedule/create \——data-raw '{“廣播”:“false”,“external_user_ids”:“external_user_identifiers”、“user_aliases”: {“alias_name”:“example_name”、“alias_label”:“example_label”},“segment_id”:“segment_identifiers”、“觀眾”:{"和":[{“custom_attribute”: {“custom_attribute_name”:“eye_color”,“比較”:“=”,“價值”:“藍色”}},{“custom_attribute”: {“custom_attribute_name”:“favorite_foods”,“比較”:“includes_value”、“價值”:“披薩”}},{”或“:[{“custom_attribute”: {“custom_attribute_name”:“last_purchase_time”,“比較”:“less_than_x_days_ago”、“價值”:2}},{“push_subscription_status”:{“比較”:“是”,“價值”:“opted_in}}]}, {“email_subscription_status”:{“比較”:“is_not”、“價值”:“訂閱”}},{“last_used_app”:{“比較”:“後”,“價值”:“2019 - 07 - 22 - t13:17:55 + 0000”}}]},“campaign_id”:“campaign_identifier”、“send_id”:“send_identifier”、“override_messaging_limits”:假的,“recipient_subscription_state”:“訂閱”,“計劃”:{“時間”:”“、“in_local_time”:真的,“at_optimal_time”:真正的},“消息”:{“apple_push”:(可選,蘋果推送對象)、“android_push”:(可選,Android將對象)、“kindle_push”:(可選,Kindle / FireOS推對象),“web_push”:(可選的,Web將對象),“電子郵件”:(可選,電子郵件對象)“webhook”(可選,webhook對象):“content_card”:(可選,內容卡對象)}}’

響應

例子成功響應


            
1 2 3 4 5
{“dispatch_id”:(字符串)調度標識符,“schedule_id”:(字符串)時間表標識符,“消息”:“成功”}
這個頁麵是有用嗎?
新東西!
Baidu
map