Bot Connector API를 사용하여 메시지 만들기
봇은 사용자에게 정보를 전달하도록 메시지 형식의 Activity 개체를 보내고 마찬가지로 사용자에게서 메시지 작업을 받습니다. 일부 메시지는 단순히 일반 텍스트로 구성되는 반면 다른 메시지에는 음성 텍스트, 제안된 동작, 미디어 첨부 파일, 리치(rich) 카드 및 채널 관련 데이터와 같은 다양한 콘텐츠가 포함될 수 있습니다. 이 문서는 일반적으로 사용되는 메시지 속성의 일부를 설명합니다.
메시지 텍스트 및 서식 지정
메시지 텍스트는 일반, Markdown 또는 xml을 사용하여 서식 지정될 수 있습니다. textFormat 속성에 대한 기본 형식은 Markdown이며 Markdown 서식 지정 표준을 사용하여 텍스트를 해석합니다. 텍스트 형식 지원의 수준은 채널에 따라 달라집니다.
팁
각 채널에서 지원되는 기능에 대한 자세한 내용은 채널 참조 문서를 참조하세요.
Activity 개체의 textFormat 속성은 텍스트의 서식을 지정하는 데 사용할 수 있습니다. 예를 들어 일반 텍스트만 포함하는 기본 메시지를 만들려면 Activity 개체의 textFormat 속성을 일반으로 설정하고, text 속성을 메시지의 콘텐츠로 설정하고 locale 속성을 발신자의 로캘로 설정합니다.
Attachments
Activity 개체의 attachments 속성은 간단한 미디어 첨부 파일(이미지, 오디오, 비디오, 파일) 및 서식 있는 카드를 보내는 데 사용할 수 있습니다. 자세한 내용은 메시지에 미디어 첨부 파일 추가 및 메시지에 다양한 카드 추가를 참조하세요.
엔터티
Activity 개체의 entities 속성은 채널과 봇 간의 일반적인 상황별 메타데이터를 교환할 수 있는 개방형 schema.org 개체의 배열입니다.
멘션 엔터티
다양한 채널은 봇 또는 사용자가 대화 컨텍스트 내에서 누군가를 "멘션"하기 위한 기능을 지원합니다. 메시지에서 사용자를 멘션하려면 메시지의 entities 속성을 Mention 개체로 채웁니다.
장소 엔터티
메시지 내에서 위치 관련 정보를 전달하려면 메시지의 entities 속성을 Place 개체로 채웁다.
채널 데이터
Activity 개체의 channelData 속성은 채널 관련 기능을 구현하는 데 사용할 수 있습니다. 자세한 내용은 채널 관련 기능 구현을 참조하세요.
텍스트 음성 변환
Activity 개체의 speak 속성은 음성 지원 채널의 봇에서 말할 텍스트를 지정하는 데 사용할 수 있고 Activity 개체의 inputHint 속성은 클라이언트의 마이크의 상태에 영향을 주는 데 사용할 수 있습니다. 자세한 내용은 메시지에 음성 추가 및 메시지에 입력 힌트 추가를 참조하세요.
제안된 작업
Activity 개체의 suggestedActions 속성은 사용자가 입력을 제공하기 위해 누를 수 있는 단추를 표시하는 데 사용할 수 있습니다. 제안된 동작 창 내에 표시되는 단추는 서식 있는 카드 내에 표시되는 단추와 달리(탭한 후에도 사용자에게 표시되고 액세스 가능함) 사용자가 선택한 후에 사라집니다. 자세한 내용은 메시지에 제안된 작업 추가를 참조하세요.