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.
- Em Construtor de Cadeias, clique em Conexões e, em seguida, Criar no canto superior direito.
- Em Connector Connection, selecione Email e o padrão CloudRunner.
- Digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
-
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 ser25.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.
- Para Gmail, normalmente é
-
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. - Clicar em “Conectar”
- Selecione os ambientes para usar a conexão e clique em Salvar.
- 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.