Temporam Temporary Mail Skill

This skill enables Manus to interact with the Temporam API to manage temporary email addresses. It can generate new email addresses, check for incoming mail, and retrieve email content, which is useful for tasks requiring email verification or temporary communication.

Capabilities

• Generate Temporary Email Address: Automatically creates a new, unique email address using an available domain from the Temporam service.
• List Emails: Retrieves a list of emails received by a specified temporary email address.
• Get Email Content: Fetches the full content of a specific email using its ID.
• Get Latest Email: Retrieves the most recent email (with full content) for a specific email address — ideal for polling verification emails without needing to list and then fetch by ID.

Usage Instructions

Prerequisites

To use this skill, you must have a valid Temporam API Key. Set it as an environment variable named TEMPORAM_API_KEY in the sandbox environment before invoking any functions from this skill.

export TEMPORAM_API_KEY="YOUR_API_KEY"

Generating a Temporary Email Address

To generate a new temporary email address, use the generate_random_email function from the client.py script. Manus will automatically select an available domain.

Example Prompt:

"请帮我生成一个临时的邮箱地址。"

Internal Action (Manus will execute):

from skills.temporam-temp-mail.scripts.client import TemporamClient

client = TemporamClient()
email_address = client.generate_random_email()
print(f"Generated temporary email: {email_address}")

Listing Emails for an Address

To list emails received by a specific temporary email address, use the list_emails function. You can specify pagination parameters if needed.

Example Prompt:

"查看 test@example.com 这个邮箱收到了哪些邮件。"

Internal Action (Manus will execute):

from skills.temporam-temp-mail.scripts.client import TemporamClient

client = TemporamClient()
email_address = "test@example.com" # Replace with the actual email address
emails = client.list_emails(email_address, page=1, limit=10)
for email in emails:
    print(f"Subject: {email["subject"]}, From: {email["from_email"]}")

Getting Specific Email Content

To retrieve the full content of a particular email, provide the email ID to the get_email_detail function.

Example Prompt:

"获取 ID 为 12345 的邮件内容。"

Internal Action (Manus will execute):

from skills.temporam-temp-mail.scripts.client import TemporamClient

client = TemporamClient()
email_id = "12345" # Replace with the actual email ID
email_detail = client.get_email_detail(email_id)
if email_detail:
    print(f"Email Subject: {email_detail["subject"]}")
    print(f"Email Content: {email_detail["content"]}")

Getting the Latest Email for an Address

To retrieve the most recent email received by a specific address (including full content), use get_latest_email. This is especially useful for polling scenarios where you just need to wait for the next incoming email.

Example Prompt:

"查看 user@temporam.com 最新收到的邮件。"

Internal Action (Manus will execute):

from skills.temporam-temp-mail.scripts.client import TemporamClient

client = TemporamClient()
latest = client.get_latest_email("user@temporam.com")
if latest:
    print(f"Subject: {latest["subject"]}")
    print(f"From: {latest["from_email"]}")
    print(f"Content: {latest["content"]}")
else:
    print("No emails received yet.")

Workflow Example: Email Verification

When a task requires email verification, Manus can perform the following steps:

Method A: Using get_latest_email (Recommended)

1. Generate a temporary email address.
2. Provide this email address to the service requiring verification.
3. Periodically call get_latest_email to poll for the verification email.
4. Once received, extract the verification link or code from the content field.
5. Complete the verification process.

Method B: Using list_emails + get_email_detail

1. Generate a temporary email address.
2. Provide this email address to the service requiring verification.
3. Periodically call list_emails to check for new emails.
4. Once a verification email is received, extract the verification link or code using get_email_detail.
5. Complete the verification process.

References

• Temporam API Reference [1]

[1]: https://www.temporam.com/docs/api-reference "Temporam API Reference"