Base de connaissances

Ce guide explique comment copier par IMAP le contenu d'une ou plusieurs adresses mail externes (tous les messages e-mails, dossiers, sous-dossiers, bref, toute l'arborescence de votre boite mail existante chez d'autres fournisseurs) sur une ou plusieurs autres de vos adresses existantes chez Infomaniak, grâce à l'outil d'importation Infomaniak !

Préambule

• L'opération n'affecte ni les données déjà présentes sur l'adresse de destination, ni celles de l'adresse source.
• La totalité de la boite externe sera importée.
• Une fois le processus d'importation démarré, il n'est plus possible de l'interrompre.
• Les éventuels doublons sont gérés: un contenu identique ne sera copié qu'une seule fois.
• Prenez connaissance de cet autre guide si vous recherchez des alternatives à ce processus par IMAP.

Copier les e-mails d'un autre fournisseur sur Infomaniak

Prérequis

• Posséder un Service Mail sur votre Manager Infomaniak.
• Disposer d'un quota d'adresses libres à disposition ou l'ajuster au préalable si nécessaire.
• S'assurer que la messagerie est correctement sécurisée
• Créer une ou plusieurs adresses sur ce Service Mail.
• L'adresse mail de destination doit être rattachée à l'utilisateur (= au compte Infomaniak) que vous utilisez (ce n'est pas un prérequis pour l'importation en masse expliquée plus bas).
• L'adresse mail source, dont il faut copier le contenu, doit avoir été utilisée (ou être compatible) avec le protocole IMAP:
  

Ensuite, pour importer le contenu mail :

1. Cliquez ici afin d'accéder à l'outil d'importation (service en ligne https://import-email.infomaniak.com).
2. Si nécessaire connectez-vous à votre compte Infomaniak sur l'Organisation concernée ; en effet l'importation se fera vers l'une des adresses mail rattachées à l'interface Web Mail Infomaniak (service en ligne ksuite.infomaniak.com/mail) du compte Infomaniak que vous utilisez.
3. Cliquez sur l'importation par IMAP.
4. Cliquez sur l'importation unique.
5. Remplissez le champ de gauche avec votre adresse mail de départ (dont le contenu est à copier).
6. Remplissez le champ de droite avec le mot de passe de cette même adresse mail source (cf prérequis).
7. Modifiez si nécessaire les Paramètres avancés afin de spécifier une adresse de serveur IMAP:
   1. Entrez le nom de serveur IMAP (nom d'hôte fourni par votre fournisseur de messagerie) par exemple imap.domain.ch (ou .net, .com etc. en fonction de votre adresse mail au pt 5 ci-dessus).
   2. Entrez le numéro de port (par défaut 993) et le SSL.
8. Cliquez sur Confirmer:
   
9. Si nécessaire inscrivez une seconde adresse mail destinée à être importée en même temps.
10. Choisissez sur quelle adresse mail importer les e-mails ; le menu déroulant vous liste les adresses mail actuellement rattachées à votre interface Web Mail Infomaniak (service en ligne ksuite.infomaniak.com/mail) du compte Infomaniak avec lequel vous êtes connecté.
11. Après avoir sélectionné dans la liste l'adresse de destination désirée, cliquez sur le bouton bleu Importer les e-mails:
    
12. La copie débute, vous pouvez attendre et voir le résultat sur la page une fois l'import terminé, ou fermer la fenêtre (l'importation continue en arrière-plan et un suivi est disponible - lire ci-dessous):
    
13. Un e-mail de confirmation sera automatiquement envoyé à toutes les adresses mail concernées par l'opération une fois l'importation terminée, mentionnant le nombre de messages copiés:
    
14. Un suivi est disponible dans les réglages de l'adresse mail de destination, sur l'app Web Mail (service en ligne ksuite.infomaniak.com/mail) uniquement:
    
15. Le suivi permet de voir l'historique des importations sur l'adresse concernée:
    

Rapatrier le contenu de plusieurs adresses mail par lot

Pour importer le contenu de plusieurs adresses mail externes (maximum 25 par 25) vers une ou plusieurs adresses mail Infomaniak:

1. Cliquez ici afin d'accéder à l'outil d'importation (service en ligne https://import-email.infomaniak.com).
2. Si nécessaire connectez-vous à votre compte Infomaniak sur l'Organisation concernée ; en effet l'importation se fera vers l'une des adresses mail rattachées à l'interface Web Mail Infomaniak (service en ligne ksuite.infomaniak.com/mail) du compte Infomaniak que vous utilisez.
3. Cliquez sur l'importation par IMAP.
4. Cliquez sur le mode avancé: Importer plusieurs adresses mail à partir d'un fichier CSV (format .csv).
5. Téléchargez le modèle CSV proposé en exemple:
   
   • Le modèle est sous cette forme: source-email@domain.com;sourcePassword;imap.source-host.com;sourcePort(993);sourceSsl(1or0);dest-email@domain.com
6. Editez le fichier csv afin d'en créer un avec les bonnes informations nécessaires à la copie (cf prérequis):
   
7. Chargez le fichier grâce au bouton Sélectionner un fichier CSV.
8. Une fois le fichier chargé sur la page de l'outil, corrigez ou ignorez les éventuelles erreurs ; cliquez sur Importer.
9. La copie débute, vous pouvez attendre et voir le résultat sur la page une fois l'import terminé, ou fermer la fenêtre (l'importation continue en arrière-plan et un suivi est disponible - lire ci-dessous).
10. Un e-mail de confirmation sera automatiquement envoyé à toutes les adresses mail concernées par l'opération une fois l'importation terminée, mentionnant le nombre de messages copiés.
11. Un suivi est disponible dans les réglages des adresses mail de destination, sur l'app Web Mail (service en ligne ksuite.infomaniak.com/mail) uniquement.
12. Le suivi permet de voir l'historique des importations:
    

Ce guide explique comment utiliser PHPMailer avec les hébergements Web Infomaniak pour envoyer des e-mails depuis un site Web.

⚠ ATTENTION ⚠‍ 

Infomaniak garantit la conformité de ses services aux protocoles standards (IMAP, S3, etc.) mais ne fournit pas d'aide supplémentaire pour les services ou logiciels externes, car leur configuration peut changer selon le fournisseur ou l'éditeur. Ce guide est donc fourni à titre indicatif et sa mise en place reste sous votre responsabilité (réf.: Politique de support / Art. 11.9 des CGU). Si besoin, une personne qualifiée peut vous accompagner. 

Préambule

• PHPMailer est une librairie PHP permettant de créer et d'envoyer des e-mails depuis un site Web, notamment via SMTP.
• Elle permet notamment d'envoyer des messages au format HTML, d'ajouter une version texte alternative, de gérer les pièces jointes et d'utiliser une authentification SMTP.
• Pour un envoi authentifié via SMTP, l'environnement PHP utilisé par le site doit être compatible avec une connexion chiffrée récente, notamment TLS 1.2 ou supérieur.
  • Une version trop ancienne de PHP ou de la librairie OpenSSL utilisée par PHP peut provoquer une erreur de connexion ou d'authentification, même si l'adresse mail et le mot de passe sont corrects.
  • N'utilisez pas PHP 5.3/5.4 pour ce type d'envoi ; utilisez une version de PHP récente et maintenue.
• Avec l'envoi SMTP authentifié, l'adresse utilisée comme expéditeur doit correspondre à l'adresse mail utilisée pour l'authentification SMTP.

Installer PHPMailer

Pour utiliser PHPMailer, installez la librairie dans les fichiers de votre site Web.

1. Téléchargez PHPMailer depuis son dépôt officiel ou installez-la avec Composer si votre projet l'utilise.
2. Copiez les fichiers de PHPMailer dans un répertoire de votre site Web par FTP.

3. Chargez les fichiers nécessaires dans votre script PHP, en adaptant le chemin selon l'emplacement choisi:

   use PHPMailer\PHPMailer\PHPMailer;
   use PHPMailer\PHPMailer\Exception;
   
   require **DIR** . '/PHPMailer/src/Exception.php';
   require **DIR** . '/PHPMailer/src/PHPMailer.php';
   require **DIR** . '/PHPMailer/src/SMTP.php';

Configurer l'envoi SMTP avec Infomaniak

Utilisez les paramètres SMTP authentifiés suivants:

• Serveur SMTP: mail.infomaniak.com
• Port: 465
• Chiffrement: SMTPS / SSL-TLS
• Authentification: obligatoire
• Nom d'utilisateur: l'adresse mail complète
• Mot de passe: le mot de passe de l'adresse mail utilisée

Exemple de configuration complète:

<?php

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require **DIR** . '/PHPMailer/src/Exception.php';
require **DIR** . '/PHPMailer/src/PHPMailer.php';
require **DIR** . '/PHPMailer/src/SMTP.php';

$mail = new PHPMailer(true);

try {
// Configuration SMTP
$mail->isSMTP();
$mail->Host       = 'mail.infomaniak.com';
$mail->SMTPAuth   = true;
$mail->Username   = '[sender@domain.xyz](mailto:sender@domain.xyz)';
$mail->Password   = 'mot_de_passe_de_l_adresse_mail';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->Port       = 465;
$mail->CharSet    = 'UTF-8';

```
// Expéditeur
// L'adresse doit correspondre à celle utilisée pour l'authentification SMTP.
$mail->setFrom('sender@domain.xyz', 'Nom du site');

// Destinataire
$mail->addAddress('recipient@example.com');

// Adresse de réponse facultative
$mail->addReplyTo('sender@domain.xyz', 'Nom du site');

// Contenu du message
$mail->isHTML(true);
$mail->Subject = 'Message envoyé depuis le site';
$mail->Body    = '<p>Contenu HTML du message.</p>';
$mail->AltBody = 'Contenu texte du message.';

$mail->send();
echo 'Message envoyé';
```

} catch (Exception $e) {
echo 'Le message n'a pas pu être envoyé. Erreur: ' . htmlspecialchars($mail->ErrorInfo);
}

Si votre application impose l'utilisation du port 587, utilisez STARTTLS:

$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port       = 587;

Vérifier la version de PHP et la compatibilité TLS

L'envoi SMTP authentifié nécessite une connexion chiffrée récente. Si le site utilise une version trop ancienne de PHP, par exemple PHP 5.3, ou une librairie OpenSSL trop ancienne, PHPMailer peut échouer avant ou pendant l'authentification. Les erreurs peuvent alors être trompeuses, par exemple:

• SMTP connect() failed
• Could not authenticate
• stream_socket_enable_crypto()
• une erreur d'authentification alors que le mot de passe est correct

Dans ce cas, vérifiez les points suivants:

1. la version de PHP utilisée par le site Web;
2. la version d'OpenSSL utilisée par PHP;
3. la version de PHPMailer utilisée par votre projet;
4. la correspondance entre le port SMTP et le chiffrement choisi.

Pour une configuration fiable, utilisez une version récente de PHP, compatible avec TLS 1.2 ou supérieur, ainsi qu'une version actuelle de PHPMailer. Prenez connaissance de ces guides si nécessaire:

• Modifier la version de PHP d'un site Web
• Résoudre un problème PHP lié à une version obsolète
• Afficher les informations techniques du site

Résoudre une erreur Sender mismatch

L'erreur Sender mismatch SMTP code: 550 Additional SMTP info: 5.7.1 peut se produire lorsque l'adresse utilisée comme expéditeur ne correspond pas à l'adresse mail utilisée pour l'authentification SMTP. Exemple à éviter:

$mail->Username = 'sender@domain.xyz';
$mail->setFrom('another-address@domain.xyz', 'Nom du site');

Dans cet exemple, le script s'authentifie avec sender@domain.xyz, mais tente d'envoyer le message avec une autre adresse d'expéditeur.

Utilisez la même adresse mail pour l'authentification SMTP et pour l'expéditeur:

$mail->Username = 'sender@domain.xyz';
$mail->setFrom('sender@domain.xyz', 'Nom du site');

Le nom d'expéditeur peut être personnalisé, mais l'adresse mail doit rester cohérente avec le compte SMTP utilisé.

Cas d'un formulaire de contact

Si un visiteur renseigne son adresse mail dans un formulaire, ne l'utilisez pas comme adresse d'expéditeur du message. Utilisez l'adresse mail authentifiée comme expéditeur, puis ajoutez l'adresse du visiteur comme adresse de réponse.

Exemple:

$mail->Username = 'sender@domain.xyz';
$mail->setFrom('sender@domain.xyz', 'Formulaire du site');
$mail->addReplyTo($email_visiteur);

Cette configuration permet de répondre au visiteur depuis votre logiciel de messagerie sans envoyer le message avec une adresse d'expéditeur non autorisée.

Activer le mode debug temporairement

En cas d'erreur, activez temporairement le mode debug de PHPMailer afin d'obtenir plus de détails sur la connexion SMTP:

$mail->SMTPDebug = 2;
$mail->Debugoutput = 'html';

Désactivez ce mode après vos tests afin de ne pas afficher d'informations techniques aux visiteurs du site.

En savoir plus

• Mail authentifié (SMTP) depuis un site Web
• Mail non-authentifié via PHP mail()
• Documentation officielle PHPMailer