Configura el correo electrónico

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

De forma predeterminada, el portal de servicios para desarrolladores envía correos electrónicos en respuesta a ciertos eventos. Por ejemplo, cuando un desarrollador nuevo se registra en el portal, este envía de forma automática un correo electrónico de bienvenida al desarrollador. O, si el desarrollador pierde su contraseña, puede solicitar un correo electrónico con una contraseña temporal.

Como proveedor de API, puedes controlar todos los aspectos de los correos electrónicos que genera el portal, incluidos los siguientes:

  • Da formato a los correos electrónicos automáticos que envía el portal
  • Especifica el servidor SMTP que usa el portal
  • Agrega reglas para generar correos electrónicos en respuesta a eventos en el portal

Envía correos electrónicos desde un portal basado en la nube

La configuración predeterminada de correo electrónico para un portal basado en la nube implementado en Pantheon o Acquia solo debe usarse en entornos que no sean de producción. Es posible que los correos electrónicos enviados desde un servidor anónimo en la nube se bloqueen o marquen como spam.

En los portales de producción, usa una de las siguientes opciones para enviar correos electrónicos:

Envía correos electrónicos desde un portal local

De forma predeterminada, los correos electrónicos se envían con la función PHP mail(). PHP intenta enviar correos electrónicos con sendmail en el sistema local, que se puede configurar en el archivo php.ini de PHP.

Para los portales de producción, puedes usar el módulo SMTP que se describe a continuación para enviar correos electrónicos a través de un servidor SMTP o un servidor de la empresa.

Configura un servidor SMTP

El portal para desarrolladores requiere que configures un servidor SMTP para enviar mensajes de correo electrónico. Para configurar el servidor SMTP, primero debes habilitar el módulo de asistencia de autenticación SMTP de Drupal en el portal para desarrolladores.

Después de configurar el servidor SMTP, todos los correos electrónicos que envía el portal para desarrolladores usarán el servidor SMTP. Entre estos mensajes, se incluyen los que se envían a desarrolladores nuevos, los que se envían a los desarrolladores que pierden sus contraseñas y los que se envían a los desarrolladores con cuentas bloqueadas.

Para configurar el servidor SMTP:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Modules en el menú de administración de Drupal.
    Se abrirá la página Módulos.
  3. Habilita el módulo de Compatibilidad con autenticación de SMTP.
  4. Guarde la configuración.
  5. Después de habilitar el módulo, selecciona Configurar en la entrada Compatibilidad de autenticación SMTP de la página Módulos.
    Aparecerá la página de configuración de compatibilidad de autenticación de SMTP.
  6. En Activar o desactivar este módulo, selecciona Activar.
  7. En el área de configuración del servidor SMTP, ingresa la siguiente información:
    • Dirección del servidor SMTP. Por ejemplo, para el servidor SMTP de salida de Gmail, usa smtp.gmail.com.
    • De manera opcional, ingresa la dirección del servidor SMTP de copia de seguridad. Este valor no es obligatorio.
    • Ingresa el puerto SMTP. El valor de este puerto puede ser diferente según el protocolo de encriptación seleccionado. Por ejemplo, en el caso de Gmail, el puerto es 465 cuando se usa SSL y 587 para TLS.
    • Selecciona el protocolo de encriptación como Ninguno, SSL o TLS.
  8. En el área Autenticación de SMTP, especifica el nombre de usuario y la contraseña que se usarán para la autenticación de SMTP. Debe ser un nombre de usuario y una contraseña válidos en el servidor SMTP.
  9. En Opciones de correo electrónico, ingresa la dirección de correo electrónico y el nombre del usuario que genera el mensaje de correo electrónico. Estos valores corresponden a la dirección "De" del correo electrónico.
  10. De manera opcional, en Enviar mensaje de correo electrónico de prueba, ingresa una dirección de correo electrónico en la que el portal envíe un mensaje de prueba.
  11. Guarde la configuración.
    Si guardas la configuración, se genera el mensaje de correo electrónico de prueba y se muestran los errores de configuración. Revisa la bandeja de entrada de la dirección de correo electrónico del mensaje de prueba para asegurarte de que llegue.
  12. Selecciona Configuration > System > Site Information en el menú de administración de Drupal.
  13. En Site Details, configura la dirección de correo electrónico con la misma dirección que especificaste en el paso 9.
    Algunos módulos de Drupal que generan correos electrónicos usan este campo para determinar la dirección de envío del correo electrónico y no el valor que figura en la página de asistencia de autenticación SMTP.
  14. Guarde la configuración.

Configura y da formato a las notificaciones por correo electrónico

Puedes configurar varias notificaciones por correo electrónico que se envían en respuesta a actividades particulares, como el registro, la eliminación, el bloqueo y el desbloqueo de cuentas de desarrollador.

También puedes controlar la dirección "De" de los correos electrónicos.

Para configurar las notificaciones por correo electrónico, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Configuración > Personas > Configuración de la cuenta en el menú de administración de Drupal. Se abrirá la página Configuración de la cuenta.
  3. Selecciona un tipo de notificación por correo electrónico en la sección Correos electrónicos de la página de configuración Cuentas. Por ejemplo, puedes seleccionar "Bienvenida (no se requiere aprobación)", que envía un correo electrónico cuando la cuenta de desarrollador se aprueba automáticamente durante el proceso de registro del desarrollador.

  4. Edita el Asunto y el Cuerpo de la notificación por correo electrónico.
    Coloca el cursor en un campo, como Subject, y selecciona el vínculo Explorar tokens disponibles en la parte inferior del formulario para ver la lista de tokens que puedes usar en el campo. Aparecerá una ventana emergente que te permitirá seleccionar un token para agregar, como [user:name], que corresponde al nombre de usuario del desarrollador.
  5. Haga clic en Guardar configuración.

También puedes cambiar el nombre y la dirección del campo "De" en una notificación por correo electrónico.

Para cambiar el nombre y la dirección del campo "De", sigue estos pasos:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Configuración > Sistema > Asistencia de autenticación SMTP en el menú de administración de Drupal. Se abrirá la página de asistencia de autenticación de SMTP.
  3. En el campo Dirección de correo electrónico del remitente, especifica una dirección de correo electrónico en el campo “De”.
  4. Especifica el nombre "De" en el campo Nombre del remitente de correo electrónico.
  5. Haga clic en Guardar configuración.
  6. Selecciona Configuration > System > Site information en el menú de administración de Drupal.
  7. En el campo Dirección de correo electrónico, especifica la misma dirección de correo electrónico que usaste en el Paso 3.
  8. Haga clic en Guardar configuración.

Generación de un correo electrónico cuando ocurre un evento

Un uso común de las reglas es generar correos electrónicos en respuesta a un evento. El portal tiene compatibilidad integrada con la generación de correos electrónicos para eventos predefinidos, como cuando un desarrollador nuevo registra una cuenta. Sin embargo, puedes agregar tus propias reglas para generar correos electrónicos. Por ejemplo, puedes generar un correo electrónico cuando el desarrollador agrega, quita o modifica una app.

En esta sección, se incluye un ejemplo de cómo crear una regla para generar un correo electrónico cuando un desarrollador registra una app. Modifica este procedimiento según sea necesario a fin de generar correos electrónicos para otros eventos.

Para generar un correo electrónico cuando un desarrollador crea una app, sigue estos pasos:

  1. Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
  2. Selecciona Modules en el menú de administración de Drupal.
  3. Asegúrate de que el módulo Rules UI esté habilitado.
  4. Selecciona Configuración > Flujo de trabajo > Reglas en el menú de administración de Drupal. Se abrirá la página Reglas.
  5. Selecciona el botón Agregar regla nueva.
  6. En la página de reglas nueva, especifica lo siguiente:
    • La regla name, por ejemplo, “Send email rule”
    • De manera opcional, especifica las etiquetas utilizadas para categorizar las reglas de búsqueda.
    • En el menú desplegable React on event (Reaccionar ante el evento), selecciona Devconnect > Cuando se cree una app de desarrollador.
  7. Guarda la regla.
    Si guardas la regla, se abrirá el formulario de edición de reglas con tres paneles: Events (que acabas de crear), Conditions y Actions.
  8. En Acciones, selecciona Agregar acción.
  9. En el menú desplegable Select the Action to Add, selecciona System > send mail.
    Esta selección abre una página que te permite darle formato al correo electrónico. Usa este formulario para especificar los campos "Para", "Asunto", "Mensaje" y otros campos del correo electrónico.

    Expande el vínculo de patrones de Reemplazo que se encuentra debajo de cada campo para ver la lista de patrones que puedes usar en el campo. Por ejemplo, si expandes Patrones de reemplazo en el campo Para, verás una lista de patrones que incluye [app:developer]. Si especificas este patrón en el campo Para, el correo electrónico se envía al creador de la app.
  10. Configura los campos como se muestra a continuación:
  11. Selecciona Guardar para volver a la página de edición de reglas.
  12. Selecciona Guardar cambios.

Agrega una app nueva al portal para probar la regla. Deberías recibir una notificación por correo electrónico en la respuesta que aparece de la siguiente manera:

Subject: App test email app created

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