Bot Connector API를 사용 하 여 메시지 만들기Create messages with the Bot Connector API

봇은 사용자에게 정보를 전달하도록 메시지 형식의 Activity 개체를 보내고 마찬가지로 사용자에게서 메시지 작업을 받습니다.Your bot will send Activity objects of type message to communicate information to users, and likewise, will also receive message activities from users. 일부 메시지는 단순히 일반 텍스트로 구성되는 반면 다른 메시지에는 음성 텍스트, 제안된 동작, 미디어 첨부 파일, 리치(rich) 카드채널 관련 데이터와 같은 다양한 콘텐츠가 포함될 수 있습니다.Some messages may simply consist of plain text, while others may contain richer content such as text to be spoken, suggested actions, media attachments, rich cards, and channel-specific data. 이 문서는 일반적으로 사용되는 메시지 속성의 일부를 설명합니다.This article describes some of the commonly-used message properties.

메시지 텍스트 및 서식 지정Message text and formatting

메시지 텍스트는 일반, Markdown 또는 xml을 사용하여 서식 지정될 수 있습니다.Message text can be formatted using plain, markdown, or xml. textFormat 속성에 대한 기본 형식은 Markdown이며 Markdown 서식 지정 표준을 사용하여 텍스트를 해석합니다.The default format for the textFormat property is markdown and interprets text using Markdown formatting standards. 텍스트 형식 지원의 수준은 채널에 따라 달라집니다.The level of text format support varies across channels.

각 채널에서 지원되는 기능을 설명하는 표는 채널 참조 문서를 참조하세요.For tables describing which features are supported on each channel, see the channels reference article.

Activity 개체의 textFormat 속성은 텍스트의 서식을 지정하는 데 사용할 수 있습니다.The textFormat property of the Activity object can be used to specify the format of the text. 예를 들어 일반 텍스트만 포함하는 기본 메시지를 만들려면 Activity 개체의 textFormat 속성을 일반으로 설정하고, text 속성을 메시지의 콘텐츠로 설정하고 locale 속성을 발신자의 로캘로 설정합니다.For example, to create a basic message that contains only plain text, set the textFormat property of the Activity object to plain, set the text property to the contents of the message and set the locale property to the locale of the sender.

AttachmentsAttachments

Activity 개체의 attachments 속성은 간단한 미디어 첨부 파일(이미지, 오디오, 비디오, 파일) 및 서식 있는 카드를 보내는 데 사용할 수 있습니다.The attachments property of the Activity object can be used to send simple media attachments (image, audio, video, file) and rich cards. 자세한 내용은 메시지에 미디어 첨부 파일 추가메시지에 다양한 카드 추가를 참조하세요.For details, see Add media attachments to messages and Add rich cards to messages.

엔터티Entities

Activity 개체의 entities 속성은 채널과 봇 간의 일반적인 상황별 메타데이터를 교환할 수 있는 개방형 schema.org 개체의 배열입니다.The entities property of the Activity object is an array of open-ended schema.org objects that allows the exchange of common contextual metadata between the channel and bot.

멘션 엔터티Mention entities

다양한 채널은 봇 또는 사용자가 대화 컨텍스트 내에서 누군가를 "멘션"하기 위한 기능을 지원합니다.Many channels support the ability for a bot or user to "mention" someone within the context of a conversation. 메시지에서 사용자를 멘션하려면 메시지의 entities 속성을 Mention 개체로 채웁니다.To mention a user in a message, populate the message's entities property with a Mention object.

장소 엔터티Place entities

메시지 내에서 위치 관련 정보를 전달하려면 메시지의 entities 속성을 Place 개체로 채웁니다.To convey location-related information within a message, populate the message's entities property with Place object.

채널 데이터Channel data

Activity 개체의 channelData 속성은 채널 관련 기능을 구현하는 데 사용할 수 있습니다.The channelData property of the Activity object can be used to implement channel-specific functionality. 자세한 내용은 채널 관련 기능 구현을 참조하세요.For details, see Implement channel-specific functionality.

텍스트 음성 변환Text to speech

Activity 개체의 speak 속성은 음성 지원 채널의 봇에서 말할 텍스트를 지정하는 데 사용할 수 있고 Activity 개체의 inputHint 속성은 클라이언트의 마이크의 상태에 영향을 주는 데 사용할 수 있습니다.The speak property of the Activity object can be used to specify the text to be spoken by your bot on a speech-enabled channel and the inputHint property of the Activity object can be used to influence the state of the client's microphone. 자세한 내용은 메시지에 음성 추가메시지에 입력 힌트 추가를 참조하세요.For details, see Add speech to messages and Add input hints to messages.

제안된 작업Suggested actions

Activity 개체의 suggestedActions 속성은 사용자가 입력을 제공하기 위해 누를 수 있는 단추를 표시하는 데 사용할 수 있습니다.The suggestedActions property of the Activity object can be used to present buttons that the user can tap to provide input. 제안된 동작 창 내에 표시되는 단추는 서식 있는 카드 내에 표시되는 단추와 달리(탭한 후에도 사용자에게 표시되고 액세스 가능함) 사용자가 선택한 후에 사라집니다.Unlike buttons that appear within rich cards (which remain visible and accessible to the user even after being tapped), buttons that appear within the suggested actions pane will disappear after the user makes a selection. 자세한 내용은 메시지에 제안된 작업 추가를 참조하세요.For details, see Add suggested actions to messages.

추가 리소스Additional resources