Esempi di codice
Esempi per inviare tramite Mailiqo dai linguaggi e framework più comuni, via SMTP o con l'API.
Versioni verificate il 2 novembre 2026
Nodemailer 10.3.1, PHPMailer 7.1.1, Laravel 13 (valido anche per 11 e 12), Symfony 8.1 e la libreria standard di Python 3. Basato sulla documentazione ufficiale di ogni progetto (link alla fine).
Prima di iniziare
- SMTP: host
smtpmq.mailiqo.com, porta587con STARTTLS (o465con TLS implicito), e nome utente e password SMTP del dominio, da Email → Domini. - API: un'API key da Impostazioni → API e integrazioni, inviata nell'header
X-API-KEY. Vedi Autenticazione. - Il mittente deve essere un indirizzo sul dominio verificato.
- Tieni le credenziali fuori dal codice. Gli esempi le leggono dalle variabili d'ambiente
MAILIQO_SMTP_USER,MAILIQO_SMTP_PASSeMAILIQO_API_KEY.
SMTP è il modo più rapido per collegare un'applicazione che già invia email. L'API restituisce il risultato per destinatario e uno uuid per seguire la consegna. Vedi Panoramica SMTP e API di invio email.
SMTP
Node.js (Nodemailer)
npm install nodemailerimport nodemailer from 'nodemailer';
const transporter = nodemailer.createTransport({
host: 'smtpmq.mailiqo.com',
port: 587,
secure: false,
requireTLS: true,
auth: {
user: process.env.MAILIQO_SMTP_USER,
pass: process.env.MAILIQO_SMTP_PASS,
},
});
const info = await transporter.sendMail({
from: '"Il tuo negozio" <[email protected]>',
to: '[email protected]',
subject: 'Il tuo ordine è stato spedito',
text: 'Il tuo ordine è in viaggio.',
html: '<p>Il tuo ordine è in viaggio.</p>',
});
console.log(info.messageId);secure: false con requireTLS: true fa sì che Nodemailer aggiorni la connessione con STARTTLS e fallisca se non ci riesce. Per la porta 465, usa port: 465 e secure: true.
PHP (PHPMailer)
composer require phpmailer/phpmailer<?php
use PHPMailer\PHPMailer\Exception;
use PHPMailer\PHPMailer\PHPMailer;
require 'vendor/autoload.php';
$mail = new PHPMailer(true);
try {
$mail->isSMTP();
$mail->Host = 'smtpmq.mailiqo.com';
$mail->Port = 587;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth = true;
$mail->Username = getenv('MAILIQO_SMTP_USER');
$mail->Password = getenv('MAILIQO_SMTP_PASS');
$mail->CharSet = PHPMailer::CHARSET_UTF8;
$mail->setFrom('[email protected]', 'Il tuo negozio');
$mail->addAddress('[email protected]');
$mail->isHTML(true);
$mail->Subject = 'Il tuo ordine è stato spedito';
$mail->Body = '<p>Il tuo ordine è in viaggio.</p>';
$mail->AltBody = 'Il tuo ordine è in viaggio.';
$mail->send();
} catch (Exception $e) {
echo $mail->ErrorInfo;
}Per la porta 465, usa $mail->Port = 465 e PHPMailer::ENCRYPTION_SMTPS.
Laravel
In .env:
MAIL_MAILER=smtp
MAIL_SCHEME=smtp
MAIL_HOST=smtpmq.mailiqo.com
MAIL_PORT=587
MAIL_USERNAME=your-smtp-username
MAIL_PASSWORD=your-smtp-password
MAIL_FROM_ADDRESS[email protected]
MAIL_FROM_NAME="Il tuo negozio"Con MAIL_SCHEME=smtp e porta 587, Laravel aggiorna la connessione con STARTTLS. Per la porta 465, usa MAIL_PORT=465 e MAIL_SCHEME=smtps. Su Laravel 10, usa MAIL_ENCRYPTION=tls al posto di MAIL_SCHEME.
use Illuminate\Support\Facades\Mail;
Mail::raw('Il tuo ordine è in viaggio.', function ($message) {
$message->to('[email protected]')->subject('Il tuo ordine è stato spedito');
});In un'applicazione reale invieresti di norma un Mailable; la configurazione SMTP è la stessa. Se la configurazione è in cache, esegui php artisan config:cache dopo aver modificato .env.
Symfony Mailer
composer require symfony/mailerIn .env.local:
MAILER_DSN=smtp://USERNAME:[email protected]:587?require_tls=trueSe il nome utente o la password contengono caratteri speciali, codificali in URL. Per la porta 465, usa smtps://USERNAME:[email protected]:465.
use Symfony\Component\Mailer\MailerInterface;
use Symfony\Component\Mime\Email;
final class OrderMailer
{
public function __construct(private MailerInterface $mailer)
{
}
public function sendShipped(string $to): void
{
$email = (new Email())
->from('[email protected]')
->to($to)
->subject('Il tuo ordine è stato spedito')
->text('Il tuo ordine è in viaggio.')
->html('<p>Il tuo ordine è in viaggio.</p>');
$this->mailer->send($email);
}
}Se la tua applicazione usa Messenger, Symfony mette l'email in coda per impostazione predefinita e il worker la invia, quindi gli errori SMTP compaiono nel worker.
Python (smtplib)
import os
import smtplib
import ssl
from email.message import EmailMessage
msg = EmailMessage()
msg['From'] = 'Il tuo negozio <[email protected]>'
msg['To'] = '[email protected]'
msg['Subject'] = 'Il tuo ordine è stato spedito'
msg.set_content('Il tuo ordine è in viaggio.')
msg.add_alternative('<p>Il tuo ordine è in viaggio.</p>', subtype='html')
context = ssl.create_default_context()
with smtplib.SMTP('smtpmq.mailiqo.com', 587, timeout=30) as server:
server.starttls(context=context)
server.login(os.environ['MAILIQO_SMTP_USER'], os.environ['MAILIQO_SMTP_PASS'])
server.send_message(msg)Per la porta 465, usa smtplib.SMTP_SSL('smtpmq.mailiqo.com', 465, context=context) e rimuovi la chiamata a starttls().
API
POST https://api.mailiqo.com/v1/mailing/send con l'email in JSON. Tutti i campi sono descritti in POST /mailing/send.
curl -X POST https://api.mailiqo.com/v1/mailing/send \
-H "X-API-KEY: $MAILIQO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "[email protected]",
"to": "[email protected]",
"subject": "Il tuo ordine è stato spedito",
"body_html": "<p>Il tuo ordine è in viaggio.</p>",
"body_txt": "Il tuo ordine è in viaggio."
}'const response = await fetch('https://api.mailiqo.com/v1/mailing/send', {
method: 'POST',
headers: {
'X-API-KEY': process.env.MAILIQO_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
from: '[email protected]',
to: '[email protected]',
subject: 'Il tuo ordine è stato spedito',
body_html: '<p>Il tuo ordine è in viaggio.</p>',
body_txt: 'Il tuo ordine è in viaggio.',
}),
});
const result = await response.json();
console.log(response.status, result.status);<?php
$payload = [
'from' => '[email protected]',
'to' => '[email protected]',
'subject' => 'Il tuo ordine è stato spedito',
'body_html' => '<p>Il tuo ordine è in viaggio.</p>',
'body_txt' => 'Il tuo ordine è in viaggio.',
];
$ch = curl_init('https://api.mailiqo.com/v1/mailing/send');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-API-KEY: ' . getenv('MAILIQO_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode($payload),
]);
$result = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);// config/services.php: 'mailiqo' => ['key' => env('MAILIQO_API_KEY')],
use Illuminate\Support\Facades\Http;
$response = Http::withHeaders([
'X-API-KEY' => config('services.mailiqo.key'),
])->post('https://api.mailiqo.com/v1/mailing/send', [
'from' => '[email protected]',
'to' => '[email protected]',
'subject' => 'Il tuo ordine è stato spedito',
'body_html' => '<p>Il tuo ordine è in viaggio.</p>',
'body_txt' => 'Il tuo ordine è in viaggio.',
]);
$result = $response->json();use Symfony\Component\DependencyInjection\Attribute\Autowire;
use Symfony\Contracts\HttpClient\HttpClientInterface;
final class MailiqoClient
{
public function __construct(
private HttpClientInterface $httpClient,
#[Autowire(env: 'MAILIQO_API_KEY')] private string $apiKey,
) {
}
public function send(array $email): array
{
$response = $this->httpClient->request('POST', 'https://api.mailiqo.com/v1/mailing/send', [
'headers' => ['X-API-KEY' => $this->apiKey],
'json' => $email,
]);
return $response->toArray(false);
}
}import os
import requests
response = requests.post(
'https://api.mailiqo.com/v1/mailing/send',
headers={'X-API-KEY': os.environ['MAILIQO_API_KEY']},
json={
'from': '[email protected]',
'to': '[email protected]',
'subject': 'Il tuo ordine è stato spedito',
'body_html': '<p>Il tuo ordine è in viaggio.</p>',
'body_txt': 'Il tuo ordine è in viaggio.',
},
timeout=30,
)
result = response.json()Un 200 significa che l'email è stata messa in coda: controlla status e, se è warning, la lista rejected_recipients. Vedi API di invio email.
Errori e limiti di invio
API
| HTTP | Cosa fare |
|---|---|
200 | In coda. Con status = warning, alcuni destinatari sono stati rifiutati: controlla rejected_recipients. |
400 | Correggi la richiesta: error.code indica il motivo. Vedi Errori. |
401 | Controlla l'API key. |
429 | Limite di invio raggiunto (codice 1421). Aspetta i secondi indicati nell'header Retry-After e invia di nuovo. |
500 | Riprova più tardi. |
Una richiesta rifiutata con 429 non viene messa in coda: la tua applicazione deve inviarla di nuovo una volta trascorso il tempo di Retry-After. Vedi Limiti di invio.
SMTP
Le risposte che iniziano per 4 sono temporanee, come 451 4.7.1 quando viene raggiunto il limite di invio: il server non ha accettato il messaggio, quindi invialo di nuovo più tardi. Le risposte che iniziano per 5 sono permanenti: inviare di nuovo lo stesso messaggio fallisce finché non risolvi la causa. Vedi Errori SMTP.
Dove ogni libreria ti dà la risposta del server:
| Libreria | Dove |
|---|---|
| Nodemailer | err.responseCode e err.response |
| PHPMailer | $mail->ErrorInfo |
| Laravel e Symfony Mailer | Il messaggio della TransportException |
| Python | smtp_code e smtp_error di smtplib.SMTPResponseException e delle sue sottoclassi |
Fonti
Verificate il 2 novembre 2026:
- Nodemailer — SMTP transport — documentazione di Nodemailer
- PHPMailer — repository ufficiale
- Laravel — Mail — documentazione di Laravel
- Symfony — Sending emails with Mailer — documentazione di Symfony
- smtplib — documentazione di Python
Prossimi passi
- API di invio email → /it/api-reference/sending
- Errori SMTP → /it/smtp/errors
