Como configurar o e-mail

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Por padrão, o portal de serviços para desenvolvedores envia e-mails em resposta a determinados eventos. Para exemplo, quando um novo desenvolvedor se registra no portal, ele envia automaticamente uma mensagem de boas-vindas para o desenvolvedor. Ou, se o desenvolvedor perder a senha, poderá solicitar uma e-mail com uma senha temporária.

Como provedor de API, você pode controlar todos os aspectos dos e-mails gerados pelo portal, incluindo:

  • Formatação dos e-mails automáticos enviados pelo portal
  • Como especificar o servidor SMTP usado pelo portal
  • Adição de regras para gerar e-mails em resposta a eventos no portal

Como enviar e-mails de um portal baseado na nuvem

A configuração de e-mail padrão para um portal baseado na nuvem implantado no Pantheon ou Acquia deve ser usadas apenas em ambientes que não sejam de produção. E-mails enviados de um servidor anônimo na nuvem podem ser bloqueados ou marcados como spam.

Para portais de produção, use uma das seguintes opções para enviar e-mails:

Como enviar e-mails de um portal no local

Por padrão, os e-mails são enviados usando a linguagem PHP mail(). O PHP tenta enviar e-mails usando o sendmail no sistema local, que pode ser configurado no arquivo php.ini do PHP .

Para portais de produção, você pode usar o módulo SMTP descrito abaixo para enviar e-mails por meio de um servidor SMTP ou servidor da empresa.

Como configurar um servidor SMTP

O portal do desenvolvedor exige que você configure um servidor SMTP para enviar mensagens de e-mail. Para configurar o servidor SMTP, é necessário ativar primeiro o módulo de suporte à autenticação SMTP Drupal no no portal do Google Cloud.

Depois que você configurar o servidor SMTP, todos os e-mails enviados pelo portal do desenvolvedor usarão o protocolo SMTP servidor. Esses e-mails incluem e-mails enviados para novos desenvolvedores e e-mails enviados para desenvolvedores que perderam a senha e os e-mails enviados aos desenvolvedores com contas bloqueadas.

Para configurar o servidor SMTP:

  1. Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Modules no menu de administração do Drupal.
    A página "Módulos" será aberta.
  3. Ative o módulo Suporte a autenticação SMTP.
  4. Salve a configuração.
  5. Depois que o módulo for ativado, selecione Configurar no menu suspenso de Entrada de suporte na página Módulos.
    A página de configuração Suporte a autenticação SMTP é exibida.
  6. Em Ativar ou desativar este módulo, selecione Ativado.
  7. Na área de configurações do servidor SMTP, digite as seguintes informações:
    • Endereço do servidor SMTP. Por exemplo, para o servidor SMTP de saída do Gmail, use smtp.gmail.com.
    • Também é possível digitar o endereço do servidor SMTP de backup. Esse valor não é obrigatórios.
    • Digite a porta SMTP. O valor dessa porta pode ser diferente com base o protocolo de criptografia selecionado. Por exemplo, para o Gmail, a porta é 465 ao usar SSL e 587 para TLS.
    • Selecione o protocolo de criptografia como Nenhum, SSL ou TLS
  8. Na área Autenticação SMTP, especifique o nome de usuário e a senha usados. para a autenticação SMTP. Precisa ser um nome de usuário e uma senha válidos no servidor SMTP.
  9. Em E-mail options, digite o endereço de e-mail e o nome do usuário. gerando a mensagem de e-mail. Esses valores correspondem ao campo "De" endereço de e-mail.
  10. Opcionalmente, em Enviar mensagem de e-mail de teste, insira um endereço de e-mail no qual o portal envia uma mensagem de teste.
  11. Salve a configuração.
    Salvar a configuração gera a mensagem de e-mail de teste e mostra todas as configurações erros. Verifique a caixa de entrada do endereço de e-mail da mensagem de teste para garantir que ela chega.
  12. Selecione Configuração > Sistema > Informações do local no Drupal no menu de administração.
  13. Em Detalhes do site, defina o endereço de e-mail para o mesmo endereço do especificado na Etapa 9.
    Alguns módulos Drupal que geram e-mails usam esse campo para determinar o campo “De” do e não o valor na página Suporte a autenticação SMTP.
  14. Salve a configuração.

Configuração e formatação de e-mails notificações

Você pode configurar várias notificações por e-mail que são enviadas em resposta a determinados como registrar, excluir, bloquear e desbloquear contas de desenvolvedor.

Também é possível controlar o botão "De" endereço de e-mail.

Para configurar notificações por e-mail:

  1. Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Configuração > Pessoas > Configurações da conta no Drupal no menu de administração. A página "Configurações da conta" será aberta.
  3. Selecione um tipo de notificação por e-mail na seção E-mails da página de configuração Contas. Por exemplo, você pode selecionar "Boas-vindas (não é necessário aprovação)", que envia um e-mail quando o conta de desenvolvedor é aprovada automaticamente durante o processo de registro.

  4. Edite o Assunto e o Corpo da notificação por e-mail.
    Coloque o cursor em um campo, como Assunto, e selecione o Procurar tokens disponíveis na parte inferior do formulário para ver a lista de tokens que podem ser usados no campo. É exibido um pop-up que permite selecionar um token a ser adicionado, como como [user:name], que corresponde ao nome de usuário do desenvolvedor.
  5. Clique em Save configuration.

Também é possível alterar o campo "De" e endereço em uma notificação por e-mail.

Para alterar o campo "De" nome e endereço:

  1. Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Configuração > Sistema > Suporte a autenticação SMTP no Menu de administração Drupal. Essa ação abre a página Suporte a autenticação SMTP.
  3. Especifique um campo "De" Endereço de e-mail no campo Endereço do remetente do e-mail.
  4. Especifique um campo "De" no campo Nome do remetente do e-mail.
  5. Clique em Save configuration.
  6. Selecione Configuração > Sistema > Informações do local no Drupal no menu de administração.
  7. Especifique o mesmo endereço de e-mail usado na Etapa 3 no campo Endereço de E-mail.
  8. Clique em Save configuration.

Como gerar um e-mail quando ocorrer um evento

As regras costumam ser usadas para gerar e-mails em resposta a um evento. O portal foi integrado suporte à geração de e-mails para eventos predefinidos, como quando um novo desenvolvedor registra um do Compute Engine. No entanto, você pode adicionar suas próprias regras para gerar e-mails. Por exemplo, é possível gerar um e-mail quando o desenvolvedor adicionar, remover ou modificar um aplicativo.

Esta seção contém um exemplo de como criar uma regra para gerar um e-mail quando um desenvolvedor que registra um app. Modifique esse procedimento conforme necessário para gerar e-mails para outros eventos.

Para gerar um e-mail quando um desenvolvedor criar um app:

  1. Faça login no seu portal como usuário com privilégios de administrador ou de criação de conteúdo.
  2. Selecione Modules no menu de administração do Drupal.
  3. Verifique se o módulo Rules UI está ativado.
  4. Selecione Configuração > Fluxo de trabalho > Regras na administração Drupal . A página "Regras" será aberta.
  5. Selecione o botão Adicionar uma nova regra.
  6. Na página da nova regra, especifique:
    • O nome da regra, por exemplo, "Enviar regra de e-mail".
    • É possível especificar quaisquer tags usadas para categorizar as regras do pesquisa.
    • No menu suspenso Reação ao evento, selecione Devconnect > Após a criação de um app de desenvolvedor.
  7. Salve a regra.
    Salvar a regra abre o formulário de edição de regras com três painéis: Eventos (que você recém-criado), Condições e Ações.
  8. Em Ações, selecione Adicionar ação.
  9. No menu suspenso Select the Action to Add, selecione System > enviar e-mail.
    Essa seleção abre uma página em que é possível formatar o e-mail. Use este formulário para especificar "Subject", "Message" e outros campos do e-mail.

    Expanda o link Padrões de substituição em cada campo para ver a lista de padrões que podem ser usados no campo. Por exemplo, se você expandir "Padrões de substituição" em No campo "Para", aparece uma lista de padrões que inclui [app:developer]. Se você especificar isso no campo Para, o e-mail será enviado para o criador do aplicativo.
  10. Defina os campos conforme mostrado abaixo:
  11. Selecione Salvar para voltar à página de edição de regras.
  12. Selecione Salvar alterações.

Adicione um novo app ao portal para testar a regra. Você receberá uma notificação por e-mail em que aparece como abaixo:

Subject: App test email app created

App: test email app
API products: PremiumWeatherAPI, weatherapikey-Product
Created at: Mon, 01/27/2014 - 10:16