Dela via

Ansluta en robot till e-post

GÄLLER FÖR: SDK v4

Du kan konfigurera roboten så att den kommunicerar med användare via Microsoft 365-e-post. När du konfigurerar roboten för åtkomst till ett e-postkonto får den ett meddelande när ett nytt e-postmeddelande kommer. Roboten kan sedan använda e-post för att svara. Som svar på en användares e-postmeddelande kan roboten till exempel skicka ett e-postsvar med meddelandet "Hej! Tack för din beställning! Vi börjar bearbeta den omedelbart."

E-postkanalen fungerar för närvarande endast med Office 365. Andra e-posttjänster stöds inte för närvarande.

Varning

  • Av säkerhetsskäl inaktiverar Exchange Online grundläggande autentisering den 1 oktober 2022. E-postkanalen stöder nu den nya moderna Exchange Online-autentiseringsmodellen . Robotar som använder den grundläggande autentiseringsmodellen får fel efter ändringen oktober 2022. eller tidigare om klientadministratören inaktiverar grundläggande autentisering före det datumet. Mer information finns i Grundläggande autentisering och Exchange Online – september 2021 Uppdatering.
  • Det är ett brott mot Bot Frameworks uppförandekod att skapa "spambots", inklusive robotar som skickar oönskade eller obeställda massmejl.

Förutsättningar

Anmärkning

Du bör inte använda dina egna personliga e-postkonton för robotar eftersom varje meddelande som skickas till e-postkontot vidarebefordras till roboten. Detta kan leda till att roboten felaktigt skickar ett svar till en avsändare. Därför bör robotar endast använda dedikerade M365-e-postkonton.

Konfigurera e-post för att använda modern autentisering

  1. Öppna Azure-portalen.

  2. Öppna Azure Bot-resurspanelen för din bot.

  3. I den vänstra rutan väljer du Kanaler.

  4. Välj E-post för att öppna bladet Konfigurera e-post .

    Konfigurera e-postinställningar

    1. Ange Autentiseringstyp till Modern autentisering (OAUTH).

    2. I E-postadress anger du det dedikerade Office 365-e-postkontot för roboten.

    3. Välj Auktorisera.

      1. När du uppmanas att göra det loggar du in på e-postkontot och beviljar läs-/skrivbehörighet och skickar behörigheter till roboten.

      2. När det lyckas öppnas en sida med en valideringskod. Kopiera verifieringskoden.

        Interaktion med valideringskod

    4. I Autentiseringskod anger du verifieringskoden som du precis kopierade.

    5. Välj Använd för att slutföra e-postkonfigurationen.

Konfigurera e-post för att använda grundläggande autentisering

Anmärkning

  • Federerad autentisering med någon leverantör som ersätter Microsoft Entra-ID stöds inte.
  • Av säkerhetsskäl inaktiveras användningen av grundläggande autentisering i Exchange Online den 1 oktober 2022. Du bör migrera alla dina robotar för att använda modern autentisering före tidsgränsen.
  • Om du använder Microsoft Exchange Server kontrollerar du att du har aktiverat Automatisk upptäckt först innan du konfigurerar e-post för att använda grundläggande autentisering.
  • Om du använder ett Office 365-konto med MFA aktiverat på det ska du först inaktivera MFA för det angivna kontot. sedan kan du konfigurera kontot för e-postkanalen. Annars misslyckas anslutningen.

  1. Öppna Azure-portalen.

  2. Öppna Azure Bot-resursbladet för din bot.

  3. I den vänstra rutan väljer du Kanaler (förhandsversion) för att öppna bladet Kanaler .

  4. Välj E-post för att öppna bladet Konfigurera e-post .

    Ange autentiseringsuppgifter för e-post

    1. Ange Autentiseringstyp till Basautentisering (inaktiveras från och med oktober 2022).
    2. I E-postadress anger du det dedikerade Office 365-e-postkontot för roboten.
    3. I Lösenord anger du lösenordet för e-postkontot.
    4. Välj Använd för att slutföra e-postkonfigurationen.

Anpassa e-postmeddelanden

E-postkanalen har stöd för att skicka anpassade värden för att skapa mer avancerade, anpassade e-postmeddelanden med hjälp av aktivitetsegenskapen channelData . Kodfragmentet nedan visar ett exempel på channelData för ett inkommande anpassat e-postmeddelande, från roboten till användaren.

{
    "type": "ActivityTypes.Message",
    "locale": "en-Us",
    "channelID": "email",
    "fromName": { "id": "mybot@mydomain.com", "name": "My bot"},
    "recipientName": { "id": "joe@otherdomain.com", "name": "Joe Doe"},
    "conversation": { "id": "123123123123", "topic": "awesome chat" },
    "channelData":
    {
        "htmlBody": "<html><body style = \"font-family: Calibri; font-size: 11pt;\" >This is more than awesome.</body></html>",
        "importance": "high",
        "ccRecipients": "Yasemin@adatum.com;Temel@adventure-works.com",
    }
}

Mer information om aktivitetsegenskapen channelData finns i Skapa ett anpassat e-postmeddelande.

Felsökning

För fel som kan inträffa vid bearbetning av medgivande till en applikation, se Förstå Microsoft Entra ID-upplevelser för programmedgivande och Oväntat fel när du ger medgivande till en applikation.

Om din robot inte returnerar en 200 OK HTTP-statuskod inom 15 sekunder som svar på ett inkommande e-postmeddelande försöker e-postkanalen skicka meddelandet igen och din robot kan få samma e-postaktivitet några gånger. Mer information finns i avsnittet HTTP-information i Så här fungerar robotar och artikeln felsöka timeout-fel.

Ytterligare resurser

  • Last updated on