Condividi tramite

Inviare messaggi di Microsoft Teams proattivi

Dopo aver pubblicato l'agente e reso l'agente disponibile agli utenti in Microsoft Teams, puoi avvisare gli utenti ("destinatari") in Microsoft Teams con messaggi proattivi. I messaggi proattivi utilizzano i flussi Power Automate per fornire il contenuto e sono utili in molti scenari, tra cui:

  • Informare un destinatario che la sua richiesta precedente è stata completata. Ad esempio, la richiesta di permesso dell'utente è stata approvata.
  • Fornire promemoria o aggiornamenti di notizie. Ad esempio, l'agente potrebbe inviare un messaggio di promemoria per completare la formazione online.

Importante

I messaggi proattivi possono essere configurati per gli agenti e i chatbot classici creati e personalizzati in Copilot Studio.

Un agente non può recapitare messaggi se il destinatario:

  • Non ha l'agente installato in Microsoft Teams.
  • Ha disinstallato l'agente.
  • Ha bloccato l'agente.
  • Non è autorizzato a chattare con l'agente, nel qual caso dovrai condividere l'agente con altri utenti.

Prerequisiti

Limitazioni note

  • Se l'agente viene disconnesso e ricollegato a Microsoft Teams, gli utenti non riceveranno messaggi proattivi finché non avranno reinstallato l'agente.
  • Tutti i messaggi proattivi da Copilot Studio sono soggetti ai limiti di Power Automate e alle limitazioni del connettore Microsoft Teams.
  • I messaggi proattivi non verranno registrati nelle trascrizioni delle conversazioni o Sessioni di analisi.
  • I messaggi proattivi devono trovarsi nello stesso ambiente del flusso Power Automate.
  • I messaggi proattivi possono essere pubblicati solo in una chat personale con l'agente.

Inviare un messaggio proattivo

  1. In Power Automate, apri il flusso a cui desideri inviare un messaggio proattivo.

  2. Aggiungi il connettore Microsoft Teams e seleziona l'azione Pubblica messaggio in una chat o un canale.

  3. Per Pubblica come, scegli Power Virtual Agents (Anteprima).

  4. Per Pubblica in, scegli Chatta con il bot.

  5. Per Bot, seleziona l'agente da cui desideri che il messaggio venga inviato.

  6. Per Destinatario, immetti il nome o l'indirizzo e-mail del destinatario. Puoi anche utilizzare il contenuto dinamico se le informazioni sul destinatario provengono da un passaggio precedente del flusso.

  7. Per Messaggio, immetti il messaggio che vuoi inviare.

    Pubblica l'azione del messaggio in Power Automate.

Quando il flusso viene eseguito, il destinatario riceverà il messaggio proattivo dall'agente in Microsoft Teams.

Inviare una scheda adattiva proattiva

Importante

Questa sezione spiega come inviare schede adattive proattive con i flussi Power Automate. Le schede adattive proattive consentono agli utenti di ricevere informazioni da una conversazione inattiva con un agente. Per scoprire come inviare Schede adattive in una conversazione attiva, vedi Visualizzare una scheda adattiva in Copilot Studio.

Oltre a inviare messaggi proattivi, puoi anche inviare schede adattive proattive.

Screenshot di una scheda adattiva.

Le schede adattive sono un formato di scambio di schede aperto che consente agli sviluppatori di scambiare il contenuto dell'interfaccia utente in modo comune e coerente. Puoi creare schede adattive manualmente in JSON oppure, se preferisci un'interfaccia drag-and-drop, puoi utilizzare la finestra di progettazione delle schede adattive.

Nota

Power Automate non supporta le schede adattive che utilizzano la funzionalità di creazione di modelli.

In questo esempio, invierai una scheda di riepilogo dell'ordine che l'utente potrà esaminare.

  1. In Power Automate, aggiungi l'azione del connettore Microsoft Teams Pubblica scheda adattiva in una chat o un canale nel passaggio in cui desideri inviare la scheda nel tuo flusso:

  2. Per Pubblica come, scegli Power Virtual Agents (Anteprima).

  3. Per Pubblica in, scegli Chatta con il bot.

  4. Per Bot, seleziona l'agente da cui desideri che il messaggio venga inviato.

  5. Per Destinatario, immetti il nome o l'indirizzo e-mail del destinatario. Puoi anche utilizzare il contenuto dinamico se le informazioni sul destinatario provengono da un passaggio precedente del flusso.

  6. Per Scheda adattiva, immetti il seguente modello JSON:

    {
    "type": "AdaptiveCard",
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.5",
    "body": [
        {
            "type": "TextBlock",
            "text": "Order summary",
            "wrap": true,
            "style": "heading"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Name",
                    "value": "John Doe"
                },
                {
                    "title": "Phone number",
                    "value": "(000) 000-0000"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "FactSet",
                    "facts": [
                        {
                            "title": "1x",
                            "value": "Steak"
                        },
                        {
                            "title": "2x",
                            "value": "Side Rice"
                        },
                        {
                            "title": "1x",
                            "value": "Soft Drink"
                        }
                    ],
                    "spacing": "Small"
                }
            ],
            "spacing": "Small"
        }
    ]
}

    Pubblica l'azione della scheda adattiva in Power Automate.

Quando il flusso viene eseguito, il destinatario riceverà la scheda adattiva dall'agente in Microsoft Teams.

Attendere la risposta dell'utente

Importante

Questa sezione spiega come inviare schede adattive proattive con i flussi Power Automate. Le schede adattive proattive consentono agli utenti di ricevere informazioni da una conversazione inattiva con un agente. Per scoprire come inviare Schede adattive in una conversazione attiva, vedi Visualizzare una scheda adattiva in Copilot Studio.

Le schede adattive supportano la raccolta di input dell'utente. In questi scenari, è consigliabile attendere la risposta dell'utente prima che il flusso continui.

Screenshot di una scheda adattiva che contiene azioni per l'utente.

Nota

Power Automate non supporta le schede adattive che utilizzano la funzionalità di creazione di modelli.

In questo esempio, invierai una scheda di conferma dell'ordine che consente all'utente di apportare modifiche prima dell'invio dell'ordine.

  1. In Power Automate, aggiungi l'azione del connettore Microsoft Teams Pubblica scheda adattiva e attendi una risposta nel passaggio in cui desideri inviare la scheda nel tuo flusso:

  2. Per Pubblica come, scegli Power Virtual Agents (Anteprima).

  3. Per Pubblica in, scegli Chatta con il bot.

  4. Per Messaggio, immetti il seguente modello JSON:

    Le proprietà nella sezione actions determinano le opzioni presentate all'utente.

    {
    "type": "AdaptiveCard",
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.0",
    "body": [
        {
            "type": "TextBlock",
            "text": "Order confirmation",
            "wrap": true,
            "style": "heading"
        },
        {
            "type": "FactSet",
            "facts": [
                {
                    "title": "Name",
                    "value": "John Doe"
                },
                {
                    "title": "Phone number",
                    "value": "(000) 000-0000"
                }
            ]
        },
        {
            "type": "Container",
            "items": [
                {
                    "type": "FactSet",
                    "facts": [
                        {
                            "title": "1x",
                            "value": "Steak"
                        },
                        {
                            "title": "2x",
                            "value": "Side Rice"
                        },
                        {
                            "title": "1x",
                            "value": "Soft Drink"
                        }
                    ],
                    "spacing": "Small"
                }
            ],
            "spacing": "Small"
        }
    ],
    "actions": [
        {
            "type": "Action.Submit",
            "title": "Submit Order"
        },
        {
            "type": "Action.Submit",
            "title": "Edit Order"
        }
    ]
}

  5. Per Messaggio di aggiornamento, immetti il messaggio di aggiornamento che il destinatario vedrà dopo aver fornito la sua risposta.

  6. Per Destinatario, immetti il nome o l'indirizzo e-mail del destinatario. Puoi anche utilizzare il contenuto dinamico se le informazioni sul destinatario provengono da un passaggio precedente del flusso.

  7. Per Bot, seleziona l'agente da cui desideri che la scheda venga inviata.

    Azione Pubblica scheda adattiva e attendi una risposta in Power Automate.

Quando il flusso viene eseguito, il destinatario riceverà la scheda adattiva dall'agente in Microsoft Teams a cui può quindi fornire una risposta.

Per utilizzare la risposta del destinatario, seleziona submitActionId dal menu a comparsa del contenuto dinamico. Il valore di questa variabile sarà il title dell'azione scelta dall'utente.

Inviare messaggi proattivi a più destinatari

In alcuni scenari, potresti voler inviare lo stesso messaggio proattivo a più destinatari.

Questa sezione contiene esempi per l'invio di messaggi a più destinatari.

Importante

I prerequisiti dettagliati in questo argomento si applicano a ciascun destinatario.

Ad esempio puoi inviare lo stesso messaggio a 10 destinatari in un'azione. Se tre dei 10 destinatari non hanno installato l'agente, quei tre destinatari non riceveranno il messaggio.

Inviare a membri del team

In questo esempio, l'agente invierà un promemoria ai membri di un team per completare la loro formazione online.

  1. Aggiungi il connettore Microsoft Teams e seleziona l'azione Recupera un team nel tuo flusso Power Automate.

  2. Per Team, scegli il team con i membri a cui vuoi inviare il messaggio.

  3. Aggiungi il connettore Gruppi di Office 365 e seleziona l'azione Elenca membri del gruppo.

  4. Seleziona Valore personalizzato nel campo ID gruppo.

  5. Seleziona ID team dal contenuto dinamico dell'azione Recupera un team.

  6. Aggiungi il connettore Microsoft Teams e seleziona l'azione Pubblica messaggio in una chat o un canale.

  7. Per Pubblica come, scegli Power Virtual Agents (Anteprima).

  8. Per Pubblica in, scegli Chatta con il bot.

  9. Per Bot, seleziona l'agente da cui desideri inviare il messaggio.

  10. Per Destinatario seleziona il contenuto dinamico Nome dell'entità utente dall'azione Elenca membri del gruppo.

    Invia a membri del team di esempio.

  11. Per Messaggio, immetti il messaggio che vuoi inviare.

Quando il flusso viene eseguito, ogni utente del team riceverà il messaggio proattivo in una chat privata con l'agente.

Inviare a un gruppo di sicurezza

In questo esempio, l'agente invierà un promemoria a un gruppo di sicurezza per completare la loro formazione online.

  1. Aggiungi il connettore Microsoft Entra ID e seleziona l'azione Recupera membri del gruppo nel tuo flusso Power Automate.

  2. Per ID gruppo, immetti il GUID del gruppo di sicurezza.

  3. Aggiungi il connettore Microsoft Teams e seleziona l'azione Pubblica messaggio in una chat o un canale.

  4. Per Pubblica come, scegli Power Virtual Agents (Anteprima).

  5. Per Pubblica in, scegli Chatta con il bot.

  6. Per Bot, seleziona l'agente da cui desideri inviare il messaggio.

  7. Per Destinatario seleziona il contenuto dinamico Nome dell'entità utente del membro del gruppo dall'azione Recupera membri del gruppo.

  8. Per Messaggio, immetti il messaggio che vuoi inviare.

    Opzione Invia a un gruppo di sicurezza.

Quando il flusso viene eseguito, ogni utente del gruppo di sicurezza riceverà il messaggio proattivo in una chat privata con l'agente.

Inviare un messaggio proattivo a più destinatari in parallelo

Normalmente quando invii un messaggio proattivo a più destinatari, l'agente invierà un messaggio dopo l'altro. Tuttavia, in alcune situazioni, potrebbe essere preferibile inviare il messaggio a più destinatari contemporaneamente.

Avviso

Tutti i messaggi proattivi da Copilot Studio sono soggetti ai limiti di Power Automate e alle limitazioni del connettore Microsoft Teams.

Se stai inviando messaggi a un grande gruppo di destinatari, vedrai degli errori se raggiungi il limite di throttling. È possibile ridurre il grado di parallelismo o ridurre il numero di destinatari nel gruppo.

  1. Nell'azione Applica a ognuno, seleziona i tre punti orizzontali (. . .) poi Impostazioni.

    Impostazioni nel menu Altre opzioni.

  2. Attiva Controllo della concorrenza e imposta il grado di parallelismo.

    Controllo di scorrimento per impostare il livello o la concorrenza.

Configurare le opzioni avanzate per i messaggi proattivi

Copilot Studio ti consente di controllare il comportamento dei dettagli sull'agente in Mostra opzioni avanzate nel connettore Microsoft Teams.

Riquadro delle opzioni espanso nel connettore.

Etichettare il messaggio inviato come notifica

Etichetta come notifica controlla se il messaggio o la scheda avrà il testo Notifica tramite davanti al nome dell'agente. L'etichettatura della risposta dell'agente consente al destinatario di identificare la risposta dell'agente alla richiesta.

L'impostazione mostra Notifica tramite nome dell'agente.

Quando il destinatario è attualmente in una chat attiva con l'agente

A volte l'agente potrebbe inviare un messaggio o una scheda proattiva quando il destinatario è in una conversazione attiva con l'agente.

È consigliabile posticipare l'invio del messaggio proattivo fino a quando non ha terminato la conversazione per non interrompere il flusso della conversazione.

La casella Se la chat è attiva consente di controllare il comportamento:

  • Invia: l'agente invierà il messaggio proattivo o la scheda normalmente.

  • Non inviare e completa: l'agente non invia il messaggio proattivo quando il destinatario è in una conversazione attiva. Viene restituito il codice di stato 300.

  • Non inviare e non completare: l'agente non invia il messaggio proattivo quando il destinatario è in una conversazione attiva. L'esecuzione del flusso verrà contrassegnata come non riuscita.

Quando il destinatario non ha installato l'agente

L'agente può inviare messaggi o schede solo ai destinatari che hanno installato l'agente in Microsoft Teams. I destinatari potrebbero non voler installare l'agente o averlo disinstallato.

Per i messaggi o le schede di importanza inferiore, è possibile impostare l'esecuzione del flusso in modo che venga contrassegnata come riuscita anche quando il destinatario non ha installato l'agente.

La casella Se il bot non è installato consente di controllare il comportamento:

  • Non riuscito: l'esecuzione del flusso verrà contrassegnata come un errore quando il destinatario non ha installato l'agente in Microsoft Teams.

  • Completato con codice di stato: l'esecuzione del flusso verrà contrassegnata come riuscita anche se il destinatario non può ricevere il messaggio o la scheda perché non ha installato l'agente. Viene restituito il codice di stato 100.

Definizione del codice di stato

Puoi utilizzare il codice di stato restituito per definire diversi comportamenti di follow-up nel flusso. Ad esempio, è possibile specificare che il flusso debba riprovare per un periodo di tempo o registrare un record sull'errore.

Codice di stato Completato (booleano) Descrzione
200 Vero Il messaggio è stato consegnato.
100 False Impossibile recapitare il messaggio perché il destinatario non ha installato l'agente.
300 False Impossibile recapitare il messaggio perché il destinatario è in una conversazione attiva con l'agente.