Base de connaissances

Ce guide concerne les jetons d'authentification ou tokens Infomaniak, qui servent à vérifier l'identité de l'application et à lui accorder des autorisations spécifiques pour interagir avec les fonctionnalités et les données de l'API Infomaniak de manière sécurisée.

Préambule

• Les jetons d'authentification ou tokens servent à vérifier l'identité de l'application et à lui accorder des autorisations spécifiques pour interagir avec les fonctionnalités et les données de l'API Infomaniak de manière sécurisée.
• Il n'y a pas de limite quant au nombre de token que vous pouvez créer.
• La durée dun token d'accès est "illimitée" par défaut mais il est possible de définir une durée personnalisée à sa création.
• Attention, si aucun appel n'est fait avec le token pendant une année, il est automatiquement désactivé ; il sera alors nécessaire d'en générer un nouveau.

Gérer les token API Infomaniak

Au moment de la création d'un token API, il vous sera possible de choisir l'application et le scope accessible par le token (afin de correspondre à votre besoin et projet actuel).

Pour cela:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez le bouton bleu Créer un token.
3. Choisissez dans le menu déroulant le produit adéquat selon votre besoin et projet actuel.
4. Choisissez une durée de validité.
5. Cliquez sur le bouton bleu Créer un token.
6. Entrez le mot de passe de connexion au Manager comme demandé.
7. Copiez le token en lieu sûr - il ne sera plus accessible après cela.

Exemple d'application: token pour l'API Newsletter

Ce guide concerne la gestion des formulaires qui permettent l'inscription à la Newsletter que vous gérez sur Infomaniak.

Prérequis

• Avoir l'accès au produit Newsletter.
• Avoir créé au minimum un formulaire d'inscription.

Copier le code nécessaire à l'intégration du formulaire

Pour accéder aux formulaires de votre Newsletter et obtenir le code d'intégration:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom de domaine attribué au produit concerné.
3. Cliquez sur Formulaires dans le menu latéral gauche.
4. Cliquez sur le menu d'action ⋮ à droite de l'objet concerné dans le tableau qui s'affiche.
5. Cliquez sur Code d'intégration:
   
6. Choisissez entre l'onglet JAVASCRIPT et HTML pour obtenir l'un des deux types de codes utile à l'insertion de votre formulaire sur vos pages et cliquez sur le bouton bleu pour copier le code dans le presse-papiers:
   

Insérer le formulaire sur un site Web…

Vous pouvez insérer le même formulaire à différents endroits. Vous pouvez également créer plusieurs formulaires (pour peupler différents groupes de contacts p.ex). Évidemment une Newsletter n'est envoyée qu'une seule fois par contact, même si celui-ci est présent dans différentes listes/groupes:

… sur WordPress

1. Insérez à l'endroit désiré un nouveau bloc.
2. Choisissez un bloc de type HTML:
   
3. Collez le code HTML obtenu au point 6 ci-dessus (passez de l'onglet Javascript à l'onglet HTML pour afficher le code correspondant à votre formulaire).
4. Cliquez sur Mettre à jour.
5. Le formulaire configuré précédemment s'affiche sur votre site.

… sur Site Creator Infomaniak

1. Survolez l'emplacement désiré sur la page pour faire apparaitre un bouton PLUS permettant d'ajouter un bloc:
   
2. Cliquez sur le bouton PLUS pour choisir un bloc de code HTML personnalisé:
   
3. Collez le code HTML obtenu au point 6 ci-dessus (passez de l'onglet Javascript à l'onglet HTML pour afficher le code correspondant à votre formulaire):
   
4. Cliquez sur le bouton bleu pour Continuer et prévisualiser votre formulaire sur votre page:
   
5. Le formulaire configuré précédemment s'affiche sur votre site:
   
    

… sur une offre Starter - page Web basique

1. Ouvrez Web FTP sur l'hébergement Starter:
   
2. Éditez la page d'accueil index.html et collez le code HTML obtenu au point 6 ci-dessus (passez de l'onglet Javascript à l'onglet HTML pour afficher le code correspondant à votre formulaire), avant de sauvegarder:
   
3. Le formulaire configuré précédemment s'affiche sur votre site:
   

Ce guide explique comment être averti par mail lorsqu'un nouvel abonné rejoint votre Newsletter via l'un de vos formulaires de contact.

Être notifié lors de l'abonnement d'un nouveau contact

Pour accéder à votre Newsletter :

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez si nécessaire sur le nom du domaine concerné dans le tableau qui s'affiche.
3. L'interface de la Newsletter s'affiche.

Ensuite, pour accéder au formulaire d'inscription Newsletter :

1. Cliquez sur Formulaires dans le menu latéral gauche.
2. Créez ou éditez le formulaire dont vous souhaitez suivre les inscriptions:
   
3. Tout en bas de la page, cochez la case Recevoir un mail lors d'une nouvelle inscription.
4. Cliquez sur le bouton bleu Enregistrer pour valider les modifications:
   

Vous recevrez* désormais un e-mail dès qu'un contact s'abonne à votre Newsletter via ce formulaire d'inscription. Il suffit de décocher la case en tout temps pour ne plus être notifié par mail.

* Tous les utilisateurs de l'Organisation ayant le rôle administrateur ou supérieur recoivent les notifications à partir du moment où ceux-ci ont activé l'option “Autoriser la réception (mail) des événements relatifs aux produits” présente dans la gestion des utilisateurs de l'Organisation

Ce guide concerne l’outil de Newsletter Infomaniak qui propose des rapports détaillés pour mesurer précisément l’impact de vos envois.

Préambule

• Faites connaissance avec les personnes qui vous suivent:
  • Découvrez sur une carte du monde où se trouvent vos abonnés (géolocalisation) et quels appareils ils utilisent pour lire vos messages (appareils mobiles, ordinateurs, etc.). Ces informations vous permettent de mieux connaître vos contacts et d’adapter le contenu de vos newsletters en conséquence.
• Suivez l’activité de vos newsletters:
  • En un coup d’oeil, affichez toutes les données importantes pour mesurer la qualité et la portée de vos campagnes d’e-mailing: le taux d’ouverture unique, le taux de désabonnements et le nombre d’adresses email invalides (bounce).
• Découvrez ce qui intéresse (vraiment) vos abonnés:
  • Mesurez facilement l’intérêt de vos destinataires en consultant les statistiques des liens. Vous pourrez ainsi voir précisément combien de personnes uniques ont cliqué sur les liens de vos newsletters et savoir ce qui intéresse le plus vos abonnés.

Accéder au tableau de bord Newsletter

Le tableau de bord offre une vue rapide sur l'évolution de vos campagnes depuis le début avec des statistiques mensuelles:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez si nécessaire sur le nom du domaine concerné dans le tableau qui s'affiche.
3. Cliquez sur Tableau de bord dans le menu latéral gauche:
   

Accéder aux rapports des précédents envois

Pour voir les rapports détaillés de chaque campagne :

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez si nécessaire sur le nom du domaine concerné dans le tableau qui s'affiche.
3. Cliquez sur Campagnes dans le menu latéral gauche.
4. Cliquez sur l'onglet ENVOYÉES.
5. Cliquez sur le bouton VOIR LE RAPPORT.