Delen via

Naslaginformatie over kanalen

  • Artikel

VAN TOEPASSING OP: SDK v4

In dit artikel vindt u een overzicht van kanaalondersteuning voor verschillende Bot Framework-functies:

  • De activiteitstypen die elk kanaal kan verzenden of ontvangen.
  • De kaarttypen die elk kanaal kunnen weergeven, inclusief adaptieve kaarten.
  • Kaartactie en voorgestelde actieondersteuning voor elk kanaal.
  • Een algemene classificatie van de verschillende activiteitstypen.

Zie de Bot Framework-activiteits- en kaartschema's voor gedetailleerde informatie over de structuur van activiteiten en kaarten op protocolniveau.

Adaptieve kaarten is een afzonderlijke technologie. Zie adaptivecards.io voor meer informatie.

Ondersteuning van activiteiten per kanaal

De volgende tabel geeft aan of een bepaald kanaal een bepaald activiteitstype naar uw bot kan verzenden. In de tabel hebben de volgende termen de volgende betekenissen.

Term Betekenis
Ja De bot kan deze activiteit van het kanaal ontvangen.
Nee De bot kan deze activiteit niet ontvangen van het kanaal.
Onbepaald Momenteel niet bepaald.
Channel Relatie-update contactpersoon Gespreksupdate Einde gesprek Gebeurtenis Installatie-update Aanroepen Bericht Berichtreactie Berichtupdate Bericht verwijderen Typen
Alexa Nee No Ja Ja No No Ja No Nee Nee Nr.
Azure Communication Services Nr. Ja No Ja No No Ja No Ja Ja Ja
Direct Line Nr. Ja Ja Ja Ja No Ja No Nee No Ja
Direct Line-spraak Ja
E-mailen Nee Nee Nr. Onbepaald Nee No Ja No Nee Nee Nr.
Facebook Nr. Ja No Ja No No Ja Ja No Nee Nr.
GroupMe Nr. Ja Nr. Onbepaald Nee No Ja No Nee Nee Nr.
LINE Nr. Ja No Ja No No Ja No Nee Nee Nr.
Microsoft Teams Nr. Ja Nr. Onbepaald Nr. Ja Ja Ja Ja Ja Nr.
Omnichannel Ja
Outlook (preview) Ja
Zoeken (preview) Ja
Slack Nr. Ja Nr. Onbepaald Nee No Ja No Ja Ja Nr.
Telegram Nr. Ja Nr. Onbepaald Nee No Ja No Ja Onbepaald Nee
Twilio (SMS) Nee Nee Nr. Onbepaald Nee No Ja No Nee Nee Nr.
Webgesprek Nr. Ja Ja Ja Ja No Ja No Nee No Ja

Ondersteuning voor event en invoke activiteiten verschilt per naam van de activiteit en verschilt per kanaal.

Kaartondersteuning per kanaal

De volgende tabel geeft aan of een bepaald kanaal een bepaald kaarttype kan weergeven. Zelfs als een kanaal een kaarttype kan weergeven, ondersteunt het kanaal mogelijk niet alle functies op de kaart. Voordat u uw bot vrijgeeft, test u het gedrag van elke kaart die uw bot kan verzenden.

In de tabel hebben de volgende termen de volgende betekenissen.

Term Betekenis
Ja De kaart wordt ondersteund op dit kanaal; Elk bepaald kanaal kan echter alleen een subset van kaartacties ondersteunen of het aantal acties beperken dat op elke kaart is toegestaan.
Nee De kaart wordt niet ondersteund op dit kanaal.
Gedeeltelijk Gedeeltelijke ondersteuning. In dit kanaal wordt de kaart mogelijk niet weergegeven als de kaart invoer of knoppen bevat. Het ondersteuningsniveau varieert per kanaal.
Afbeelding Kaart wordt geconverteerd naar afbeelding.
Sms verzenden Kaart wordt geconverteerd naar niet-opgemaakte tekst. Koppelingen kunnen mogelijk niet worden geklikt, afbeeldingen worden mogelijk niet weergegeven en media kunnen mogelijk niet worden afgespeeld. Het ondersteuningsniveau varieert per kanaal.
Channel Adaptieve kaart Animatiekaart Audiokaart Hero-kaart Ontvangstbewijskaart Aanmeldingskaart Miniatuurkaart Videokaart
Alexa Nee Nee No Ja No Ja No Nr.
Azure Communication Services Ja* Ja Ja Ja Ja Ja Ja Ja
E-mailen Afbeelding Sms verzenden Tekst Ja Ja Ja Ja Sms verzenden
Facebook Afbeelding, gedeeltelijk Ja Ja Ja Ja Ja Ja Ja
GroupMe Afbeelding Sms verzenden Sms verzenden Sms verzenden Sms verzenden Sms verzenden Sms verzenden Sms verzenden
LINE Afbeelding, gedeeltelijk Ja Tekst Ja Ja Ja Ja Sms verzenden
Microsoft Teams Ja No No Ja Ja Ja Ja Nr.
Omnichannel
Outlook (preview)
Zoeken (preview)
Slack Image Ja Sms verzenden Tekst Ja Ja Sms verzenden Sms verzenden
Telegram Afbeelding, gedeeltelijk Ja Tekst Ja Ja Ja Ja Ja
Twilio (SMS) Afbeelding Tekst Nee Sms verzenden Sms verzenden Sms verzenden Tekst Nee
Webgesprek Ja Ja Ja Ja Ja Ja Ja Ja

Notitie

  • Het Direct Line-kanaal ondersteunt technisch alle kaarten, maar het is aan de client om ze te implementeren.
  • *Voor Azure Communication Services Chat worden adaptieve kaarten alleen ondersteund in Azure Communication Services-gebruiksvoorbeelden en niet voor Azure Communication Services naar Teams-use cases.

Ondersteuning voor kaartacties per kanaal

In de volgende tabel ziet u het maximum aantal voorgestelde acties en kaartacties dat door een bepaald kanaal wordt ondersteund. Een waarde 'Geen' geeft aan dat het actietype niet wordt ondersteund in het kanaal.

Channel Voorgestelde acties Kaartacties
Alexa Geen Geen
Azure Communication Services
Direct Line 100 100
Direct Line-spraak 100 100
E-mailen Geen Geen
Facebook 11 3
GroupMe Geen Geen
LINE 13 99
Microsoft Teams Geen 3
Omnichannel
Outlook (preview)
Zoeken (preview)
Slack Geen 100
Telegram 100 100
Twilio (SMS) Geen Geen
Webgesprek 100 100

Activiteitscategorieën

Activiteiten kunnen worden onderverdeeld in afzonderlijke categorieën. Zie het Bot Framework-activiteitsschema voor een gedetailleerde beschrijving van elk type activiteit en de informatie die elk type activiteit bevat.

Welkom

Deze categorie omvat de conversationUpdate en contactRelationUpdate activiteiten.

  • Veel kanalen verzenden activiteiten voor het bijwerken van gesprekken.
    • Vaak wordt het welkomstgedrag van de bot geactiveerd door de activiteit voor het bijwerken van gesprekken. Het produceren van betrouwbaar welkomstgedrag vereist echter mogelijk het gebruik van de gespreks- of gebruikersstatus.
  • Sommige kanalen verzenden activiteiten voor het bijwerken van contactpersonen.
    • Als uw bot deze kanalen gebruikt, moet u mogelijk logica voor deze activiteit opnemen in het welkomstgedrag van uw bot.

Communicatief

Deze categorie omvat de message, messageReactionen endOfConversation activiteiten.

  • Alle kanalen kunnen berichtenactiviteiten verzenden en ontvangen.
    • Voor bots die dialoogvensters gebruiken, moeten berichtactiviteiten over het algemeen worden doorgegeven aan het dialoogvenster.
  • Sommige kanalen kunnen reactieactiviteiten voor berichten verzenden en ontvangen.
    • Afhankelijk van het ontwerp van uw bot, kunt u berichtreactieactiviteiten doorgeven aan een dialoogvenster.
    • Berichtenreactieactiviteiten verwijzen naar eerdere berichten op id.
  • Einde van gespreksactiviteiten geven het einde van een gesprek aan vanuit het perspectief van de afzender.
    • Het einde van gespreksactiviteiten wordt gebruikt in bot-naar-bot-communicatie voor vaardigheden.

Tip

Een berichtreactie bevat bijvoorbeeld een duim omhoog op een vorige opmerking. Ze kunnen niet op volgorde plaatsvinden, zodat ze kunnen worden beschouwd als vergelijkbaar met knoppen. Dit activiteitstype kan worden verzonden via het Teams-kanaal.

Bericht bijwerken en verwijderen

Deze categorie omvat de messageUpdate en messageDelete activiteiten.

  • Teams ondersteunt de activiteiten voor het bijwerken en verwijderen van berichten.

Uitbreidbaarheid van toepassingen

Deze categorie omvat de event en invoke activiteiten. De betekenis van de activiteit wordt gedefinieerd door het name veld, wat zinvol is binnen het bereik van een kanaal.

  • Een toepassing die eigenaar is van zowel de client als de server kan gebeurtenisactiviteiten gebruiken om programmatische informatie tussen de client en de server te communiceren.
    • Gebeurtenisactiviteiten, zoals de meeste activiteitstypen, zijn asynchroon.
    • Direct Line en Webchat gebeurtenisactiviteiten gebruiken als een uitbreidbaarheidsmechanisme.
  • Aanroepende activiteiten zijn specifiek voor een toepassing en niet iets dat een client zou definiëren.
    • Activiteiten aanroepen, in tegenstelling tot andere activiteitstypen, zijn synchroon. (Aanroepen is momenteel het enige activiteitstype waarmee het gedrag van een aanvraag-antwoord op de bot wordt geactiveerd.)
    • Microsoft Teams maakt gebruik van aanroepactiviteiten en definieert enkele Teams-specifieke aanroepactiviteiten.

Verificatie

De aanroepactiviteit moet worden doorgestuurd naar het dialoogvenster om de OAuth-prompt te laten werken met dialoogvensters TeamsVerification .

Niet-gecategoriseerd

De installationUpdate, typingen handoff activiteiten passen niet zinvol in de andere categorieën.

  • Installatie-updateactiviteiten vertegenwoordigen een installatie of verwijdering van een bot binnen een organisatie-eenheid van een kanaal.
  • Het typen van activiteiten vertegenwoordigt doorlopende invoer van een gebruiker of bot.
  • Handoff activities request or signal a change in focus between elements inside a bot. De handoff-activiteit verschilt van een gebeurtenisactiviteit met de naam 'handoff'.

Niet gebruikt (inclusief betalingsspecifieke aanroep)

Deze activiteitstypen worden niet meer gebruikt:

  • deleteUserData
  • handoff
  • ping
  • Address aanroepen
  • PaymentRequest aanroepen

Aanvullende informatie

Alle kanalen kunnen activiteiten verzenden en ontvangen message .

Tip

Wanneer u ondersteuning voor een kanaal toevoegt aan uw bot, moet u vertrouwd raken met de ontwikkelaarsdocumenten van het kanaal. Elk kanaal heeft verschillende beperkingen voor verschillende aspecten van een gesprek. Enkele van de verschillen zijn:

  • Hoeveel tijd de bot nodig heeft om elke HTTP-aanvraag te verwerken.
  • Of een bot een activiteit kan verzenden die niet reageert op een specifieke gebruikersactiviteit.
  • Hoeveel berichten de bot binnen een bepaald tijdsbestek kan verzenden.
  • Hoe een kaart wordt weergegeven en welke kaarten worden ondersteund.