Passer au contenu principal
Deux écrans relient Lekalao à vos autres applications : Jetons d’API pour qu’elles appellent Lekalao, Webhooks sortants pour que Lekalao les appelle.

​
Jetons d’API

Paramètres → Jetons d’API → Nouveau jeton.
1

Nommez-le

Par application qui s’en sert : « Boutique en ligne », « CRM ». Vous saurez quoi révoquer le jour où l’une d’elles est compromise.
2

Choisissez ce qu'il peut faire

Lecture : consulter listes, abonnés, campagnes, statistiques. Lecture et écriture : aussi créer, modifier, supprimer et envoyer. Donnez le minimum.
3

Réel ou de test

Activez Clé de test pour un jeton qui n’envoie rien : les e-mails transactionnels sont journalisés sans atteindre un fournisseur, les campagnes ne peuvent pas partir, rien ne compte dans le quota. Il porte un badge Test dans la liste. Voir Clés de test.
4

Copiez-le tout de suite

Votre nouveau jeton s’affiche une seule fois. Rangez-le dans les secrets de l’application (variable d’environnement, coffre), jamais dans le code.
La liste montre chaque jeton, ce qu’il peut faire, sa création et sa Dernière utilisation. Révoquer le coupe immédiatement. Un jeton travaille pour l’équipe dans laquelle il a été créé, même si vous passez ensuite à une autre dans le navigateur. Il agit avec vos droits dans cette équipe : si vous devenez lecteur, il ne peut plus écrire ; si vous la quittez, il ne fonctionne plus.
Un jeton Lecture et écriture sert aussi de mot de passe pour le relais SMTP.
Paramètres → Documentation donne l’adresse de votre API et un premier appel prêt à copier. La suite est dans l’onglet Développeurs.

​
Webhooks sortants

Lekalao envoie une requête POST signée à vos adresses quand quelque chose se passe. Paramètres → Webhooks sortants → Nouvelle adresse :
​
texte
requis
Pour la reconnaître : « Boutique en ligne ».
​
URL
requis
Une adresse publique en https://. Les adresses internes (localhost, réseau privé) sont refusées.
​
cases à cocher
requis
En trois groupes, chacun avec son nom en code dessous.Abonnés
  • Un abonné est créé (subscriber.created)
  • Un abonné confirme (subscriber.confirmed)
  • Un abonné se désabonne (subscriber.unsubscribed)
  • Un tag est ajouté (subscriber.tag_added)
  • Un tag est retiré (subscriber.tag_removed)
Campagnes et e-mails
  • Une campagne est envoyée (campaign.sent)
  • Un e-mail rebondit (mail.bounced)
  • Quelqu’un signale un e-mail comme spam (mail.complaint)
E-mails transactionnels
  • Un e-mail transactionnel est remis au fournisseur (transactional.sent)
  • Un e-mail transactionnel est délivré (transactional.delivered)
  • Un e-mail transactionnel rebondit (transactional.bounced)
  • Un e-mail transactionnel est signalé comme spam (transactional.complained)
  • Un e-mail transactionnel est ouvert (transactional.opened)
  • Un lien d’un e-mail transactionnel est cliqué (transactional.clicked)
  • Un e-mail transactionnel n’a pas pu partir (transactional.failed)
​
liste
Toutes les listes par défaut, ou une seule.
​
interrupteur
Désactivez-le pour garder les réglages sans être appelé.

​
Le secret de signature

Chaque adresse a son Secret de signature, affiché sous elle avec un bouton pour le copier. Chaque appel porte l’en-tête Lekalao-Signature calculé avec ce secret et l’heure de l’appel : votre application doit le vérifier, et refuser un appel signé il y a plus de cinq minutes, avant de le croire. Le code est dans Webhooks.

​
Appels que nous avons faits

Le journal liste chaque appel : date, adresse, événement, statut. Un appel qui échoue est retenté de lui-même, après 1 minute, 5, 30, 2 heures, 6 et 12 : pendant qu’il attend, son statut est Nouvelle tentative prévue. Ouvrez une ligne pour voir son Identifiant de l’événement, la prochaine tentative, les Tentatives faites avec le code de votre serveur et la durée de chacune, le Contenu envoyé et la Réponse de votre serveur ; Renvoyer rappelle une fois de plus, tout de suite.
Une adresse en échec 3 jours d’affilée, sans un seul succès, affiche En échec depuis le entre-temps, puis est Désactivée : Lekalao cesse de l’appeler, et les propriétaires de l’équipe reçoivent un e-mail. Réparez votre serveur, puis rallumez Appeler cette adresse et renvoyez les appels manqués.
Une réponse est un succès si votre serveur répond un code 2xx dans les 15 secondes. Les redirections ne sont pas suivies.

​
Retours des fournisseurs

À ne pas confondre : Paramètres → Retours des fournisseurs liste les appels reçus de vos fournisseurs d’envoi (rebonds, plaintes, livraisons). Voir Retours des fournisseurs.