Verbinding maken een bot naar het Outlook-kanaal voor bruikbare berichten (preview)

  • Artikel

VAN TOEPASSING OP: SDK v4

Met bruikbare berichten kunnen gebruikers snelle acties uitvoeren vanuit Outlook. Wanneer u een bot verbindt met het outlook-kanaal voor actieberichten, kan uw bot adaptieve kaarten gebruiken om bruikbare berichten te maken, waardoor de betrokkenheid van gebruikers wordt verbeterd.

Notitie

Het Outlook-kanaal voor berichten waarvoor actie kan worden ondernomen, bevindt zich in openbare preview. Functies die zijn opgenomen in de preview-versie zijn mogelijk niet voltooid en kunnen wijzigingen ondergaan voordat ze beschikbaar worden in de openbare release. Ze zijn alleen beschikbaar voor evaluatie- en verkenningsdoeleinden.

Waarschuwing

Het is een schending van de Gedragscode van Bot Framework om 'spambots' te maken, waaronder bots die ongewenste of ongevraagde bulk-e-mail verzenden.

Vereisten

Notitie

  • Gebruik niet uw eigen persoonlijke e-mailaccounts voor bots, omdat elk bericht dat naar dat e-mailaccount wordt verzonden, wordt doorgestuurd naar de bot. Dit kan ertoe leiden dat de bot een reactie naar een afzender ongepast verzendt. Bots mogen daarom alleen toegewezen O365-e-mailaccounts gebruiken.
  • Als u Microsoft Exchange Server gebruikt, schakelt u Automatisch opsporen in voordat u het e-mailkanaal configureert.

De berichten ontwerpen

Via het Outlook-kanaal voor berichten waarvoor actie kan worden ondernomen, worden adaptieve kaarten via e-mail verzonden en ontvangen.

U kunt de ontwerpfunctie voor actie-berichten gebruiken om bruikbare berichtkaarten te ontwerpen en te testen.

Belangrijk

Het universele botactiemodel wordt geïntroduceerd in het schema van adaptieve kaarten versie 1.4. Als u deze nieuwe mogelijkheden wilt gebruiken, moet de versie-eigenschap van uw adaptieve kaart worden ingesteld op 1.4 of hoger. Zie Action.Execute in de schemaverkenner voor adaptieve kaarten.

De bot implementeren en implementeren

De algemene stroom is bedoeld voor het verzenden van een uitvoerbaar bericht naar een gebruiker door de bot en vervolgens de actie van de gebruiker afhandelt.

  1. Wanneer de gebruiker in e-mail op de kaart reageert, verzendt Outlook een aanroepactiviteit naar de bot. De eigenschap van value de activiteit bevat een actieobject met type, verben data eigenschappen. De activiteit bevat bijvoorbeeld de volgende informatie, waarbij het werkwoord en de gegevens overeenkomen met informatie op de kaart die de bot in eerste instantie heeft verzonden.

    "type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}

    Zie Action.Execute in de schemaverkenner voor adaptieve kaarten voor het volledige objectschema.

  2. De bot verwerkt de binnenkomende aanroepactiviteit en retourneert een resultaat dat een nieuwe adaptieve kaart bevat die de plaats van de oorspronkelijke adaptieve kaart zal innemen. Het aanroepende antwoord kan er als volgt uitzien:

    {
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}

Toegang aanvragen

  1. Open uw botresource in Azure Portal.
  2. Open het deelvenster Kanalen .
  3. Selecteer het Outlook-kanaal .
  4. Op de pagina Outlook configureren selecteert u zich hier.
  5. Vul het registratieformulier in om toegang aan te vragen. Zie Uw service registreren bij het dashboard voor e-mailontwikkelaars voor meer informatie.

Volgende stappen