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é
- Créez un compte sur https://flare.zola-labs.com/app/register. C'est gratuit et aucun moyen de paiement n'est demandé.
- Dans l'espace client, ouvrez Configurer › Clés d'API et cliquez sur Nouvelle clé.
- 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"}'
$response = Http::withToken(env('FLARE_KEY'))
->post('https://flare.zola-labs.com/v1/otp/send', [
'to' => '+237699001122',
]);
$otpId = $response->json('id');
const response = await fetch('https://flare.zola-labs.com/v1/otp/send', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.FLARE_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ to: '+237699001122' }),
});
const { id: otpId } = await response.json();
import os, requests
response = requests.post(
"https://flare.zola-labs.com/v1/otp/send",
headers={"Authorization": f"Bearer {os.environ['FLARE_KEY']}"},
json={"to": "+237699001122"},
)
otp_id = response.json()["id"]
Flare génère le code, l'envoie et répond aussitôt, avant même la livraison :
{
"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 :
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"}'
$result = Http::withToken(env('FLARE_KEY'))
->post('https://flare.zola-labs.com/v1/otp/verify', [
'id' => $otpId,
'code' => $request->input('code'),
]);
if ($result->json('valid')) {
// Le numéro est vérifié : connectez l'utilisateur.
}
const result = await fetch('https://flare.zola-labs.com/v1/otp/verify', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.FLARE_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ id: otpId, code: req.body.code }),
}).then((r) => r.json());
if (result.valid) {
// Le numéro est vérifié : connectez l'utilisateur.
}
result = requests.post(
"https://flare.zola-labs.com/v1/otp/verify",
headers={"Authorization": f"Bearer {os.environ['FLARE_KEY']}"},
json={"id": otp_id, "code": submitted_code},
).json()
if result["valid"]:
pass # Le numéro est vérifié : connectez l'utilisateur.
{
"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.