Kanalreferens

GÄLLER FÖR: SDK v4

Den här artikeln beskriver kanalstöd för olika Bot Framework-funktioner:

• Aktivitetstyperna som varje kanal kan skicka eller ta emot.
• Korttyperna som varje kanal kan visa, inklusive adaptiva kort.
• Kortåtgärd och föreslaget åtgärdsstöd för varje kanal.
• En allmän klassificering av de olika aktivitetstyperna.

Detaljerad information om strukturen för aktiviteter och kort på protokollnivå finns i Bot Framework-aktivitets- och kortscheman.

Adaptiva kort är en separat teknik. Mer information finns i adaptivecards.io.

Aktivitetsstöd per kanal

Följande tabell anger om en viss kanal kan skicka en viss aktivitetstyp till din robot. I tabellen har följande termer följande betydelser.

Term	Innebörd
Ja	Roboten kan ta emot den här aktiviteten från kanalen.
Nej	Roboten kan inte ta emot den här aktiviteten från kanalen.
Obestämd	För närvarande obestämt.

Kanal	Uppdatering av kontaktrelation	Konversationsuppdatering	Konversationens slut	Event	Installationsuppdatering	Anropa	Meddelande	Meddelandereaktion	Meddelandeuppdatering	Ta bort meddelande	Typing
Alexa	Nej	Nej	Ja	Ja	Nej	Nej	Ja	Nej	Nej	Nej	Nej
Azure Communication Services	Nej	Ja	No	Ja	Nej	Nej	Ja	No	Ja	Ja	Ja
Direct Line	Nej	Ja	Ja	Ja	Ja	No	Ja	Nej	Nej	Nej	Ja
Direct Line Speech							Ja
Email	Nej	Nej	Nej	Obestämd	Nej	Nej	Ja	Nej	Nej	Nej	Nej
Facebook	Nej	Ja	No	Ja	Nej	Nej	Ja	Ja	Nej	Nej	Nej
GroupMe	Nej	Ja	Nej	Obestämd	Nej	Nej	Ja	Nej	Nej	Nej	Nej
LINE	Nej	Ja	No	Ja	Nej	Nej	Ja	Nej	Nej	Nej	Nej
Microsoft Teams	Nej	Ja	Nej	Obestämd	Nej	Ja	Ja	Ja	Ja	Ja	Nej
Flerkanal							Ja
Outlook (förhandsversion)							Ja
Sök (förhandsversion)							Ja
Slack	Nej	Ja	Nej	Obestämd	Nej	Nej	Ja	No	Ja	Ja	Nej
Telegram	Nej	Ja	Nej	Obestämd	Nej	Nej	Ja	No	Ja	Obestämd	Nej
Twilio (SMS)	Nej	Nej	Nej	Obestämd	Nej	Nej	Ja	Nej	Nej	Nej	Nej
Webbchatt	Nej	Ja	Ja	Ja	Ja	No	Ja	Nej	Nej	Nej	Ja

Stöd för event och invoke aktiviteter varierar beroende på aktivitetens namn och varierar beroende på kanal.

Kortstöd av kanal

Följande tabell anger om en viss kanal kan återge en viss korttyp. Även om en kanal kan återge en korttyp kanske kanalen inte stöder alla funktioner på kortet. Innan du släpper roboten testar du beteendet för varje kort som roboten kan skicka.

I tabellen har följande termer följande betydelser.

Term	Innebörd
Ja	Kortet stöds på den här kanalen. En viss kanal kan dock bara stödja en delmängd kortåtgärder eller begränsa antalet åtgärder som tillåts på varje kort.
Nej	Kortet stöds inte på den här kanalen.
Delvis	Partiellt stöd. Den här kanalen kanske inte visar kortet om kortet innehåller indata eller knappar. Supportnivån varierar beroende på kanal.
Bild	Kortet konverteras till bild.
Text	Kortet konverteras till oformaterad text. Länkar kanske inte är klickbara, bilder kanske inte visas och media kanske inte kan spelas upp. Supportnivån varierar beroende på kanal.

Kanal	Adaptivt kort	Animeringskort	Ljudkort	Hjältekort	Kvittokort	Inloggningskort	Miniatyrkort	Grafikkort
Alexa	Nej	Nej	Nej	Ja	No	Ja	Nej	Nej
Azure Communication Services	Ja*	Ja	Ja	Ja	Ja	Ja	Ja	Ja
Email	Bild	Text	Text	Ja	Ja	Ja	Ja	Text
Facebook	Bild, partiell	Ja	Ja	Ja	Ja	Ja	Ja	Ja
GroupMe	Bild	Text	Text	Text	Text	Text	Text	Text
LINE	Bild, partiell	Ja	Text	Ja	Ja	Ja	Ja	Text
Microsoft Teams	Ja	Nej	Nej	Ja	Ja	Ja	Ja	Nej
Flerkanal
Outlook (förhandsversion)
Sök (förhandsversion)
Slack	Bild	Ja	Text	Text	Ja	Ja	Text	Text
Telegram	Bild, partiell	Ja	Text	Ja	Ja	Ja	Ja	Ja
Twilio (SMS)	Bild	Text	Nej	Text	Text	Text	Text	Nej
Webbchatt	Ja	Ja	Ja	Ja	Ja	Ja	Ja	Ja

Kommentar

• Direct Line-kanalen stöder tekniskt sett alla kort, men det är upp till klienten att implementera dem.
• *För Azure Communication Services Chat stöds adaptiva kort endast i Användningsfall för Azure Communication Services och inte för Användningsfall för Azure Communication Services till Teams.

Stöd för kortåtgärder per kanal

I följande tabell visas det maximala antalet föreslagna åtgärder och kortåtgärder som en viss kanal stöder. Värdet "Ingen" anger att åtgärdstypen inte stöds i kanalen.

Kanal	Föreslagna åtgärder	Kortåtgärder
Alexa	Ingen	Ingen
Azure Communication Services
Direct Line	100	100
Direct Line Speech	100	100
Email	Ingen	Ingen
Facebook	11	3
GroupMe	Ingen	Ingen
LINE	13	99
Microsoft Teams	Ingen	3
Flerkanal
Outlook (förhandsversion)
Sök (förhandsversion)
Slack	Ingen	100
Telegram	100	100
Twilio (SMS)	Ingen	Ingen
Webbchatt	100	100

• Mer information om kortåtgärder finns i Bearbeta händelser inom omfattande kort i artikeln Lägg till media i meddelanden .
• Mer information om föreslagna åtgärder finns i Använda knappar för indata.

Aktivitetskategorier

Aktiviteter kan delas upp i separata kategorier. En detaljerad beskrivning av varje typ av aktivitet och den information som varje typ av aktivitet innehåller finns i Bot Framework-aktivitetsschemat.

Välkommen

Den här kategorin innehåller aktiviteterna conversationUpdate och contactRelationUpdate .

• Många kanaler skickar konversationsuppdateringsaktiviteter.
  • Ofta utlöses robotens välkomstbeteende av konversationsuppdateringsaktiviteten. Att skapa ett tillförlitligt välkomstbeteende kan dock kräva användning av konversations- eller användartillstånd.
• Vissa kanaler skickar kontaktrelationsuppdateringsaktiviteter.
  • Om roboten använder dessa kanaler kan du behöva inkludera logik för den här aktiviteten i robotens välkomstbeteende.

Naturlig kommunikation

Den här kategorin innehåller aktiviteterna message, messageReactionoch endOfConversation .

• Alla kanaler kan skicka och ta emot meddelandeaktiviteter.
  • För robotar som använder dialogrutor bör meddelandeaktiviteter i allmänhet skickas till dialogrutan.
• Vissa kanaler kan skicka och ta emot meddelandereaktionsaktiviteter.
  • Beroende på robotens utformning kan du skicka meddelandereaktionsaktiviteter till en dialogruta.
  • Aktiviteter för meddelandereaktioner refererar till tidigare meddelanden efter ID.
• Avsluta konversationsaktiviteter signalerar slutet på en konversation ur avsändarens perspektiv.
  • Slut på konversationsaktiviteter används i robot-till-robot-kommunikation för färdigheter.

Dricks

En meddelandereaktion innehåller saker som en tumme upp på en tidigare kommentar. De kan ske i fel ordning, så att de kan betraktas som liknande knappar. Den här aktivitetstypen kan skickas av Teams-kanalen.

Uppdatera och ta bort meddelanden

Den här kategorin innehåller aktiviteterna messageUpdate och messageDelete .

• Teams stöder aktiviteterna för att uppdatera och ta bort meddelanden.

Utökningsbarhet för program

Den här kategorin innehåller aktiviteterna event och invoke . Aktivitetens betydelse definieras av dess name fält, vilket är meningsfullt inom omfånget för en kanal.

• Ett program som äger både klienten och servern kan använda händelseaktiviteter för att kommunicera programmatisk information mellan klienten och servern.
  • Händelseaktiviteter, som de flesta aktivitetstyper, är asynkrona.
  • Direct Line och Webbchatt använda händelseaktiviteter som en utökningsmekanism.
• Anropa aktiviteter är specifika för ett program och inte något som en klient skulle definiera.
  • Anropa aktiviteter, till skillnad från andra aktivitetstyper, är synkrona. (Invoke är för närvarande den enda aktivitetstypen som utlöser ett beteende för begäran-svar på roboten.)
  • Microsoft Teams använder anropa aktiviteter och definierar några Teams-specifika anropande aktiviteter.

Autentisering

För att OAuth-prompten ska fungera med dialogrutor måste anroparaktiviteten TeamsVerification vidarebefordras till dialogrutan.

Ej kategoriserade

Aktiviteterna installationUpdate, typingoch handoff passar inte in i de andra kategorierna på ett meningsfullt sätt.

• Installationsuppdateringsaktiviteter representerar en installation eller avinstallation av en robot i en organisationsenhet i en kanal.
• Att skriva aktiviteter representerar pågående indata från en användare eller en robot.
• Begäran om överlämningsaktiviteter eller signalera en ändring i fokus mellan element i en robot. Överlämningsaktiviteten skiljer sig från en händelseaktivitet som har namnet "överlämning".

Användningsfel (inkluderar betalningsspecifik anrop)

Dessa aktivitetstyper används inte längre:

• deleteUserData
• handoff
• ping
• Address åkalla
• PaymentRequest åkalla

Ytterligare information

Alla kanaler kan skicka och ta emot message aktiviteter.

Dricks

När du lägger till stöd för en kanal i din robot kan du bekanta dig med kanalens utvecklardokument. Varje kanal har olika begränsningar för olika aspekter av en konversation. Några av skillnaderna är:

• Hur lång tid roboten måste hantera varje HTTP-begäran.
• Om en robot kan skicka en aktivitet som inte svarar på en specifik användaraktivitet.
• Hur många meddelanden roboten kan skicka inom en viss tidsram.
• Hur ett kort återges och vilka kort som stöds.