Une API simple, en français, pour vos sites, logiciels de caisse et CRM. Votre compte et votre clé en quelques minutes, sans attendre personne. Votre équipe garde l'interface FChat : chaque envoi de votre logiciel apparaît dans la conversation.
Quatre étapes, toutes faites par vous en ligne. Il vous faut un numéro WhatsApp Business relié à votre espace (l'assistant de FChat vous guide à la création).
Votre entreprise, votre e-mail, un mot de passe. Un code arrive par WhatsApp et par e-mail : saisissez-le, l'espace est créé.
Créer le compteDans FChat : Réglages › Administration › API et développeurs, puis l'interrupteur « API ». Le prix s'affiche avant de confirmer.
Se connecter« Nouvelle clé », un nom (ex. : site web). La clé fck_live_… s'affiche une seule fois : copiez-la dans la configuration de votre serveur.
Vérifiez la clé, puis envoyez votre premier message. Le webhook (facultatif) reçoit les réponses de vos clients.
Voir le code# Vérifier la clé curl https://europe-west1-fchat-elako.cloudfunctions.net/api/v1/moi \ -H "X-Api-Key: fck_live_VOTRE_CLE" # Envoyer un message curl -X POST https://europe-west1-fchat-elako.cloudfunctions.net/api/v1/messages \ -H "X-Api-Key: fck_live_VOTRE_CLE" -H "Content-Type: application/json" \ -d '{"telephone":"243812345678","texte":"Bonjour, votre commande est prête."}'
const base = 'https://europe-west1-fchat-elako.cloudfunctions.net/api/v1'; const entetes = { 'X-Api-Key': process.env.FCHAT_CLE, 'Content-Type': 'application/json' }; const r = await fetch(`${base}/messages`, { method: 'POST', headers: entetes, body: JSON.stringify({ telephone: '243812345678', texte: 'Bonjour, votre commande est prête.' }), }); console.log(await r.json()); // { ok: true, id: "…", conversationId: "243812345678", statut: "pending" }
$ch = curl_init('https://europe-west1-fchat-elako.cloudfunctions.net/api/v1/messages'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('FCHAT_CLE'), 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode(['telephone' => '243812345678', 'texte' => 'Bonjour, votre commande est prête.']), ]); $reponse = json_decode(curl_exec($ch), true);
import os, requests r = requests.post( "https://europe-west1-fchat-elako.cloudfunctions.net/api/v1/messages", headers={"X-Api-Key": os.environ["FCHAT_CLE"]}, json={"telephone": "243812345678", "texte": "Bonjour, votre commande est prête."}, ) print(r.json())
Règle de Meta : un message libre n'est accepté que dans les 24 heures suivant le dernier message du client. Au-delà, envoyez un modèle approuvé.
Adresse de base : https://europe-west1-fchat-elako.cloudfunctions.net/api/v1. Authentification par l'en-tête X-Api-Key (ou Authorization: Bearer). Les numéros s'écrivent au format international, en chiffres : 243812345678 ; l'identifiant d'une conversation est ce numéro.
L'entreprise, son numéro WhatsApp et la clé utilisée. Idéal pour tester la configuration.
Les conversations, les plus récentes d'abord : id, nom, telephone, apercu, derniereActivite, nonLus, ville. Pagination : repassez suivant dans avant.
Les messages d'une conversation : sens (entrant ou sortant), type, texte, statut, le (millisecondes), media.
Corps : telephone, texte (4 096 caractères au plus), nom facultatif. Crée la conversation si elle n'existe pas.
Corps : telephone, modele (nom exact du modèle approuvé, visible dans FChat › Modèles), langue (fr par défaut), variables : les valeurs de {{1}}, {{2}}… dans l'ordre.
Lister les contacts, ou créer et compléter un contact : telephone, nom, entreprise, ville.
Toute réponse porte ok. En cas d'erreur : { "ok": false, "erreur": "…" }, avec un message qui dit quoi corriger.
| Code | Signification |
|---|---|
| 200 / 201 | Réussi (201 : message ou contact créé) |
| 400 | Paramètre manquant ou mal formé |
| 401 | Clé absente, inconnue ou révoquée |
| 403 | API non active pour l'entreprise, ou application bloquée |
| 404 | Adresse inconnue |
| 429 | Plus de 60 requêtes par minute avec la même clé : réessayez une minute plus tard |
Renseignez l'adresse https de votre serveur dans API et développeurs. Chaque message reçu par votre numéro y est envoyé en POST JSON, signé avec votre secret whsec_… dans l'en-tête X-Signature.
{
"type": "message.recu",
"conversationId": "243812345678",
"telephone": "243812345678",
"nom": "Jean K.",
"message": { "id": "wamid…", "type": "text", "texte": "Bonjour", "le": 1763251200000 },
"envoyeLe": 1763251201000
}const crypto = require('crypto'); // corpsBrut : le corps EXACT reçu (avant tout JSON.parse) const attendu = 'sha256=' + crypto.createHmac('sha256', SECRET).update(corpsBrut).digest('hex'); const valide = crypto.timingSafeEqual(Buffer.from(attendu), Buffer.from(req.headers['x-signature'] || ''));
$corps = file_get_contents('php://input'); $attendu = 'sha256=' . hash_hmac('sha256', $corps, $secret); $valide = hash_equals($attendu, $_SERVER['HTTP_X_SIGNATURE'] ?? '');
import hmac, hashlib attendu = "sha256=" + hmac.new(SECRET.encode(), corps_brut, hashlib.sha256).hexdigest() valide = hmac.compare_digest(attendu, request.headers.get("X-Signature", ""))
Répondez en moins de 4 secondes avec un code 2xx. Un échec est signalé dans FChat (API et développeurs). « Nouveau secret » en crée un autre si le vôtre a fuité.
L'abonnement API remplace l'abonnement FChat habituel : l'interface complète reste incluse pour votre équipe. Les messages WhatsApp sont facturés par Meta selon sa grille.
jusqu'à 5 utilisateurs, puis 3 USD par utilisateur supplémentaire.
Non. Vous créez votre compte en ligne, vous activez l'API et vous créez vos clés vous-même, depuis FChat web.
Oui, pour envoyer. FChat vous guide pour relier votre numéro WhatsApp Business par l'API officielle de Meta ; la lecture des conversations et la création des clés fonctionnent dès l'activation.
Le plus souvent : hors de la fenêtre de 24 heures de Meta. Envoyez un modèle approuvé avec /messages/modele. Le motif exact s'affiche dans la conversation, dans FChat.
Une clé ne se retrouve pas : révoquez-la dans « API et développeurs » et créez-en une nouvelle. La révocation est immédiate.
Dans FChat, la conversation du client : chaque envoi porte la mention « API » et le nom de la clé.