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:

• Tanto uma conta do Microsoft Azure quanto uma chave de conta do Azure.
• Configure um fluxo de código de autorização do no Azure.
• Configurei o serviço Exchange Online “ ” no Azure.

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

  Ambiente	URI de redirecionamento
  Produtos da APAC (região da Ásia-Pacífico)	https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  Produto da CA (Canadá)	https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  Produto da UE (EMEA)	https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  Produção dos EUA (EUA, América Central, América do Sul)	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 do 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 disponibilizar o conector para uso nas cadeias da sua organização, um administrador de segurança da organização deve habilitá-lo a partir de Configuração.

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 “ ” (Propriedades), insira os detalhes da conexão:

   

   Propriedade	Detalhes
   Nome do host	Digite o nome do host do servidor SMTP: Para no Gmail, isso geralmente é smtp.gmail.com Para Microsoft 365, isso geralmente é smtp.office365.com Para Mailgun, isso geralmente é 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 por meio da Camada de Transporte, configure a opção Segurança/Camada de Soquetes Seguros (TLS/SSL) para “ ” ativado.
   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 criptografadas automaticamente e armazenadas utilizando 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 Save.
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 do ClientID do ( ) e do segredo do cliente do ( ) 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.