Email (User Consent) Integration

With this Public Integration, you can send emails through the Gmail API. You can also optionally generate a PDF from Markdown content to include as an attachment.

com.globant.geai.send_email_gmail

Before using the Tool, you must obtain a Gmail OAuth 2.0 access token from Google Cloud and register it as a Secret in your Project.

Configuration steps

1. Go to https://console.cloud.google.com/ and sign in.
2. Create a new project or select an existing one.
3. Go to APIs & Services > Library and enable the Gmail API for that project.
4. From the side menu, go to APIs & Services > OAuth consent screen.
5. Click on Get started, and configure the following:
   • App Information: Enter an App name and a User support email. Click on Next.
   • Audience: Select External (or Internal for organization-only use). Click on Next.
   • Contact Information: Enter your email address. Click on Next.
   • Finish: Accept the "Google API Services: User Data Policy". Click on Continue and then click on the Create button.
6. From the side menu, go to APIs & Services > Credentials.
7. Click on Create Credentials, select OAuth client ID, and configure the following:
   • Application type: Select Web application.
   • Name: Enter a descriptive name (for example, GoogleDrive OAuth 2.0 Web App - geai-app).
   • Authorized redirect URIs: Click on Add URI and paste the exact URL:
     • https://console.<your-domain>/oauth_tool_login_callback (for example, https://console.saia.ai/oauth_tool_login_callback).
   • Click on Create. Copy and securely save the Client ID and Client Secret; you will need them to create the Secret in your Project.
8. Go to the Console, open the Project where you will use this Tool, and create two new Secrets. Follow the steps in How to create a Secret.
   • Create one Secret for the Client ID (for example, gmail_client_id). In the Value field, paste the exact Client ID generated in Google Cloud.
   • Create another Secret for the Client Secret (for example, gmail_client_secret). In the Value field, paste the exact Client Secret generated in Google Cloud.
9. In the Integrations Dashboard, open Email (User Consent) and go to the Integration Parameters tab.
   • In securityScheme.flows.authorizationCode.clientId, enter the name of the Secret that stores the Client ID (for example, gmail_client_id).
   • In securityScheme.flows.authorizationCode.clientSecret, enter the name of the Secret that stores the Client Secret (for example, gmail_client_secret).
10. Go to the Tool Parameters tab.
    • In email-transport-method, set the value to email to indicate that the Gmail API with OAuth 2.0 will be used.

After completing these steps, you can add com.globant.geai.send_email_gmail to your Agent. Authentication is handled through the Integration-level OAuth configuration defined in the Integration Parameters.