Mudanças entre as edições de "Controllr/Aplicativos/Cadastros/Messenger/Email/Apis"

De BrByte Wiki
(Criou página com '=Mailing APIs= No App Mailing APIs link= O aplicativo Mailing APIs permite realizar a conexão com as plataformas de envio de e-mails. A seguir, most...')
 
 
(19 revisões intermediárias por 6 usuários não estão sendo mostradas)
Linha 5: Linha 5:
 
O aplicativo Mailing APIs permite realizar a conexão com as plataformas de envio de e-mails. A seguir, mostraremos como configurá-la para várias plataformas diferentes.
 
O aplicativo Mailing APIs permite realizar a conexão com as plataformas de envio de e-mails. A seguir, mostraremos como configurá-la para várias plataformas diferentes.
  
<div class="img-responsive align-center">[[arquivo:Controllr-aplicativos-cadastros-mailing-apis.png|link=|830px]]</div>
+
<div class="img-responsive align-center">[[arquivo:Controllr-aplicativos-cadastros-mailing-apis.png|link=]]</div>
  
  
Para adicionar uma nova Api, basta clicar no botão [[arquivo:add.png|link=]] Novo.
+
Para adicionar uma nova API, basta clicar no botão [[arquivo:add.png|link=]] Novo.
  
 
==Novo==
 
==Novo==
Linha 16: Linha 16:
 
===Gmail===
 
===Gmail===
  
Conforme a imagem abaixo, algumas informações devem ser preenchidas.
+
Caso queira utilizar o Gmail como servidor de e-mail, você precisará seguir o passo a passo, pois o Google retirou a permissão de APP menos seguros, para as contas gratuitas. Logo, faça os seguintes procedimentos:
 +
 
 +
* Ative a autenticação de dois fatores da sua conta. [https://myaccount.google.com/signinoptions/two-step-verification Clique aqui] para poder ativar em sua conta.
 +
* Após liberar, você deverá cadastrar uma Senha de App. Ela servirá para que nosso sistema consiga enviar os e-mails. Para ativar, [https://myaccount.google.com/apppasswords pressione aqui].
 +
* Copie a senha e cole no campo senha solicitado no momento do cadastro da API.
 +
* Se for uma conta paga do google, ative o app menos seguros [https://myaccount.google.com/lesssecureapps?pli=1&rapt=AEjHL4OyFCH5Lh8cOFSXb70fc94T6CUhj-q98kfDnIPla1v5tUfs4O40d46Yxw21U6Qy2dm6S_QWSEc4XcXsJe7Xse-s4b8BevrffwbNfKPWXcYMIc07-1g APP menos seguros]
 +
 
 +
Para saber o endereço do servidor do Gmail, a porta e a criptografia de envio, acesse o seguinte link para ter acesso as informações completas: https://support.google.com/mail/answer/7104828?hl.
 +
 
 +
A seguir, é detalhado todos os campos do preenchimento de uma API.
  
 
<div class="img-responsive align-center">[[arquivo:Controllr-aplicativos-cadastros-mailing-apis-novo-gmail.png|link=|590px]]</div>
 
<div class="img-responsive align-center">[[arquivo:Controllr-aplicativos-cadastros-mailing-apis-novo-gmail.png|link=|590px]]</div>
Linha 44: Linha 53:
 
! style="text-align:left; vertical-align:middle;"| Porta
 
! style="text-align:left; vertical-align:middle;"| Porta
 
| style="text-align:left; vertical-align:middle;"| Marque a porta de comunicação do seu servidor de e-mail.
 
| style="text-align:left; vertical-align:middle;"| Marque a porta de comunicação do seu servidor de e-mail.
| style="text-align:left; vertical-align:middle;"| 587
+
| style="text-align:left; vertical-align:middle;"| 465
 
|-
 
|-
 
! style="text-align:left; vertical-align:middle;"| Segurança
 
! style="text-align:left; vertical-align:middle;"| Segurança
| style="text-align:left; vertical-align:middle;"| Marque a criptografia que o seu servidor de e-mail utiliza. Cada servidor de e-mail usa uma criptografia específica ou não possui.<br><br>Por padrão, a segurança usa as seguintes portas:<br>• '''TLS''': Porta 587<br>• '''SSL''': Porta 465<br>• '''Desabilitado:''' Porta 25<br>'''OBS''': Essas portas são um padrão do serviço de e-mail, mas dependendo da configuração do seu servidor de e-mail elas podem ser diferentes   
+
| style="text-align:left; vertical-align:middle;"| Marque a criptografia que o seu servidor de e-mail utiliza. Cada servidor de e-mail usa uma criptografia específica ou não possui.<br><br>Por padrão, a segurança usa as seguintes portas:<br><br>• '''TLS''': Porta 587<br>• '''SSL''': Porta 465<br>• '''Desabilitado:''' Porta 25<br><br>'''Obs.:''': Essas portas são um padrão do serviço de e-mail, mas, dependendo da configuração do seu servidor de e-mail, elas podem ser diferentes.  
| style="text-align:left; vertical-align:middle;"| TLS
+
| style="text-align:left; vertical-align:middle;"| SSL
 +
|-
 +
! style="text-align:center" colspan="3"| Autorização
 
|-
 
|-
! style="text-align:left; vertical-align:middle;"| Login
+
! style="text-align:left; vertical-align:middle;"| Usuário
| style="text-align:left; vertical-align:middle;"| Insira o seu e-mail para o envio
+
| style="text-align:left; vertical-align:middle;"| Insira o seu e-mail pela qual será disparado o envio.
| style="text-align:left; vertical-align:middle;"| miguel@brbyte.com
+
| style="text-align:left; vertical-align:middle;"| klelber@brbyte.com
 
|-
 
|-
 
! style="text-align:left; vertical-align:middle;"| Senha
 
! style="text-align:left; vertical-align:middle;"| Senha
 
| style="text-align:left; vertical-align:middle;"| Insira a senha do seu servidor de e-mail
 
| style="text-align:left; vertical-align:middle;"| Insira a senha do seu servidor de e-mail
| style="text-align:left; vertical-align:middle;"| ***********
+
| style="text-align:left; vertical-align:middle;"| Senha.123a
 
|-
 
|-
 
! style="text-align:left; vertical-align:middle;"| De Nome
 
! style="text-align:left; vertical-align:middle;"| De Nome
| style="text-align:left; vertical-align:middle;"| Insira o nome que irá aparecer no e-mail do seu cliente quando for disparado
+
| style="text-align:left; vertical-align:middle;"| Insira o nome que irá aparecer no e-mail do seu cliente quando for disparado.
| style="text-align:left; vertical-align:middle;"| Brbyte Softwares
+
| style="text-align:left; vertical-align:middle;"| Brbyte
 
|-
 
|-
 
! style="text-align:left; vertical-align:middle;"| De E-mail
 
! style="text-align:left; vertical-align:middle;"| De E-mail
| style="text-align:left; vertical-align:middle;"| Insira qual é o remetente do e-mail que irá aparecer para o seu cliente quando for disparado
+
| style="text-align:left; vertical-align:middle;"| Insira o remetente do e-mail que irá aparecer para o seu cliente quando for enviado.
| style="text-align:left; vertical-align:middle;"| miguel@brbyte.com
+
| style="text-align:left; vertical-align:middle;"| klelber@brbyte.com
 
|-
 
|-
! style="text-align:left; vertical-align:middle;"| Intervalo de Envio
+
! style="text-align:left; vertical-align:middle;"| Intervalo
| style="text-align:left; vertical-align:middle;"| Insira o intervalo de tempo em segundos que será disparado os e-mails  
+
| style="text-align:left; vertical-align:middle;"| Insira o intervalo de tempo (em segundos) que será disparado os e-mails.
 
| style="text-align:left; vertical-align:middle;"| 30
 
| style="text-align:left; vertical-align:middle;"| 30
 
|-
 
|-
! style="text-align:left; vertical-align:middle;"| Qnt. de envios
+
! style="text-align:left; vertical-align:middle;"| Limite
| style="text-align:left; vertical-align:middle;"| Insira a quantidade de e-mails a serem enviados durante o intervalo de envios.<br>É recomendável que a quantidade de envio seja menor que o intervalo de envio, para que não congestione o seu servidor de e-mail, evitando que os e-mail não sejam disparados
+
| style="text-align:left; vertical-align:middle;"| Insira a quantidade de e-mails a serem enviados durante o intervalo.<br><br>'''Obs.:''' É recomendável que a quantidade de envio seja menor que o intervalo de envio. Isso evitará que congestione o seu servidor de e-mail, o que poderia resultar nos e-mails não serem disparados.
 
| style="text-align:left; vertical-align:middle;"| 5
 
| style="text-align:left; vertical-align:middle;"| 5
 
|-
 
|-
 
|}
 
|}
  
 +
===Outlook===
 +
 +
Caso queira utilizar o Outlook como servidor de e-mail, você precisará saber os dados de configuração de seu servidor. Logo, faça os seguintes procedimentos:
 +
 +
* Acesse sua conta do Outlook.
 +
* Vá em Configurações, depois clique em Exibir todas as configurações do Outlook.
 +
* Clique na aba E-mail no menu lateral esquerdo.
 +
* Após isso, clique no submenu Sincronizar E-mail e salve as informações de configuração.
  
 +
A seguir, é detalhado todos os campos do preenchimento de uma API.
  
===Outlook===
+
<div class="img-responsive align-center">[[arquivo:Controllr-aplicativos-cadastros-mailing-apis-novo-outlook.png|link=|590px]]</div>
 +
 
 +
 
 +
{| class="table table-bordered table-striped" style="margin:auto;"
 +
! style="text-align:center" colspan="3"| Novo Servidor
 +
|-
 +
! style="text-align:center"| Campo
 +
! style="text-align:center"| Descrição
 +
! style="text-align:center"| Exemplo
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Nome
 +
| style="text-align:left; vertical-align:middle;"| Descreva um nome para a sua aplicação que está sendo cadastrada.
 +
| style="text-align:left; vertical-align:middle;"| Outlook - Cadastro
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Habilitado
 +
| style="text-align:left; vertical-align:middle;"| Habilita ou desabilita para aparecer nas listas de APIs disponíveis.
 +
| style="text-align:left; vertical-align:middle;"| <font size="4" style="color:blue;"><i class="far fa-check-square"></i></font>
 +
|-
 +
! style="text-align:center" colspan="3"| Acesso
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Host
 +
| style="text-align:left; vertical-align:middle;"| Informe o endereço do seu servidor de e-mail.
 +
| style="text-align:left; vertical-align:middle;"| smtp.office365.com
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Porta
 +
| style="text-align:left; vertical-align:middle;"| Marque a porta de comunicação do seu servidor de e-mail.
 +
| style="text-align:left; vertical-align:middle;"| 465
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Segurança
 +
| style="text-align:left; vertical-align:middle;"| Marque a criptografia que o seu servidor de e-mail utiliza. Cada servidor de e-mail usa uma criptografia específica ou não possui.<br><br>Por padrão, a segurança usa as seguintes portas:<br><br>• '''TLS''': Porta 587<br>• '''SSL''': Porta 465<br>• '''Desabilitado:''' Porta 25<br><br>'''Obs.:''': Essas portas são um padrão do serviço de e-mail, mas, dependendo da configuração do seu servidor de e-mail, elas podem ser diferentes. 
 +
| style="text-align:left; vertical-align:middle;"| SSL
 +
|-
 +
! style="text-align:center" colspan="3"| Autorização
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Usuário
 +
| style="text-align:left; vertical-align:middle;"| Insira o seu e-mail pela qual será disparado o envio.
 +
| style="text-align:left; vertical-align:middle;"| contaTeste@hotmail.com
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Senha
 +
| style="text-align:left; vertical-align:middle;"| Insira a senha do seu servidor de e-mail
 +
| style="text-align:left; vertical-align:middle;"| Senha.123a
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| De Nome
 +
| style="text-align:left; vertical-align:middle;"| Insira o nome que irá aparecer no e-mail do seu cliente quando for disparado.
 +
| style="text-align:left; vertical-align:middle;"| Brbyte
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| De E-mail
 +
| style="text-align:left; vertical-align:middle;"| Insira o remetente do e-mail que irá aparecer para o seu cliente quando for enviado.
 +
| style="text-align:left; vertical-align:middle;"| contaTeste@hotmail.com
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Intervalo
 +
| style="text-align:left; vertical-align:middle;"| Insira o intervalo de tempo (em segundos) que será disparado os e-mails.
 +
| style="text-align:left; vertical-align:middle;"| 30
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Limite
 +
| style="text-align:left; vertical-align:middle;"| Insira a quantidade de e-mails a serem enviados durante o intervalo.<br><br>'''Obs.:''' É recomendável que a quantidade de envio seja menor que o intervalo de envio. Isso evitará que não congestione o seu servidor de e-mail, evitando que os e-mail não sejam disparados.
 +
| style="text-align:left; vertical-align:middle;"| 5
 +
|-
 +
|}
 +
 
 +
=Listagem e Status=
 +
 
 +
Nesse material, você poderá realizar filtros para listar e consultar aplicações e-mail específicas de seu sistema. Para isso, você precisará ir na listagem do aplicativo e realizar sua filtragem como desejado.
 +
 
 +
{| class="table table-bordered table-striped" style="text-align:center;"
 +
!style="text-align:center" colspan="2"| Filtros
 +
|-
 +
!style="text-align:center; width:17%;"| Menu
 +
!style="text-align:center;"| Descrição
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Habilitado
 +
| style="text-align:left; vertical-align:middle;"| O filtro lista as aplicações que estão habilitadas ou desabilitadas, de acordo com a opção marcada: <br> [[arquivo: dot-green.png|link=]] Sim; <br> [[arquivo: dot-light.png|link=]] Não; <br> [[arquivo: reports.png|link=]] '''-''' (Todos).
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Colunas Ocultas
 +
| style="text-align:left; vertical-align:middle;"| Você pode complementar o seu relatório/filtro habilitando colunas ocultas dessa janela. Para aparecer a opção de colunas ocultas, você deve passar o mouse em cima de qualquer coluna. Dessa forma, aparecerá uma seta para baixo. Clique nela e vá na opção [[arquivo:columns.gif|link=]] '''Columns'''. Logo, basta selecionar os campos que gostaria de ser exibido na tela.<br><br><div class="img-responsive">[[arquivo:controllr-aplicativos-colunas-ocultas.png|link=]]</div>
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| [[arquivo:search.png|link=]] Busca
 +
| style="text-align:left; vertical-align:middle;"| Nesse campo, você pode realizar buscar específicas seja por ID, Nome, entre outros. Primeiramente, marque a opção que se refere a busca, depois no campo seguinte, escreva o que buscar conforme a opção selecionada. Por fim, clique no ícone da lupa ([[arquivo:search.png|link=]]) para buscar.
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| [[arquivo:export.png|link=]] Exportar
 +
| style="text-align:left; vertical-align:middle;"| Após aplicar os filtros, poderá realizar a [[Controllr/Aplicativos/Exportar | exportação]] desse relatório no formato:<br>[[arquivo:dot-green.png|link=]] Excel<br>[[arquivo:dot-light.png|link=]] CSV<br>[[arquivo:dot-blue.png|link=]] HTML
 +
|-
 +
|}
 +
[[category:Email]]
 +
[[category:Cadastros]]
 +
[[category:Messenger]]
 +
[[category:Email]]
 +
__NOEDITSECTION__

Edição atual tal como às 10h06min de 27 de abril de 2024

Mailing APIs

No App Mailing APIs Mail-48.png

O aplicativo Mailing APIs permite realizar a conexão com as plataformas de envio de e-mails. A seguir, mostraremos como configurá-la para várias plataformas diferentes.

Controllr-aplicativos-cadastros-mailing-apis.png


Para adicionar uma nova API, basta clicar no botão Add.png Novo.

Novo

Nesta sessão, ensinaremos o passo a passo para conectar suas APIs com o nosso sistema. Essa API poderá ser qualquer uma de sua preferência. Vamos fazer o passo a passo para as duas mais famosas: o Gmail e o Outlook.

Gmail

Caso queira utilizar o Gmail como servidor de e-mail, você precisará seguir o passo a passo, pois o Google retirou a permissão de APP menos seguros, para as contas gratuitas. Logo, faça os seguintes procedimentos:

  • Ative a autenticação de dois fatores da sua conta. Clique aqui para poder ativar em sua conta.
  • Após liberar, você deverá cadastrar uma Senha de App. Ela servirá para que nosso sistema consiga enviar os e-mails. Para ativar, pressione aqui.
  • Copie a senha e cole no campo senha solicitado no momento do cadastro da API.
  • Se for uma conta paga do google, ative o app menos seguros APP menos seguros

Para saber o endereço do servidor do Gmail, a porta e a criptografia de envio, acesse o seguinte link para ter acesso as informações completas: https://support.google.com/mail/answer/7104828?hl.

A seguir, é detalhado todos os campos do preenchimento de uma API.

Controllr-aplicativos-cadastros-mailing-apis-novo-gmail.png


Novo Servidor
Campo Descrição Exemplo
Nome Descreva um nome para a sua aplicação que está sendo cadastrada. Gmail - Cadastro
Habilitado Habilita ou desabilita para aparecer nas listas de APIs disponíveis.
Acesso
Host Informe o endereço do seu servidor de e-mail. smtp.gmail.com
Porta Marque a porta de comunicação do seu servidor de e-mail. 465
Segurança Marque a criptografia que o seu servidor de e-mail utiliza. Cada servidor de e-mail usa uma criptografia específica ou não possui.

Por padrão, a segurança usa as seguintes portas:

TLS: Porta 587
SSL: Porta 465
Desabilitado: Porta 25

Obs.:: Essas portas são um padrão do serviço de e-mail, mas, dependendo da configuração do seu servidor de e-mail, elas podem ser diferentes.
SSL
Autorização
Usuário Insira o seu e-mail pela qual será disparado o envio. klelber@brbyte.com
Senha Insira a senha do seu servidor de e-mail Senha.123a
De Nome Insira o nome que irá aparecer no e-mail do seu cliente quando for disparado. Brbyte
De E-mail Insira o remetente do e-mail que irá aparecer para o seu cliente quando for enviado. klelber@brbyte.com
Intervalo Insira o intervalo de tempo (em segundos) que será disparado os e-mails. 30
Limite Insira a quantidade de e-mails a serem enviados durante o intervalo.

Obs.: É recomendável que a quantidade de envio seja menor que o intervalo de envio. Isso evitará que congestione o seu servidor de e-mail, o que poderia resultar nos e-mails não serem disparados.
5

Outlook

Caso queira utilizar o Outlook como servidor de e-mail, você precisará saber os dados de configuração de seu servidor. Logo, faça os seguintes procedimentos:

  • Acesse sua conta do Outlook.
  • Vá em Configurações, depois clique em Exibir todas as configurações do Outlook.
  • Clique na aba E-mail no menu lateral esquerdo.
  • Após isso, clique no submenu Sincronizar E-mail e salve as informações de configuração.

A seguir, é detalhado todos os campos do preenchimento de uma API.

Controllr-aplicativos-cadastros-mailing-apis-novo-outlook.png


Novo Servidor
Campo Descrição Exemplo
Nome Descreva um nome para a sua aplicação que está sendo cadastrada. Outlook - Cadastro
Habilitado Habilita ou desabilita para aparecer nas listas de APIs disponíveis.
Acesso
Host Informe o endereço do seu servidor de e-mail. smtp.office365.com
Porta Marque a porta de comunicação do seu servidor de e-mail. 465
Segurança Marque a criptografia que o seu servidor de e-mail utiliza. Cada servidor de e-mail usa uma criptografia específica ou não possui.

Por padrão, a segurança usa as seguintes portas:

TLS: Porta 587
SSL: Porta 465
Desabilitado: Porta 25

Obs.:: Essas portas são um padrão do serviço de e-mail, mas, dependendo da configuração do seu servidor de e-mail, elas podem ser diferentes.
SSL
Autorização
Usuário Insira o seu e-mail pela qual será disparado o envio. contaTeste@hotmail.com
Senha Insira a senha do seu servidor de e-mail Senha.123a
De Nome Insira o nome que irá aparecer no e-mail do seu cliente quando for disparado. Brbyte
De E-mail Insira o remetente do e-mail que irá aparecer para o seu cliente quando for enviado. contaTeste@hotmail.com
Intervalo Insira o intervalo de tempo (em segundos) que será disparado os e-mails. 30
Limite Insira a quantidade de e-mails a serem enviados durante o intervalo.

Obs.: É recomendável que a quantidade de envio seja menor que o intervalo de envio. Isso evitará que não congestione o seu servidor de e-mail, evitando que os e-mail não sejam disparados.
5

Listagem e Status

Nesse material, você poderá realizar filtros para listar e consultar aplicações e-mail específicas de seu sistema. Para isso, você precisará ir na listagem do aplicativo e realizar sua filtragem como desejado.

Filtros
Menu Descrição
Habilitado O filtro lista as aplicações que estão habilitadas ou desabilitadas, de acordo com a opção marcada:
Dot-green.png Sim;
Dot-light.png Não;
Reports.png - (Todos).
Colunas Ocultas Você pode complementar o seu relatório/filtro habilitando colunas ocultas dessa janela. Para aparecer a opção de colunas ocultas, você deve passar o mouse em cima de qualquer coluna. Dessa forma, aparecerá uma seta para baixo. Clique nela e vá na opção Columns.gif Columns. Logo, basta selecionar os campos que gostaria de ser exibido na tela.

Controllr-aplicativos-colunas-ocultas.png
Search.png Busca Nesse campo, você pode realizar buscar específicas seja por ID, Nome, entre outros. Primeiramente, marque a opção que se refere a busca, depois no campo seguinte, escreva o que buscar conforme a opção selecionada. Por fim, clique no ícone da lupa (Search.png) para buscar.
Export.png Exportar Após aplicar os filtros, poderá realizar a exportação desse relatório no formato:
Dot-green.png Excel
Dot-light.png CSV
Dot-blue.png HTML