Configuração e uso do serviço de envio de e-mails
Serviço de envio
O serviço de e-mails do CRM One deve ter sua instalação solicitada ao time de suporte da DWU, ou ser previamente instalado na fase de implementação do sistema (Portal web ou Api Mobile).
Será instalado no servidor um novo serviço, onde o padrão de nome para o serviço será “CRMOneEmail”.
O serviço deverá ser configurado para inicialização conforme o interesse da empresa, podendo ser manual ou automático.
No servidor poderá ser acessada a configuração através da execução do “Services.MSC” no Windows do seu servidor.
Configuração do SMTP
Para configurar o SMTP, o administrador deverá acessar o SAP Business One e iniciar o add-on CRM One.
Em:
> Módulos > CRM One > Configurações > Configurações do motor de e-mail > Configuração SMTP
deverá ser configurado o e-mail que será utilizado para os envios.
Atenção aos seguintes pontos:
- Uma vez configurado o serviço de envio de e-mail, se não for configurado corretamente os dados de SMTP o serviço apresentará falha ao iniciar.
- Todas as bases de dados que estão configuradas para utilização no serviço de e-mails, deverão estar com a configuração de SMTP efetuada.
Tabela de armazenamento de e-mails
O Motor de envio de e-mails do CRM One, é um serviço que fica em execução no Windows e faz a leitura de uma tabela criada pelo CRM One no banco de dados do SAP Business One (tabela de usuário).
Esta tabela que armazena os e-mails que precisam ser enviados é chamada [@DWU_MAIL_SER] e é através dela que o motor faz o controle e envio dos e-mails.
Para popular a tabela, você poderá:
- Usar o recurso de transaction do SAP e fazer através de um INSERT o registro dos e-mails que devem ser enviados na tabela [@DWU_MAIL_SER].
- É possível criar jobs no SQL/HANA para envio de relatórios por exemplo, em horários pré determinados.
- Desenvolver programas que realizam procedimentos e processamentos para chegar ao e-mail que deverá ser enviados e inserir estes e-mails na tabela [@DWU_MAIL_SER]
Detalhes das colunas da tabela [@DWU_MAIL_SER]
[Code]* – Número sequencial
[Name]* – Número sequencial
[U_ObjType] – Opcional para indicar o ID do tipo de documento que gerou o e-mail.
[U_ObjEntry] – Opcional para indicar o ID do documento que gerou o e-mail.
[U_Assunto]* – Assunto do e-mail
[U_Destinatario]* – E-mails de destino principal. Para mais de um e-mail, usar o separador ; (ponto e vírgula)
[U_Copia] – E-mails em cópia. Para mais de um e-mail, usar o separador ; (ponto e vírgula)
[U_CopiaOculta] – E-mails em cópia oculta. Para mais de um e-mail, usar o separador ; (ponto e vírgula)
[U_CaminhoAnexo] – Para enviar um anexo, indique o local do arquivo. O mesmo será usado como anexo no e-mail. Respeitar o tamanho de arquivo do e-mail enviador da empresa.
[U_TextoHTML]* – Corpo do e-mail (pode ser em HTML)
[U_AssinaturaHTML] – Texto que será usado no rotapé do e-mail como assintaura (pode ser em HTML)
[U_Status]* – Adicionar sempre com o valor ‘N’
[U_MensagemRetorno] – DEIXAR EM BRANCO
[U_DataMsg] – DEIXAR EM BRANCO
[U_HoraMsg] – DEIXAR EM BRANCO
[U_DataEnv] – DEIXAR EM BRANCO
[U_HoraEnv] – DEIXAR EM BRANCO
[U_Usuario] – DEIXAR EM BRANCO
[U_Obs1] – Opcional para observações internas
[U_Obs2] – Opcional para observações internas
[U_Obs3] – Opcional para observações internas
[U_DataProg] – Para programar a data do envio, preencher esse campo no formato data
[U_HoraProg] – Para programar a hora do envio, preencher esse campo no formato hora
[U_ResponderPara] – Para definir um e-mail para receber a resposta
Formatação do campo destinatário de e-mail
Para envio do e-mail, os campos “Destinatário”, “Cópia” e “Cópia oculta” poderão ser utilizados, mas é importante verificar se o servidor de SMTP da sua empresa possui algum tipo de restrição.
Em qualquer dos casos é mandatório, usar ponto-e-vírgula como separador.
Podem ser utilizados pelo serviço, se permitido pelo seu servidor SMTP as opções:
| Formatação: | Exemplo: |
| Simples | suporte@dwu.com.br;contato@dwu.com.br |
| Com <> | <suporte@dwu.com.br>;<contato@dwu.com.br> |
| Com descrição entre aspas duplas e e-mail dentro de<> | “Suporte” <suporte@dwu.com.br>;”Contato” <contato@dwu.com.br> |
| Com descrição entre aspas simples e e-mail dentro de<> | ‘Suporte’ <suporte@dwu.com.br>;’Contato’ <contato@dwu.com.br> |
| Com descrição sem aspas e e-mail dentro de<> | Suporte <suporte@dwu.com.br>; Contato <contato@dwu.com.br> |
Qualquer combinação das anteriores | suporte@dwu.com.br; <suporte@dwu.com.br>;”Suporte” <suporte@dwu.com.br>;’Suporte’ <suporte@dwu.com.br>;suporte <suporte@dwu.com.br> |
Popular os e-mails para envio
Exemplo de INSERT:
INSERT
INTO [dbo].[@DWU_MAIL_SER]
(
[Code]
,[Name]
,[U_ObjType]
,[U_ObjEntry]
,[U_Assunto]
,[U_Destinatario]
,[U_Copia]
,[U_CopiaOculta]
,[U_CaminhoAnexo]
,[U_TextoHTML]
,[U_AssinaturaHTML]
,[U_Status]
,[U_Obs1]
,[U_Obs2]
,[U_Obs3]
,[U_DataProg]
,[U_HoraProg]
,[U_ResponderPara])
VALUES
((SELECT REPLACE(CONVERT(VARCHAR, GETDATE(), 23),'-','')+REPLACE(CONVERT(VARCHAR, GETDATE(), 14),':',''))
,(SELECT REPLACE(CONVERT(VARCHAR, GETDATE(), 23),'-','')+REPLACE(CONVERT(VARCHAR, GETDATE(), 14),':',''))
,'17'
,'1'
,'Pedido Nº '+CAST(@DocEntry as varchar) -- Considerando que @DocEntry é uma variável na sua consulta
,'email1@exemplo.com.br;email2@exemplo.com.br;email3@exemplo.com.br'
,'email4@exemplo.com.br;email5@exemplo.com.br'
,'email6@exemplo.com.br;email7@exemplo.com.br'
,'C:\Temp\Anexo.txt'
,'Olá cliente. Seu pedido XXX está sendo enviado...'
,'Att, Empresa'
,'N'
,'Teste OBS 1'
,'Teste OBS 2'
,'Teste OBS 3'
,'2020-01-01'
,'08:00:00''
,'meuemail@empresa.com'
)Após inserir as informações na tabela, o motor de envio ficará responsável pelo envio.