DocumentaciónKCS de Experience Cloud

AEM as a Cloud Service: Problema de envío de correo electrónico de la API SendGrid al utilizar el servicio OSGi personalizado

Última actualización: 23 de junio de 2026

Este artículo proporciona pasos para resolver problemas con el envío de correo electrónico mediante la API SendGrid desde un servicio OSGi personalizado en Adobe Experience Manager as a Cloud Service.

Descripción description

Entorno

Adobe Experience Manager (AEM) as a Cloud Service (todas las versiones)
Problema/Síntomas

Los intentos de enviar correo electrónico mediante un servicio OSGi personalizado que se integra con la API de REST de SendGrid (https://api.sendgrid.com/v3/mail/send) no entregan los mensajes. El problema se produce después de implementar el código mediante Cloud Manager y ejecutar un proceso de flujo de trabajo que invoca el servicio de correo electrónico SendGrid.

  • Interfaz de configuración OSGi personalizada creada con @ObjectClassDefinition.
  • Archivo de configuración agregado en /apps/csuf-cloud/osgiconfig/config (por ejemplo: com.csuf.cloud.core.config.SendGridConfiguration.cfg.json).
  • Clave de API configurada mediante un secreto de Cloud Manager (SENDGRID_API_KEY).
  • from_email se estableció en una dirección de remitente válida.
  • Déclencheur de proceso de flujo de trabajo personalizados para el servicio de correo electrónico SendGrid.
  • No se ha proporcionado ningún mensaje de error explícito, pero los correos electrónicos no se entregan según lo esperado.

Resolución resolution

  1. Verificar el uso de la clave API SendGrid

    • Asegúrese de que el valor de la clave de API en la configuración de OSGi esté establecido en el secreto de Cloud Manager que contiene la clave de API SendGrid.

    • Al autenticarse con la API SendGrid, utilice siempre la cadena literal apikey como nombre de usuario, independientemente del valor de clave de API real creado en SendGrid.

    • Ejemplo de configuración:

      code language-none 
      "smtp.user": "apikey",
"api_key": "<Cloud Manager secret reference>"

  2. Comprobar implementación de configuración de OSGi

    • Confirme que el archivo de configuración OSGi se implementa correctamente en /apps/<project>/osgiconfig/config y que AEM lo recoge.
    • Compruebe que los valores de configuración (clave de API, correo electrónico del remitente) son correctos y no están vacíos.

  3. Validar referencia secreta de Cloud Manager

    • Asegúrese de que se hace referencia correctamente al secreto de Cloud Manager (SENDGRID_API_KEY) en la configuración y de que está disponible durante la ejecución.

  4. Probar envío de correo electrónico

    • Almacene en déclencheur el proceso de flujo de trabajo desde el entorno de AEM Author y monitorice si la entrega de correo electrónico se realiza correctamente.
    • Compruebe los registros de AEM y SendGrid para ver si hay errores o solicitudes rechazadas.

Causa

La API de SendGrid requiere que el nombre de usuario se establezca como apikey para la autenticación, independientemente del valor de clave de API real. Una configuración incorrecta del nombre de usuario o la clave de API puede impedir que la entrega de correo electrónico se realice correctamente.

recommendation-more-help
experience-cloud-kcs-help-kbarticles