Ir para o conteúdo principal

6.0 Configuração e uso do serviço de envio de e-mails

Serviç

6.0 - Configuração e uso do serviço de envio

 de e-mails

Instalação do serviço

O serviço de envio de e-mails do CRM One deve ter sua instalação solicitada ao time de suporte da DWU, oupode ser previamenteinstalado:

instalado
    na
  • Durante fase dea implementação do sistema
  • (Portal
  • Ou webmediante ousolicitação Apiao Mobile).

    suporte da DWU

SeráUm serviço chamado CRMOneEmail será instalado no servidor umWindows. novo serviço, onde o padrão de nome para o serviço será “CRMOneEmail”.

O serviço deverá ser configurado paraA inicialização pode ser configurada como automática ou manual, conforme a política da empresa.

Para visualizar o interesseserviço, daacesse empresa,Services.msc podendono ser manual ou automático.Windows:

No servidor poderá ser acessada a configuração através da execução do “Services.MSC” no Windows do seu servidor.Serviço CRMOneEmail

Configuração do SMTP

Para configurar o SMTP, o administrador deverá acessar oNo SAP Business OneOne, e iniciarcom o add-on CRM One.One ativo, acesse:

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:

  1. Uma vez configurado o serviço de envio de e-mail, se não for configurado corretamenteInforme os dados deda SMTPconta oque enviará os e-mails.

    ⚠️ Atenção:
    • O serviço apresentaránão falhafuncionará aose iniciar.o SMTP estiver incorreto.
    • 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 deutilizam envio de e-mails doprecisam CRMestar One,com éSMTP umconfigurado.

Configuração SMTP no CRM One

Como funciona o motor de envio

O serviço que fica em execução no Windows e faz a leitura de uma tabela criada pelo CRM One@DWU_MAIL_SER no banco de dados do SAP Business One (tabelacriada depelo usuário)CRM One).

EstaEssa tabela que armazena todos 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.

  • Usar o recurso de transaction do SAP e fazer através de um INSERT o registro dos e-mails que devem ser enviadosenviados. naEla tabelapode [@DWU_MAIL_SER].ser alimentada de três formas:

    • Com um INSERT manual (via query)
    • ÉAtravés possívelde criar jobs no SQL/HANA paraprogramados
    • envio de relatórios
    • Ou por exemplo,programas em horários pré determinados.
    • Desenvolver programascustomizados que realizaminsiram procedimentosos edados processamentos para chegar ao e-mail que deverá ser enviados e inserir estes e-mails na tabela [@DWU_MAIL_SER]nela

    Detalhes das colunas

    Campos da tabela [@DWU_MAIL_SER]

    [Code]*

    • Code / Name – Número sequencial
      [Name]* (obrigatório)
    • U_ObjType / U_ObjEntryTipo e 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(opcional)
    • gerou
    • U_Assunto o e-mail.
      [U_Assunto]* – Assunto do e-mail
      [U_Destinatario]* (obrigatório)
    • U_Destinatario – E-mails deseparados destinopor 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 ;rgula (pontoobrigatório)
    • e
    • U_Copia, vírgula)
      [U_CopiaOculta]U_CopiaOculta – E-mails em cópia oculta.ou Paracópia maisoculta
    • de
    • U_CaminhoAnexo um e-mail,Caminho usarpara o separador ;anexo (pontoopcional)
    • 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]*
    • U_TextoHTML – Corpo do e-mail (podeHTML serpermitido)
    • em
    • U_AssinaturaHTML HTML)
      [U_AssinaturaHTML] Texto que será usado no rotapéRodapé do e-mail como(HTML assintaurapermitido)
    • (pode
    • U_Status – Deve ser em'N' HTML)
      [U_Status]*(obrigatório)
    • U_DataProg / U_HoraProgAdicionar sempre com Programação valorde ‘N’
      [U_MensagemRetorno]envio (opcional)
    • U_ResponderParaDEIXAR 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-E-mail para receber ade resposta

      (opcional)

    • Demais campos como MensagemRetorno, DataEnv, HoraEnv devem ficar em branco

    Formatação do campo destinatário dedos e-mail

    mails

    ParaO envioseparador doentre múltiplos e-mail,mails osdeve camposser “Destinatário”, “Cópia”ponto e “Cópiavírgula oculta”(;). poderãoAbaixo seralguns utilizados,formatos mas é importante verificar se o servidor de SMTP da sua empresa possui algum tipo de restrição.aceitos:

    Em

    qualquerdoscasosé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
    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" <suporte@dwu.com.br>;”Contato” 'Contato' <contato@dwu.com.br>
    Com descrição entreSem 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>

    QualquerMix combinaçãode das anteriores formatos
    suporte@dwu.com.br; <suporte@dwu.com.br>;”Suporte” <suporte@dwu.com.br>;’Suporte’ <suporte@dwu.com.br>;suporte"Suporte" <suporte@dwu.com.br>

    Exemplo:

    Exemplo de INSERT:

    tabela
    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ósDepois inserirdo as informações na tabela,INSERT, o motorserviço deCRMOneEmail se encarrega do envio ficaráautomático responsáveldos peloe-mails envio.cadastrados.