Skip to content

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, porta 587 con STARTTLS (o 465 con 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_PASS e MAILIQO_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) ​

bash
npm install nodemailer
js
import 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) ​

bash
composer require phpmailer/phpmailer
php
<?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:

ini
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.

php
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 ​

bash
composer require symfony/mailer

In .env.local:

ini
MAILER_DSN=smtp://USERNAME:[email protected]:587?require_tls=true

Se il nome utente o la password contengono caratteri speciali, codificali in URL. Per la porta 465, usa smtps://USERNAME:[email protected]:465.

php
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) ​

python
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.

bash
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."
  }'
js
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
<?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);
php
// 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();
php
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);
    }
}
python
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 ​

HTTPCosa fare
200In coda. Con status = warning, alcuni destinatari sono stati rifiutati: controlla rejected_recipients.
400Correggi la richiesta: error.code indica il motivo. Vedi Errori.
401Controlla l'API key.
429Limite di invio raggiunto (codice 1421). Aspetta i secondi indicati nell'header Retry-After e invia di nuovo.
500Riprova 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:

LibreriaDove
Nodemailererr.responseCode e err.response
PHPMailer$mail->ErrorInfo
Laravel e Symfony MailerIl messaggio della TransportException
Pythonsmtp_code e smtp_error di smtplib.SMTPResponseException e delle sue sottoclassi

Fonti ​

Verificate il 2 novembre 2026:


Prossimi passi ​

Built with VitePress