Udostępnij za pośrednictwem

Tworzenie komunikatów za pomocą interfejsu API łącznika botów

  • Artykuł

Bot wyśle obiekty aktywności typu komunikat o typie, aby przekazać informacje użytkownikom, a także otrzyma działania komunikatów od użytkowników. Niektóre komunikaty mogą po prostu składać się z zwykłego tekstu, podczas gdy inne mogą zawierać bogatszą zawartość, taką jak tekst do wypowiadania, sugerowane akcje, załączniki multimediów, karty sformatowane i dane specyficzne dla kanału. W tym artykule opisano niektóre często używane właściwości komunikatów.

Tekst i formatowanie wiadomości

Tekst wiadomości można sformatować przy użyciu zwykłego, markdown lub xml. Domyślny format textFormat właściwości to markdown i interpretuje tekst przy użyciu standardów formatowania języka Markdown. Poziom obsługi formatu tekstu różni się w zależności od kanałów.

Porada

Aby uzyskać informacje o funkcjach obsługiwanych w poszczególnych kanałach, zobacz artykuł referencyjny dotyczący kanałów .

Właściwość textFormat obiektu Activity może służyć do określania formatu tekstu. Aby na przykład utworzyć podstawowy komunikat zawierający tylko zwykły tekst, ustaw textFormat właściwość Activity obiektu na zwykły, ustaw text właściwość na zawartość komunikatu i ustaw locale właściwość na ustawienia regionalne nadawcy.

Załączniki

Właściwość attachments obiektu Activity może służyć do wysyłania prostych załączników multimedialnych (obraz, dźwięk, wideo, plik) i bogatych kart. Aby uzyskać szczegółowe informacje, zobacz Dodawanie załączników multimedialnych do wiadomości i Dodawanie zaawansowanych kart do wiadomości.

Jednostki

Właściwość entities obiektu Activity jest tablicą otwartych obiektów schema.org , które umożliwiają wymianę typowych metadanych kontekstowych między kanałem a botem.

Wzmianka o jednostkach

Wiele kanałów umożliwia botowi lub użytkownikowi "wzmiankę" w kontekście konwersacji. Aby wspomnieć użytkownika w komunikacie, wypełnij właściwość komunikatu entities obiektem Wzmianka .

Umieść jednostki

Aby przekazać informacje dotyczące lokalizacji w komunikacie, wypełnij właściwość komunikatu entities obiektami Place .

Dane kanału

Właściwość channelData obiektu Activity może służyć do implementowania funkcji specyficznych dla kanału. Aby uzyskać szczegółowe informacje, zobacz Implementowanie funkcji specyficznych dla kanału.

Zamiana tekstu na mowę

Właściwość speak obiektu Activity może służyć do określania tekstu, który ma być używany przez bota w kanale obsługującym mowę, a inputHint właściwość Activity obiektu może służyć do wywierania wpływu na stan mikrofonu klienta. Aby uzyskać szczegółowe informacje, zobacz Dodawanie mowy do komunikatów i Dodawanie wskazówek wejściowych do komunikatów.

Sugerowane akcje

Właściwość suggestedActions obiektu Activity może służyć do prezentowania przycisków, które użytkownik może nacisnąć, aby podać dane wejściowe. W przeciwieństwie do przycisków wyświetlanych na kartach bogatych (które pozostają widoczne i dostępne dla użytkownika nawet po naciśnięciu), przyciski wyświetlane w okienku sugerowanych akcji znikną po dokonaniu wyboru przez użytkownika. Aby uzyskać szczegółowe informacje, zobacz Dodawanie sugerowanych akcji do komunikatów.

Dodatkowe zasoby