Come utilizzare App Connect con Microsoft Teams

Versioni di prodotto e API supportate

Per conoscere le versioni del prodotto e delle API supportate da questo connettore, consultare i requisiti di sistema dettagliati alla pagina di supporto IBM.

Connessione a Microsoft Teams

• Se non hai un account su Microsoft Teams, puoi registrarti gratuitamente su Microsoft Teams.

Per collegare App Connect a un account Microsoft Teams, consultare la sezione "Collegamento a Microsoft Teams da App Connect ".

Considerazioni generali sull'utilizzo di Microsoft Teams in App Connect

• (Considerazione generale) È possibile vedere gli elenchi degli eventi e delle azioni di attivazione disponibili nella pagina Applicazioni e API di App Connect Designer.

  Per alcune applicazioni, gli eventi e le azioni dipendono dall'ambiente e dal fatto che il connettore supporti eventi configurabili e la scoperta dinamica delle azioni. Se l'applicazione supporta eventi configurabili, viene visualizzato un collegamento Mostra altri eventi configurabili sotto l'elenco degli eventi. Se l'applicazione supporta il rilevamento dinamico delle azioni, viene visualizzato un link Mostra di più sotto l'elenco delle azioni.

• (Considerazione generale) Se si utilizzano più account per un'applicazione, l'insieme dei campi visualizzati quando si seleziona un'azione per quell'applicazione può variare per i diversi account. Nell'editor di flusso, alcune applicazioni forniscono sempre un insieme curato di campi statici per un'azione. Altre applicazioni utilizzano la scoperta dinamica per recuperare l'insieme dei campi configurati nell'istanza a cui si è connessi. Ad esempio, se si dispone di due account per due istanze di un'applicazione, il primo account potrebbe utilizzare impostazioni pronte per l'uso immediato. Tuttavia, il secondo account potrebbe essere configurato con campi personalizzati aggiuntivi.
• Microsoft Azure Active Directory i gruppi vengono in genere creati nel centro di amministrazione Microsoft 365 o nel portale Microsoft Azure. Se si dispone delle autorizzazioni necessarie, è possibile utilizzare l'azione "Crea gruppo" in App Connect per creare gruppi Microsoft 365 o gruppi di sicurezza.
• Se utilizzi un account utente non amministratore per collegarti a Microsoft Teams, puoi utilizzare App Connect per aggiornare o eliminare gruppi solo se sei il proprietario di quel gruppo.
• Quando si utilizza l'azione Crea messaggio chat o Recupera messaggi chat per creare o recuperare messaggi chat in App Connect, è necessario prima selezionare una chat esistente dall'elenco.
  
  • Per le chat private con un altro utente il cui nome è indicato nel campo "A" in Microsoft Teams, l'ID della chat viene visualizzato nell'elenco delle chat di 19:50144721-4f5b-4765-9b65-fd554a36c65c_8372f761-5d10-4888-ef47-5be0b7315e72@unq.gbl.spacesApp Connect nel formato.
  • Nelle chat di gruppo (in cui l'oggetto della conversazione è riportato nel campo "Nome gruppo " e nel campo "A" di Microsoft Teams sono presenti più nomi utente), il valore "Nome gruppo " (oggetto) viene visualizzato nell'elenco delle chat di App Connect, rendendo la chat facilmente identificabile.

  Se prevedi di utilizzare spesso le azioni "Crea messaggio di chat" o "Recupera messaggi di chat ", ti consigliamo di creare le tue chat specificando un valore per il "Nome del gruppo " (oggetto) in Microsoft Teams.

• Quando si utilizza l'azione Crea risposta al messaggio o Recupera risposte al messaggio per creare o recuperare risposte ai messaggi in App Connect, è necessario prima selezionare un team, un canale e un messaggio per la risposta. Nell'elenco dei messaggi, i messaggi creati con un oggetto mostrano il valore dell'oggetto, mentre quelli senza oggetto mostrano un ID generato da Microsoft Teams.
  

  Se necessario, puoi verificare quale ID è assegnato a un messaggio su Microsoft Teams aprendo il menu "Altre opzioni " (... ) relativo al messaggio e cliccando poi su "Copia link ". L'ID del messaggio è incluso nel link; ad esempio:

  https://teams.microsoft.com/l/message/19:a954b78415a547a7438c354c54b40f30@thread.tacv2/1595593605014?tenantId=0184ab77-1234-4ac0-5678-bf7eec6de925&groupId=e1c2515c-4512-471e-a772-60ce5ba78921&parentMessageId=1595593605014&teamName=FDteam&channelName=General&createdTime=1595593605014

  

  Se prevedi di utilizzare spesso le azioni "Crea risposta al messaggio" o "Recupera risposte al messaggio ", ti consigliamo di creare risposte ai messaggi con un oggetto in Microsoft Teams.

  
• Quando si utilizza l'azione Crea messaggio di chat, Crea messaggio o Crea messaggio di risposta per creare un messaggio o una risposta in App Connect, è possibile aggiungere un allegato al messaggio specificando un tipo di contenuto e il contenuto associato. Attualmente sono supportati solo gli allegati di schede ricche. Si può usare il campo Tipo di contenuto per selezionare un formato di scheda e poi usare il campo Contenuto per specificare un oggetto scheda ricco che definisce il formato JSON della scheda. Gli allegati supportati sono i seguenti.

  Tipo di contenuto	Descrizione	Contenuto
  application/vnd.microsoft.card.adaptive	Una scheda adattiva che può contenere testo, voce, immagini, pulsanti e campi di input.	Specificare un oggetto AdaptiveCard.
  application/vnd.microsoft.card.hero	Una scheda Hero che può contenere un'immagine di grandi dimensioni, uno o più pulsanti e del testo.	Specificare un oggetto HeroCard.
  application/vnd.microsoft.card.thumbnail	Una scheda Miniatura che può contenere un'immagine in miniatura, uno o più pulsanti e del testo.	Specificare un oggetto ThumbnailCard.
  application/vnd.microsoft.com.card.receipt	Una carta di ricezione che fornisce una ricevuta.	Specificare un oggetto ReceiptCard. Limitazione: Questa carta attualmente fornisce un'uscita parziale.
  application/vnd.microsoft.com.card.signin	Una scheda di accesso che richiede all'utente di effettuare l'accesso.	Specificare un oggetto SignInCard.

  Per ulteriori informazioni su questi allegati alle schede, consultare il riferimento alle schede nella documentazione Microsoft.

  Gli esempi seguenti forniscono esempi di JSON per ciascun tipo di contenuto.

  Scheda adattiva:

  json
  
  {
      "type": "AdaptiveCard",
      "body": [
          {
              "type": "TextBlock",
              "size": "Medium",
              "weight": "Bolder",
              "text": "Profile Info"
          },
          {
              "type": "FactSet",
              "facts": [
                  {
                      "title": "Given name",
                      "value": "John"
                  },
                  {
                      "title": "Surname",
                      "value": "Doe"
                  },
                  {
                      "title": "Job title",
                      "value": "Software Dev"
                  },
                  {
                      "title": "Office location",
                      "value": "NYC"
                  },
                  {
                      "title": "Email",
                      "value": "john@doe.com"
                  }
              ]
          },
          {
              "type": "TextBlock",
              "text": "Business phones",
              "weight": "Bolder"
          },
          {
              "type": "TextBlock",
              "text": "{$data}",
              "$data": "{businessPhones}",
              "spacing": "None"
          }
      ],
      "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
      "version": "1.0"
  }

  Carta eroe:

  json
  {
       "title": "Seattle Center Monorail",
       "subtitle": "Seattle Center Monorail",
       "text": "The Seattle Center Monorail is an elevated train line between Seattle Center (near the Space Needle) and downtown Seattle. It was built for the 1962 World's Fair. Its original two trains, completed in 1961, are still in service.",
       "images": [
         {
           "url":"https://upload.wikimedia.org/wikipedia/commons/thumb/4/49/Seattle_monorail01_2008-02-25.jpg/1024px-Seattle_monorail01_2008-02-25.jpg"
         }
       ],
      "buttons": [
        {
           "type": "openUrl",
           "title": "Official website",
           "value": "https://www.seattlemonorail.com"
         },
        {
          "type": "openUrl",
          "title": "Wikipeda page",
          "value": "https://en.wikipedia.org/wiki/Seattle_Center_Monorail"
         }
       ]
     }

  Scheda in miniatura:

  json
  {
      "title": "Bender",
      "subtitle": "tale of a robot who dared to love",
      "text": "Bender Bending Rodríguez is a main character in the animated television series Futurama. He was created by series creators Matt Groening and David X. Cohen, and is voiced by John DiMaggio",
      "images": [
        {
          "url": "https://upload.wikimedia.org/wikipedia/en/a/a6/Bender_Rodriguez.png",
          "alt": "Bender Rodríguez"
        }
      ],
      "buttons": [
        {
          "type": "imBack",
          "title": "Thumbs Up",
          "image": "http://moopz.com/assets_c/2012/06/emoji-thumbs-up-150-thumb-autox125-140616.jpg",
          "value": "I like it"
        },
        {
          "type": "imBack",
          "title": "Thumbs Down",
          "image": "http://yourfaceisstupid.com/wp-content/uploads/2014/08/thumbs-down.png",
          "value": "I don't like it"
        },
        {
          "type": "openUrl",
          "title": "I feel lucky",
          "image": "http://thumb9.shutterstock.com/photos/thumb_large/683806/148441982.jpg",
          "value": "https://www.bing.com/images/search?q=bender&qpvt=bender&qpvt=bender&qpvt=bender&FORM=IGRE"
        }
      ],
      "tap": {
        "type": "imBack",
        "value": "Tapped it!"
      }
    }

  Scheda di ricezione (parziale):

  json
  {
          "title": "I'm a receipt card",
          "items": [
            {
              "title": "Sushi",
              "subtitle": "2 piece",
              "image": {
                "url": "https://mydeploy.azurewebsites.net/sushi.png"
              },
              "price": "16.25",
              "quantity": "1"
            },
            {
              "title": "Tenpura",
              "subtitle": "1 dish",
              "image": {
                "url": "https://mydeploy.azurewebsites.net/tenpura.jpg"
              },
              "price": "34.50",
              "quantity": "2"
            }
          ],
          "total": "275.25",
          "tax": "27.52",
          "buttons": [
            {
              "type": "openUrl",
              "title": "Go to my site",
              "value": "https://blogs.msdn.microsoft.com/tsmatsuz"
            }
          ]
        }

  Scheda di accesso:

  json
  {
      "buttons": [
          {
              "title": "Log In",
              "type": "openUrl",
              "value": "https://login.microsoftonline.com"
          }
      ],
      "text": "Sign in to our app"
  }

Considerazioni sulla connessione del post

Una volta effettuato l'accesso a Microsoft Teams, tieni presente quanto segue:

Prerequisiti per scaricare i contenuti della registrazione e della trascrizione delle chiamate

Per utilizzare le azioni "Scarica la registrazione della chiamata" e "Scarica la trascrizione della chiamata", è necessario pianificare la riunione come evento nel calendario di Microsoft Teams. Per pianificare la riunione come evento nel calendario di Microsoft Teams, nell'azione "Crea evento " devi impostare " È una riunione online " su True.

Eventi e azioni

Microsoft Teams eventi

Questi eventi riguardano le modifiche dell'applicazione che attivano un flusso per iniziare a completare le azioni del flusso.

Il flusso completa queste azioni su questa applicazione.