API di email transazionali per agenti AI: guida Mailpro™ v2

Se hai letto la nostra guida pilastro su agenti AI e API Mailpro™, sai già perché collegare un agente AI a un'API email è il percorso più breve tra "chatbot" e "collega digitale". Questo articolo approfondisce un'API specifica — la Mailpro™ Email API v2 — con un setup funzionante sia per l'invio transazionale sia per le campagne, pilotati da Claude, GPT o qualsiasi LLM con tool calling.

In breve

• Mailpro™ Email API v2 accetta IdClient + ApiKey via HTTPS — nessun SDK.
• Gli endpoint più usati sono /send/sendmail.json (transazionale) e /send/campaign.json (bulk).
• Qualsiasi LLM con tool calling può pilotare l'API tramite un wrapper minimale.
• Ogni endpoint è documentato in 20+ linguaggi di programmazione sul nostro portale sviluppatori.

Email guidate dall'AI: i casi d'uso che contano

Conferme d'ordine intelligenti

Le conferme d'ordine standard hanno forma di template. Il tuo agente AI può fare di più: può scrivere una nota personale ("Grazie per aver scelto il modello XL Blu, un preferito dei clienti") e agganciare raccomandazioni dinamiche, poi chiamare l'API email per spedire il tutto. Mantieni l'affidabilità di un template strutturato con il calore di una nota umana.

Auto-triage del supporto

Quando arriva un ticket, l'agente lo classifica, scrive una risposta e — se la confidenza è sufficiente — la invia direttamente. I ticket a bassa confidenza vanno a un umano. Questo modello ibrido è esattamente ciò che i team di supporto in produzione stanno dispiegando oggi.

Generazione di digest

Su larga scala i dirigenti vogliono sintesi, non fiumi. Un agente legge 40 fatture al giorno ed emette un digest alle 18: "Oggi: 12 pagate, 3 scadute, 2 da verificare". Un'email, zero rumore. L'API Email Mailpro™ si occupa della consegna; il LLM della sintesi.

Setup in 5 minuti

1. Recuperare IdClient e ApiKey

Entrambi si trovano nel tuo account Mailpro™ sotto Impostazioni → Accesso API. IdClient è un ID numerico; ApiKey è un GUID. Tieni segreta la chiave — trattala come una password.

2. Verifica con /account/credits.json

Prima di collegare Claude, verifica che le credenziali funzionino:

curl "https://api.mailpro.com/v2/account/credits.json?IdClient=YOUR_ID&ApiKey=YOUR_API_KEY"

Devi ricevere un JSON con i crediti email residui. Se vedi 401, controlla la chiave. Se vedi 500, consulta la nostra pagina di stato.

3. Esplorare la reference completa

Ogni endpoint è documentato — con la forma di richiesta/risposta e un pannello "prova subito" — sulla reference Email API v2. Aprila in un'altra scheda e tienila a portata di mano.

Passo dopo passo: Claude invia un'email transazionale

Usiamo Claude di Anthropic per questo esempio, ma lo stesso pattern funziona con il function calling di OpenAI o il tool use di Gemini — cambia l'SDK, l'architettura resta.

1. Definire lo schema dello strumento

tools = [{
    "name": "send_transactional_email",
    "description": "Invia un'email una tantum a un singolo destinatario via Mailpro.",
    "input_schema": {
        "type": "object",
        "properties": {
            "to":      {"type": "string", "format": "email"},
            "subject": {"type": "string"},
            "html":    {"type": "string", "description": "Corpo HTML completo"},
            "from":    {"type": "string", "description": "Indirizzo mittente validato"}
        },
        "required": ["to", "subject", "html", "from"]
    }
}]

2. Scrivere il system prompt

Sei un assistente che aiuta gli addetti customer success a scrivere e
inviare email di follow-up. Quando l'umano conferma, usa lo strumento
`send_transactional_email`. Sii conciso, cordiale, e includi sempre un
link call-to-action chiaro.

3. Elaborare il tool call e colpire /send/sendmail.json

Stai configurando invii transazionali? Le email automatiche di Mailpro scattano all’istante a ogni trigger — ricevute, conferme, avvisi — con una consegna affidabile.

import requests, json, anthropic

def execute_tool(name, args):
    if name != "send_transactional_email":
        return {"error": "strumento sconosciuto"}
    r = requests.post(
        "https://api.mailpro.com/v2/send/sendmail.json",
        params={"IdClient": MAILPRO_ID, "ApiKey": MAILPRO_KEY},
        data={nvio con i dati della tua lista.
    

Lanciare la campagna con /send/campaign.json

curl -X POST "https://api.mailpro.com/v2/send/campaign.json" \
  -d "IdClient=YOUR_ID&ApiKey=YOUR_API_KEY" \
  -d "AddressBookId=42" \
  -d "IDMessage=9001" \
  -d "PlanDate=2026-05-01T09:00:00"

PlanDate è opzionale — omettilo e la campagna parte subito. Includilo e Mailpro™ programma l'invio per te. Buon pattern: lascia che l'agente scelga PlanDate in base al fuso del destinatario.

Personalizzazione con placeholder

Placeholder come [FirstName] e [LastName] sono standard; i campi personalizzati ([Field1], [Field2]…) mappano sulle colonne custom della tua lista nell'ordine in cui le hai definite. L'agente non deve conoscere i valori — referenzia il placeholder nell'HTML generato, l'API riempie per destinatario.

Importare contatti in massa dall'upload dell'agente

Quando la prima azione del workflow dell'agente è "aggiungi 500 nuovi lead", non vuoi 500 chiamate API singole. Usa l'endpoint /import/upload.json che abbiamo aggiunto di recente:

curl -X POST "https://api.mailpro.com/v2/import/upload.json" \
  -F "IdClient=YOUR_ID" \
  -F "ApiKey=YOUR_API_KEY" \
  -F "AddressBookId=42" \
  -F "[email protected]" \
  -F "WebhookUrl=https://example.com/hooks/import-done"

L'endpoint mette il file in coda e restituisce subito un ImportJobId. A fine elaborazione, Mailpro™ fa POST di un callback al tuo WebhookUrl con il bilancio (importati / scartati / non validi). Specifica completa nella sezione Import della /send/sendmail.json. Le aperture dei promem