Aller au contenu

Bien démarrer

Démarrage rapide

Envoyez votre premier code de vérification par WhatsApp, puis vérifiez-le, en cinq minutes.

Flare envoie des codes de vérification (OTP, pour one-time password) et des notifications par WhatsApp, à partir d'une simple requête HTTP. Vos clients reçoivent un message WhatsApp ordinaire ; votre application suit chaque message en temps réel.

Toute l'API tient dans quelques routes, sous https://flare.zola-labs.com/v1. Elle reçoit et renvoie du JSON.

1. Créez votre compte et une clé

  1. Créez un compte sur https://flare.zola-labs.com/app/register. C'est gratuit et aucun moyen de paiement n'est demandé.
  2. Dans l'espace client, ouvrez Configurer › Clés d'API et cliquez sur Nouvelle clé.
  3. Copiez la clé affichée (elle commence par flr_live_). Elle n'est montrée qu'une seule fois : rangez-la dans une variable d'environnement de votre serveur.

Note : avant d'écrire la moindre ligne de code, vous pouvez vous envoyer un vrai code depuis Envoyer › Essayer, dans l'espace client.

2. Envoyez un code

curl https://flare.zola-labs.com/v1/otp/send \
  -H "Authorization: Bearer flr_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"to": "+237699001122"}'

Flare génère le code, l'envoie et répond aussitôt, avant même la livraison :

JSON
{
  "id": "01JD3ZQ7V9K2M4N6P8R0T2V4X6",
  "to": "+237699001122",
  "status": "pending",
  "delivery": "queued",
  "reference": null,
  "expires_at": "2026-11-17T09:46:00+00:00",
  "verified_at": null,
  "message_id": "01JD3ZQ7W1A3C5E7G9J1L3N5P7"
}

Conservez l'id : il sert à vérifier le code. Votre utilisateur reçoit dans WhatsApp :

Texte
482913 est votre code de vérification Ma Boutique.

Il expire dans 5 minutes. Ne le partagez avec personne.

3. Vérifiez le code saisi

curl https://flare.zola-labs.com/v1/otp/verify \
  -H "Authorization: Bearer flr_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"id": "01JD3ZQ7V9K2M4N6P8R0T2V4X6", "code": "482913"}'
JSON
{
  "id": "01JD3ZQ7V9K2M4N6P8R0T2V4X6",
  "valid": true,
  "status": "verified",
  "attempts_left": 4
}

C'est tout. Le code est maintenant consommé : il ne pourra plus être utilisé.

Et ensuite ?

  • Authentification : gérer vos clés et les limites de l'API.
  • Codes OTP : toutes les options (longueur, durée, langue) et les bonnes pratiques.
  • Notifications : prévenir vos clients, votre équipe ou un partenaire à chaque événement de votre application.
  • Webhooks : être prévenu en temps réel de la livraison de chaque message.
  • Numéros : envoyer depuis les numéros Flare ou depuis votre propre numéro.