Csatornák referenciája

Cikk
06/09/2022
6 perc alatt elolvasható

Kategorizált tevékenységek csatorna szerint

A KÖVETKEZŐKRE VONATKOZIK: SDK v4

Az alábbi táblázatok azt mutatják be, hogy milyen események (tevékenységek a vezetéken) származhatnak, mely csatornákról származhatnak.

Ezek a szimbólumok a táblázatokban használatosak:

Szimbólum	Értelmezés
✔	A robotnak várhatóan megkapja ezt a tevékenységet.
❌	A robotnak soha nem szabad elvárnia, hogy megkapja ezt a tevékenységet.
❓	Jelenleg nem állapítható meg, hogy a robot megkapja-e ezt.

A tevékenységek tartalmasan feloszthatók külön kategóriákra. Minden kategóriához tartozik egy táblázat a lehetséges tevékenységekről. A Bot Framework tevékenységsémában részletes leírást talál az egyes tevékenységtípusokról, valamint az egyes tevékenységtípusok által tartalmazott információkról.

Társalgási

\	Direct Line	Közvetlen vonal (webes csevegés)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Vállalati verzió	Telegram	Twilio
`message`	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`messageReaction`	❌	❌	❌	❌	❌	✔	❌	❌	❌	❌	❌

Minden csatorna üzenettevékenységeket küld.
Ha a robot párbeszédpanelt használ, továbbítsa az üzenettevékenységeket a párbeszédpanelre.
Az üzenetválaszokat nem kell továbbítani a párbeszédpanelre, még akkor sem, ha azok nagyon is részei a beszélgetésnek.
Logikailag kétféle üzenetreakció létezik: hozzáadva és eltávolítva.

Tipp

Az üzenetválaszok olyan dolgok, mint egy hüvelykujj egy előző megjegyzéshez. Ezek sorrenden kívül is történhetnek, és a gombokhoz hasonlónak tekinthetők.

Üdvözlőképernyő

\	Direct Line	Közvetlen vonal (webes csevegés)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Vállalati verzió	Telegram	Twilio
`conversationUpdate`	✔	✔	❌	❓	✔	✔	✔	❌	❌	✔	❌
`contactRelationUpdate`	❌	❌	❌	❌	❌	❌	❌	✔	✔	❌	❌

A csatornák gyakran küldenek beszélgetésfrissítési tevékenységeket.
A beszélgetésfrissítések fő típusai a felvett beszélgetési tagok és a tagok eltávolítása.
Egyes csatornák akkor küldik el a beszélgetés frissítését, ha a robot hozzá van adva egy beszélgetéshez, mások pedig a robotnak küldött első üzenet után.
A megbízható üdvözlő viselkedés létrehozásához vegye fel a felhasználói állapotot a robotok üdvözlőlogikáiba.

Alkalmazás bővíthetősége

\	Direct Line	Közvetlen vonal (webes csevegés)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Vállalati verzió	Telegram	Twilio
`event`	✔	✔	❓	❓	❓	❓	❓	❓	❓	❓	❓
name = `CreateConversation`	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓
name = `ContinueConversation`	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓

Az eseménytevékenységek programozott információkat közölnek egy ügyfélről vagy csatornáról egy robottal. Az eseménytevékenységek jelentését a name mező határozza meg, amely egy csatorna hatókörén belül értelmezhető.
Az ügyfél és a kiszolgáló tulajdonában lévő alkalmazások úgy is választhatnak, hogy eseménytevékenységek használatával alagútba bújtatják a saját eseményeiket a szolgáltatáson keresztül.

Microsoft Teams

Más tevékenységtípusokkal együtt a Microsoft Teams meghatároz néhány Teams-specifikus invoke tevékenységet. További információért tekintse meg a Microsoft Teams-robotok működését .
A meghívási tevékenységek programozott információkat közölnek egy ügyfélről vagy csatornáról egy robottal, és megfelelő hasznos adattal rendelkeznek a csatornán belüli használatra. A meghívási tevékenység jelentését a name mező határozza meg, amely a csatorna hatókörén belül értelmezhető.

Üzenetfrissítés

\	Direct Line	Közvetlen vonal (webes csevegés)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Vállalati verzió	Telegram	Twilio
`messageUpdate`	❌	❌	❌	❌	❌	✔	❓	❌	❌	❌	❌
`messageDelete`	❌	❌	❌	❌	❌	✔	❓	❌	❌	❌	❌

Az üzenetfrissítést jelenleg a Teams támogatja.

OAuth

\	Direct Line	Közvetlen vonal (webes csevegés)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Vállalati verzió	Telegram	Twilio
`invoke`	✔	✔	❌	❓	❓	❌	❓	❓	❓	❓	❓

Fontos

A párbeszédpanelek és az OAuth-kérések működéséhez a következő meghívási tevékenységeket kell továbbítania a párbeszédpanelre:

signin/verifyState
signin/tokenExchange
tokens/response

Nem kategorizált

\	Direct Line	Közvetlen vonal (webes csevegés)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Vállalati verzió	Telegram	Twilio
`endOfConversation`	✔	✔	❌	❌	❌	❌	❌	❌	❌	❌	❌
`installationUpdate`	✔	✔	❌	❌	❌	❌	❌	❌	❌	❌	❌
`typing`	✔	✔	❌	✔	❌	❌	❌	❌	❌	❌	❌

Használaton kívül

deleteUserData
handoff
invoke: fizetési kérelem
invoke: cím
ping

Megjegyzés

Az átadási tevékenység eltér az embertől az emberhez való átadási forgatókönyvtől. További információért tekintse meg a robotról az emberre irányuló beszélgetések közötti váltást ismertető témakört.

Csatornánként támogatott tevékenységek összegzése

Direct Line

conversationUpdate
event
- CreateConversation
- ContinueConversation
invoke
- signin/tokenExchange
- signin/verifyState
- tokens/response
message

E-mail

message

Facebook

invoke
- tokens/response
message

GroupMe

conversationUpdate
invoke
- tokens/response
message

Kik

conversationUpdate
invoke
- tokens/response
message

Teams

conversationUpdate
invoke
message
messageDelete
messageReaction
messageUpdate

Slack

conversationUpdate
invoke
- tokens/response
message

Skype

contactRelationUpdate
invoke
- tokens/response
message

Skype Vállalati verzió

contactRelationUpdate
invoke
- tokens/response
message

conversationUpdate
invoke
- tokens/response
message

Twilio

message

Összesítő tábla az összes tevékenységről az összes csatornára

\	Direct Line	Közvetlen vonal (webes csevegés)	E-mail	Facebook	GroupMe	Teams	Slack	Skype	Skype Vállalati verzió	Telegram	Twilio
`contactRelationUpdate`	❌	❌	❌	❌	❌	❌	❌	✔	✔	❌	❌
`conversationUpdate`	✔	✔	❌	❓	✔	✔	✔	❌	❌	✔	❌
`endOfConversation`	✔	✔	❌	❌	❌	❌	❌	❌	❌	❌	❌
`event`	✔	✔	❓	❓	❓	❓	❓	❓	❓	❓	❓
- `CreateConversation`	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓
- `ContinueConversation`	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓	❓
`installationUpdate`	✔	✔	❌	❌	❌	❌	❌	❌	❌	❌	❌
`message`	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔	✔
`messageDelete`	❌	❌	❌	❌	❌	✔	❓	❌	❌	❌	❌
`messageReaction`	❌	❌	❌	❌	❌	✔	❌	❌	❌	❌	❌
`messageUpdate`	❌	❌	❌	❌	❌	✔	❓	❌	❌	❌	❌
`typing`	✔	✔	❌	✔	❌	✔	✔	❌	❌	✔	❌

A támogatás és invoke a event tevékenységek a tevékenység nevétől függően változnak, és csatornánként változnak.

Művelettámogatás csatorna szerint

Az alábbi táblázat az egyes csatornákban támogatott javasolt műveletek és kártyaműveletek maximális számát mutatja. Ez ❌ azt jelzi, hogy a művelet egyáltalán nem támogatott a megadott csatornán.

\	Direct Line	Közvetlen vonal (webes csevegés)	E-mail	Facebook	GroupMe	Vonal	Teams	Slack	Skype	Skype Vállalati verzió	Telegram	Twilio
Javasolt műveletek	100	100	❌	10	❌	13	❌	❌	10	❌	100	❌
Kártyaműveletek	100	100	❌	3	❌	99	50	100	3	❌	❌	❌

A fenti táblázatban szereplő számokkal kapcsolatos további információkért tekintse meg az itt felsorolt csatornatámogatási kódot.

A javasolt műveletekkel kapcsolatos további információkért tekintse meg a beviteli cikk Használat gombjának használatát ismertető cikket.

A kártyaműveletekkel kapcsolatos további információkért tekintse meg a Média hozzáadása üzenetekhez című cikk Fő képkártya küldése szakaszát.

Kártyatámogatás csatorna szerint

Csatorna	Adaptív kártya	Animációs kártya	Hangkártya	Fő képkártya	Nyugtakártya	Bejelentkezési kártya	Miniatűr kártya	Videokártya
E-mail	🖼	📄	📄	✔	✔	✔	✔	📄
Facebook	⚠🖼	✔	❌	✔	✔	✔	✔	❌
GroupMe	🖼	📄	📄	📄	📄	📄	📄	📄
Vonal	⚠🖼	✔	📄	✔	✔	✔	✔	📄
Microsoft Teams	✔	❌	❌	✔	✔	✔	✔	❌
Skype	❌	✔	✔	✔	✔	✔	✔	✔
Slack	🖼	✔	📄	📄	✔	✔	📄	📄
Telegram	⚠🖼	✔	📄	✔	✔	✔	✔	✔
Twilio	🖼	📄	❌	📄	📄	📄	📄	❌
Webes csevegés	✔	✔	✔	✔	✔	✔	✔	✔