Centrum wsparcia Workiva

Łącznik poczty e-mail umożliwia dołączenie polecenia Wyślij wiadomość e-mail w celu wysłania wiadomości e-mail jako części łańcucha. Ta komenda używa protokołu SMTP (Simple Mail Transfer Protocol) do wysyłania wiadomości e-mail. Uwierzytelnianie można przeprowadzić przy użyciu uwierzytelniania podstawowego lub uwierzytelniania OAuth2. Wiadomość e-mail może zawierać dodatkowy kontekst z wcześniejszych poleceń w łańcuchu, co umożliwi lepszą automatyzację.

Wymagania wstępne SMTP

Aby móc korzystać z łącznika poczty e-mail, Twoja organizacja potrzebuje informacji o serwerze SMTP swojego dostawcy poczty e-mail, np. Gmail® lub Microsoft® Office 365®.

Aby skonfigurować łącznik, będziesz potrzebować:

• Nazwa hosta serwera SMTP
• Port, którego serwer SMTP używa do wysyłania wiadomości e-mail
• Domena HELO, jeśli jest wymagana przez serwer SMTP
• Jeżeli serwer SMTP wymaga uwierzytelnienia, nazwa użytkownika i hasło użytkownika integracji, którego łącznik powinien uwierzytelnić jako

Wymagania wstępne OAuth2

Aby można było użyć zabezpieczeń OAuth2 dla tego łącznika, muszą być obecne i zaimplementowane następujące elementy.

Elementy Azure

Musisz mieć:

• Zarówno konto Microsoft Azure, jak i klucz konta Azure.
• Skonfiguruj przepływ kodu autoryzacji w usłudze Azure.
• Skonfigurowano usługę Exchange Online na platformie Azure.

• Podczas konfigurowania przepływu kodu autoryzacji skonfiguruj prawidłowy identyfikator URI przekierowania w usłudze Azure.

  Środowisko	Przekieruj URI
  Produkcja APAC	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  Produkcja UE	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  Produkcja amerykańska	https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback

Instrukcje dotyczące uzyskiwania i wdrażania tych wymagań wstępnych można znaleźć w dokumentacji platformy Microsoft Azure.

Elementy Workiva

• Musisz włączyć łącznik poczty e-mail Workiva (wymaga to administratora zabezpieczeń organizacji).

Skonfiguruj łącznik e-mail

Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator bezpieczeństwa organizacji musi włączyć go w konfiguracji.

1. W Chain Builderkliknij Connectionscompare_arrows, a następnie Create w prawym górnym rogu.
2. W obszarze Połączenie łącznikawybierz E-mail i domyślny CloudRunner.
   
3. Wprowadź unikalną Nazwę i Opis, aby ułatwić identyfikację połączenia.

4. W polu Właściwościwprowadź szczegóły połączenia:

   

   Właściwość	Szczegóły
   Nazwa hosta	Wprowadź nazwę hosta serwera SMTP: W przypadku Gmailajest to zazwyczaj smtp.gmail.com W przypadku Microsoft 365jest to zazwyczaj smtp.office365.com W przypadku Mailgunjest to zazwyczaj smtp.mailgun.org
   Port	Wprowadź port, na którym działa serwer. Domyślny port SMTP to zazwyczaj587, ale może to być również25.
   Włączony TLS	Jeśli używasz bezpiecznego serwera SMTP wymagającego szyfrowanej komunikacji za pośrednictwem warstwy transportowej, ustaw opcję Zabezpieczenia/Warstwa bezpiecznych gniazd (TLS/SSL) na Włączone.
   Domena HELO	Jeżeli wymaga tego serwer SMTP, wprowadź domenę HELO, która umożliwi pomyślne nawiązanie połączenia.

   Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu szyfrowania Advanced Encryption Standard (AES)-256.

5. W obszarze Uwierzytelnianiewybierz typ uwierzytelniania, którego chcesz użyć, i wprowadź informacje potrzebne do uwierzytelniania wywołań API. Zakres wymaganych informacji będzie zależał od wybranego typu uwierzytelnienia.

   Do uwierzytelniania podstawowego

   

   Właściwość	Szczegóły
   Nazwa użytkownika	Jeżeli serwer SMTP używa uwierzytelniania podstawowego, wprowadź nazwę użytkownika integracyjnego łącznika.
   Hasło	Jeśli serwer SMTP wymaga podstawowego uwierzytelnienia, wprowadź hasło powiązane z nazwą użytkownika.

    

   Dla poczty e-mail Microsoft Office 365 OAuth2

   

   Właściwość	Szczegóły
   Nazwa użytkownika	To jest nazwa użytkownika umożliwiająca dostęp do serwera SMTP.
   ID najemcy	To jest ciąg identyfikacyjny Twojej dzierżawy Microsoft.
   Identyfikator klienta	To jest identyfikator klienta dla klucza, którego ma używać API.
   Tajemnica klienta	To jest tajny klucz klienta, którego ma używać API.

6. Kliknij Połącz.
7. Wybierz środowiska, w których chcesz używać połączenia i kliknij Zapisz.
8. Aby przetestować połączenie, utwórz i uruchom łańcuch za pomocą polecenia Wyślij wiadomość e-mail łącznika, aby wysłać wiadomość e-mail na swój adres e-mail i sprawdź, czy zwraca ona prawidłowy wynik.

Rozwiązywanie problemów

Jeśli łącznik nie wyśle ​​wiadomości e-mail:

• Sprawdź, czy nazwa hosta i port serwera SMTP Twojego dostawcy poczty e-mail są prawidłowe.
• Sprawdź, czy typ domeny serwera SMTP jest poprawny (TLS lub HELO).
• Jeśli używasz uwierzytelniania podstawowego, sprawdź, czy wartości nazwy użytkownika i hasła są prawidłowe.
• Jeśli używasz uwierzytelniania OAuth2, sprawdź, czy:
  • wartości ClientID i Client Secret są poprawne.
  • Adres URI przekierowania jest poprawny w usłudze Azure podczas generowania wartości Identyfikatora klienta i Klucza tajnego klienta.
• Sprawdź, czy adresy e-mail odbiorców wprowadzone w polach Do, DWi UDW [] polecenia Wyślij wiadomość e-mail są poprawne.