共用方式為


使用 Bot 連接器 API 建立訊息

Bot 會傳送訊息類型的 Activity 物件以傳達資訊給使用者,此外,也同樣會接收來自使用者的訊息活動。 某些訊息可能只包含純文字,而其他訊息可能包含更豐富的內容,例如要讀出的文字建議的動作媒體附件複合式資訊卡 (Rich Card)通道特有資料。 本文說明部分的常用訊息屬性。

簡訊和格式設定

使用 plainmarkdownxml 可以將訊息格式化。 textFormat 屬性的預設格式為 markdown,以及使用 Markdown 格式設定標準來解譯文字。 文字格式支援的層級因通道而異。

提示

如需每個通道支援哪些功能的相關資訊,請參閱 通道參考 文章。

Activity 物件的 textFormat 屬性可用來指定文字的格式。 例如,若要建立只包含純文字的基本訊息,請將 Activity 物件的 textFormat 屬性設定為 plain,將 text 屬性設定為訊息的內容,並將 locale 屬性設定為寄件者的地區設定。

附件

Activity 物件的 attachments 屬性可用來傳送簡單媒體附件 (影像、音訊、視訊、檔案) 和複合式資訊卡 (Rich Card)。 如需詳細資訊,請參閱將媒體附件新增至訊息將複合式資訊卡 (Rich Card) 新增至訊息

實體

Activity 物件的 entities 屬性是開放式 schema.org 物件的陣列,允許交換通道與 Bot 之間的通用內容中繼資料。

提及實體

許多通道都支援 Bot 或使用者在交談內容中「提及」某人的功能。 若要在訊息中提及使用者,請以 Mention 物件填入訊息的 entities 屬性。

放置實體

若要傳達訊息內的位置相關資訊,請使用Place物件填入訊息的 entities 屬性。

通道資料

Activity 物件的 channelData 屬性可用來實作通道特有功能。 如需詳細資訊,請參閱實作通道特有功能

將文字轉換成語音

Activity 物件的 speak 屬性可用來指定將由 Bot 在已啟用語音的通道上讀出的文字,而 inputHint 物件的 Activity 屬性可用來影響用戶端的麥克風狀態。 如需詳細資訊,請參閱將語音新增至訊息將輸入提示新增至訊息

建議動作

Activity 物件的 suggestedActions 屬性可用來呈現使用者可點選以提供輸入的按鈕。 不同於複合式資訊卡 (Rich Card) 中出現的按鈕 (即使在點選之後,使用者仍可看見並可存取),出現在建議動作窗格內的按鈕會在使用者進行選取後消失。 如需詳細資訊,請參閱將建議的動作新增至訊息

其他資源