Megosztás a következőn keresztül:

Üzenetek létrehozása a Bot Connector API-val

  • Cikk

A robot olyan típusú tevékenységobjektumokat küld , amelyek információkat küldenek a felhasználóknak, és hasonlóképpen üzenettevékenységeket is kapnak a felhasználóktól. Egyes üzenetek egyszerű szövegből állhatnak, míg mások gazdagabb tartalmakat tartalmazhatnak, például kimondandó szöveget, javasolt műveleteket, médiamellékleteket, rich kártyákat és csatornaspecifikus adatokat. Ez a cikk a gyakran használt üzenettulajdonságokat ismerteti.

Üzenet szövege és formázása

Az üzenet szövege formázható egyszerű, markdown vagy xml használatával. A tulajdonság alapértelmezett formátuma a textFormatMarkdown , és a Markdown formázási szabványokkal értelmezi a szöveget. A szövegformátum-támogatás szintje csatornánként eltérő lehet.

Tipp

Az egyes csatornákon támogatott funkciókról a csatornákra vonatkozó referenciacikkben talál további információt.

A textFormatTevékenység objektum tulajdonsága a szöveg formátumának megadására használható. Ha például egyszerű szöveget tartalmazó egyszerű üzenetet szeretne létrehozni, állítsa az textFormatActivity objektum tulajdonságát egyszerűre, állítsa a text tulajdonságot az üzenet tartalmára, és állítsa a locale tulajdonságot a feladó területi beállítására.

Mellékletek

A attachmentsTevékenység objektum tulajdonsága egyszerű médiamellékletek (kép, hang, videó, fájl) és gazdag kártyák küldésére használható. Részletekért lásd: Médiamellékletek hozzáadása az üzenetekhez és Rich-kártyák hozzáadása az üzenetekhez.

Entitások

A entitiesTevékenység objektum tulajdonsága nyílt végű schema.org objektumok tömbje, amely lehetővé teszi a közös környezetfüggő metaadatok cseréjét a csatorna és a robot között.

Entitások említése

Számos csatorna támogatja, hogy egy robot vagy felhasználó "megemlítsen" valakit egy beszélgetés kontextusában. Ha meg szeretne említeni egy felhasználót egy üzenetben, töltse ki az üzenet tulajdonságát entities egy Megemlítés objektummal.

Entitások elhelyezése

Ha egy üzenetben helyekkel kapcsolatos információkat szeretne közvetíteni, töltse ki az üzenet tulajdonságát entitiesPlace objektumokkal.

Csatornaadatok

A channelDataTevékenység objektum tulajdonsága csatornaspecifikus funkciók megvalósításához használható. További részletekért lásd: Csatornaspecifikus funkciók implementálása.

Szövegfelolvasás

A speakTevékenység objektum tulajdonságával megadhatja a robot által kimondandó szöveget egy beszédalapú csatornán, és az inputHintActivity objektum tulajdonsága az ügyfél mikrofonjának állapotának befolyásolására használható. Részletekért lásd: Beszéd hozzáadása üzenetekhez és Beviteli tippek hozzáadása az üzenetekhez.

Javasolt műveletek

A suggestedActionsTevékenység objektum tulajdonsága olyan gombok bemutatására használható, amelyekre a felhasználó koppintva adhat meg bemenetet. A gazdag kártyákon megjelenő gombokkal ellentétben (amelyek a koppintás után is láthatók és elérhetők maradnak a felhasználó számára), a javasolt műveletek panelen megjelenő gombok eltűnnek, miután a felhasználó kiválasztotta őket. Részletekért lásd: Javasolt műveletek hozzáadása az üzenetekhez.

További források