Email Integration

With this Public Integration, you can send emails through any SMTP server, compose structured messages with defined recipients (TO, CC, BCC), and generate the subject and body using the Agent’s response as the email content. You can also optionally generate a PDF from Markdown content to include as an attachment.

com.globant.geai.send_email_smtp

Before using the Tool, you must obtain SMTP credentials from your email provider and register them as a Secret in your Project.

Configuration steps

1. Get your SMTP credentials from your email provider:
   • Host: This is the address of the provider’s SMTP server. For example:
     • Gmail: smtp.gmail.com
     • Outlook: smtp.office365.com
   • Port: Use 587 for TLS or 465 for SSL.
   • Username: Usually your email address (for example, user@example.com).
   • Password: Depends on the provider:
     • Gmail: You must generate an App Password in your Google Account (not your regular password). For steps, see https://support.google.com/accounts/answer/185833?hl=en
     • Other providers: Use your login password or create an app-specific password from your account settings.

2. In Console, open the Project where you will use this Tool and create a new Secret. Follow How to create a Secret.

   • In the Name field, enter a descriptive name (for example, email_smtp). You will reference this name in the smtp_credentials parameter of the Tool.
   • In the Value field, paste the credential in the required format.
     

        {
          "host": "<smtp.example.com>",
          "port": 587, // Supported ports are 587 (TLS) and 465 (SSL)
          "username": "<your_username>",
          "password": "<your_password>" // If using Gmail as SMTP, use an App Password, not your account password. 
        }
        

3. Confirm to save the Secret.

You can configure the Tool Parameters in either of the following ways:

• From the Integrations Dashboard, open the Email Integration and go to the Tool Parameters tab. There, complete:

  • email-transport-method: Set the value to smtp.
  • smtp-credentials: Enter the name of the Secret created in the previous step (for example, email_smtp).

  

• Or, when adding the Tool from the AI & Tools Tab inside an Agent. If the Integration has not been configured yet, the Tool panel will display the required fields so you can define:

  • email-transport-method
  • smtp-credentials

In both cases, smtp-credentials is defined as a Secret parameter and must reference the name of the Secret that stores the SMTP credentials JSON.