Centro de suporte da Workiva

O conector de e-mail permite que você inclua um comando Send Email para enviar e-mail como parte de uma cadeia. Esse comando usa o protocolo SMTP (Simple Mail Transfer Protocol) para enviar o e-mail. A autenticação pode ser feita usando a autenticação básica ou a autenticação OAuth2. O e-mail pode incluir contexto adicional de comandos anteriores na cadeia para permitir a automação aprimorada.

Pré-requisitos de SMTP

Para usar o conector de e-mail, sua organização precisa de detalhes sobre o servidor SMTP do provedor de e-mail, como o Gmail® ou o Microsoft® Office 365®.

Para configurar o conector, você precisará de:

• O nome do host do servidor SMTP
• A porta que o servidor SMTP usa para enviar e-mails
• O domínio HELO, se exigido pelo servidor SMTP
• Se o servidor SMTP exigir autenticação, o nome de usuário e a senha do usuário de integração que o conector deve autenticar como

Pré-requisitos do OAuth2

Antes que você possa usar a segurança OAuth2 para esse conector, os itens a seguir devem estar presentes e implementados.

Elementos do Azure

Você deve ter:

• Uma conta do Microsoft Azure e uma chave de conta do Azure.
• Configure um fluxo de código de autorização no Azure.
• Configurou o serviço Exchange Online no Azure.

• Configure o URI de redirecionamento correto no Azure ao configurar o fluxo do código de autorização.

  Ambiente	URI de redirecionamento
  Produtos APAC	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  Prod. da UE	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  Prod. dos EUA	https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback

Consulte a documentação do Microsoft Azure para obter instruções sobre como obter e implementar esses pré-requisitos.

Elementos da Workiva

• Você deve ter ativado o conector de e-mail da Workiva (isso requer um administrador de segurança da organização).

Configurar um conector de e-mail

Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um Administrador de Segurança da Organização deve habilitá-lo em Configuration.

1. Em Construtor de Cadeias, clique em Conexões compare_arrows e, em seguida, Criar no canto superior direito.
2. Em Connector Connection, selecione Email e o padrão CloudRunner.
   
3. Digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.

4. Em Properties, insira os detalhes da conexão:

   

   Propriedade	Detalhes
   Nome do host	Digite o nome do host do servidor SMTP: Para Gmail, normalmente é smtp.gmail.com Para Microsoft 365, normalmente é smtp.office365.com Para Mailgun, normalmente é smtp.mailgun.org
   Porto	Digite a porta em que o servidor é executado. A porta SMTP padrão normalmente é 587, mas também pode ser 25.
   TLS ativado	Se estiver usando um servidor SMTP seguro que exija comunicação criptografada via Transport Layer, defina Security/Secure Sockets Layer (TLS/SSL) como Enabled.
   Domínio HELO	Se exigido pelo servidor SMTP, digite o domínio HELO usado para garantir um handshake bem-sucedido.

   Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas usando a criptografia Advanced Encryption Standard (AES) 256.

5. Em Authentication, selecione o tipo de autenticação que você deseja usar e insira as informações necessárias para autenticar as chamadas de API. As informações necessárias dependerão do tipo de autenticação que você selecionar.

   Para autenticação básica

   

   Propriedade	Detalhes
   Nome do usuário	Se o servidor SMTP usar autenticação básica, digite o nome de usuário do usuário de integração do conector.
   Senha	Se o servidor SMTP exigir autenticação básica, digite a senha associada ao nome de usuário.

    

   Para o Microsoft Office 365 Email OAuth2

   

   Propriedade	Detalhes
   Nome de usuário	Este é o nome de usuário para acessar o servidor SMTP.
   ID do locatário	Esta é a string de ID do seu locatário da Microsoft.
   ID do cliente	Este é o ID do cliente para a chave que você deseja que a API use.
   Segredo do cliente	Esse é o segredo do cliente para a chave que você deseja que a API use.

6. Clicar em “Conectar”
7. Selecione os ambientes para usar a conexão e clique em Salvar.
8. Para testar a conexão, crie e execute uma cadeia com o comando Send Email do conector para enviar um e-mail para seu próprio endereço de e-mail e verifique se ele retorna uma saída válida.

Solução de problemas

Se o conector não conseguir enviar o e-mail:

• Verifique se o nome do host e a porta do servidor SMTP do seu provedor de e-mail estão corretos.
• Verifique se o tipo de domínio do servidor SMTP está correto (TLS ou HELO).
• Se você estiver usando a autenticação Basic, verifique se os valores de nome de usuário e senha estão corretos.
• Se estiver usando a autenticação OAuth2, verifique se:
  • os valores ClientID e Client Secret estão corretos.
  • o URI de redirecionamento está correto no Azure ao gerar esses valores de ID do cliente e segredo do cliente.
• Verifique se os endereços de e-mail do destinatário inseridos nas entradas Send Email do comando To, CC e BCC estão corretos.