Connessione un bot al canale outlook per i messaggi interattivi (anteprima)

  • Articolo

SI APPLICA A: SDK v4

I messaggi interattivi consentono agli utenti di eseguire azioni rapide da Outlook. Quando si connette un bot al canale Messaggi interattivi di Outlook, il bot può usare schede adattive per creare messaggi interattivi, migliorando l'engagement degli utenti.

Nota

Il canale outlook per i messaggi interattivi è disponibile in anteprima pubblica. Le funzionalità incluse in anteprima potrebbero non essere complete e potrebbero subire modifiche prima di diventare disponibili nella versione pubblica. Vengono forniti solo a scopo di valutazione ed esplorazione.

Avviso

È una violazione del codice di comportamento di Bot Framework per creare "spambot", inclusi i bot che inviano messaggi di posta elettronica in blocco indesiderati o non richiesti.

Prerequisiti

  • Conoscenza delle schede adattive e del modello di azione universale.
  • Familiarità con i messaggi interattivi nei gruppi di Outlook e Office 365.
  • Un bot pronto per il canale distribuito in Azure.
  • Un indirizzo di posta elettronica dedicato che il bot userà per inviare e ricevere messaggi.

Nota

  • Non usare gli account di posta elettronica personali per i bot, perché ogni messaggio inviato a tale account di posta elettronica verrà inoltrato al bot. Ciò può implicare che il bot invii erroneamente una risposta a un mittente. Per questo motivo, i bot devono usare solo account di posta elettronica di Office 365 dedicati.
  • Se si usa Microsoft Exchange Server, abilitare l'individuazione automatica prima di configurare il canale di posta elettronica.

Progettare i messaggi

Il canale outlook per i messaggi interattivi invia e riceve schede adattive tramite posta elettronica.

È possibile usare Progettazione messaggi interattivi per progettare e testare le schede messaggi interattivi.

Importante

Il modello di azione universal Bot è stato introdotto nello schema delle schede adattive versione 1.4. Per usare queste nuove funzionalità, la proprietà version della scheda adattiva deve essere impostata su 1.4 o versione successiva. Vedere Action.Execute in Esplora schemi schede adattive.

Implementare e distribuire il bot

Il flusso generale è destinato al bot per inviare un messaggio interattivo a un utente e quindi gestire l'azione dell'utente.

  1. Quando l'utente risponde alla scheda di posta elettronica, Outlook invia un'attività invoke al bot. La proprietà dell'attività value contiene un oggetto azione con typeproprietà , verbe data . Ad esempio, l'attività include le informazioni seguenti, in cui il verbo e i dati corrispondono alle informazioni sulla scheda che il bot ha inviato inizialmente.

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

    Vedere Action.Execute in Adaptive Cards Schema Explorer (Esplora schemi schede adattive) per lo schema completo dell'oggetto.

  2. Il bot gestisce l'attività invoke in ingresso e restituisce un risultato che include una nuova scheda adattiva che avrà il posto della scheda adattiva originale. La risposta invoke potrebbe essere simile alla seguente:

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

Richiedere l'accesso

  1. Aprire la risorsa bot nel portale di Azure.
  2. Aprire il riquadro Canali .
  3. Selezionare il canale outlook .
  4. Nella pagina Configura Outlook selezionare Registra qui.
  5. Compilare il modulo di registrazione per richiedere l'accesso. Per altre informazioni, vedere Registrare il servizio con il dashboard per sviluppatori di posta elettronica interattivi.

Passaggi successivi