Połączenie bota do kanału programu Outlook dla wiadomości z możliwością działania (wersja zapoznawcza)

Artykuł
10/24/2023

DOTYCZY: ZESTAW SDK w wersji 4

Komunikaty z możliwością działania umożliwiają użytkownikom wykonywanie szybkich akcji z poziomu programu Outlook. Po połączeniu bota z kanałem Wiadomości z możliwością działania programu Outlook bot może użyć kart adaptacyjnych do tworzenia komunikatów z możliwością działania, zwiększając zaangażowanie użytkowników.

Uwaga

Kanał programu Outlook dla wiadomości z możliwością działania jest w publicznej wersji zapoznawczej. Funkcje zawarte w wersji zapoznawczej mogą nie zostać ukończone i mogą ulec zmianie przed udostępnieniem ich w publicznej wersji. Są one udostępniane tylko do celów ewaluacyjnych i poszukiwawczych.

Ostrzeżenie

Jest to naruszenie kodeksu postępowania platformy Bot Framework w celu utworzenia "spambotów", w tym botów, które wysyłają niechciane lub niepożądane zbiorcze wiadomości e-mail.

Wymagania wstępne

Znajomość kart adaptacyjnych i modelu akcji uniwersalnych.
Znajomość komunikatów z możliwością działania w programach Outlook i Office 365 Groups.
Bot gotowy do obsługi kanału wdrożony na platformie Azure.
Dedykowany adres e-mail używany przez bota do wysyłania i odbierania wiadomości.

Uwaga

Nie używaj własnych osobistych kont e-mail dla botów, ponieważ każda wiadomość wysłana do tego konta e-mail zostanie przekazana botowi. Może to spowodować niewłaściwe wysłanie przez bota odpowiedzi do nadawcy. Z tego powodu boty powinny używać tylko dedykowanych kont e-mail usługi O365.
Jeśli używasz programu Microsoft Exchange Server, włącz automatyczne wykrywanie przed skonfigurowaniem kanału poczty e-mail.

Projektowanie komunikatów

Kanał programu Outlook dla wiadomości z możliwością działania wysyła i odbiera karty adaptacyjne za pośrednictwem poczty e-mail.

Aby zaprojektować i przetestować karty komunikatów z możliwością działania, można użyć Projektant komunikatów z możliwością działania.

Ważne

Uniwersalny model akcji bota jest wprowadzany w schemacie karty adaptacyjne w wersji 1.4. Aby korzystać z tych nowych możliwości, właściwość wersji karty adaptacyjnej powinna być ustawiona na 1.4 lub nowszą. Zobacz Action.Execute w Eksploratorze schematów kart adaptacyjnych.

Implementowanie i wdrażanie bota

Ogólny przepływ dotyczy bota w celu wysłania komunikatu z możliwością działania do użytkownika, a następnie obsługi akcji użytkownika.

Gdy użytkownik odpowie na kartę w wiadomości e-mail, program Outlook wysyła działanie wywołania do bota. Właściwość działania value zawiera obiekt akcji z właściwościami type, verbi data . Na przykład działanie zawiera następujące informacje, w których czasownik i dane odpowiadają informacjom na karcie, które bot wysłał początkowo.
```
"type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}
```
Zobacz Action.Execute w Eksploratorze schematów kart adaptacyjnych, aby uzyskać pełny schemat obiektu.
Bot obsługuje działanie wywołania przychodzącego i zwraca wynik zawierający nową kartę adaptacyjną, która będzie mieć miejsce oryginalnej karty adaptacyjnej. Odpowiedź wywołania może wyglądać następująco:
```
{
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}
```

Żądanie dostępu

Otwórz zasób bota w witrynie Azure Portal.
Otwórz okienko Kanały .
Wybierz kanał programu Outlook.
Na stronie Konfigurowanie programu Outlook wybierz pozycję Zarejestruj się tutaj.
Wypełnij formularz rejestracji, aby zażądać dostępu. Aby uzyskać więcej informacji, zobacz Rejestrowanie usługi przy użyciu pulpitu nawigacyjnego dewelopera wiadomości e-mail z możliwością działania.

Następne kroki

Dowiedz się więcej o wiadomościach z możliwością działania w programach Outlook i Grupach usługi Office 365.
Dowiedz się więcej o kartach adaptacyjnych dla deweloperów komunikatów z możliwością działania programu Outlook

Share via