API officielle de Meta

Envoyez et recevez des messages WhatsApp depuis votre logiciel

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.

Inscription en ligne, vérifiée par code Clés créées par vous-même Webhook signé HMAC-SHA256 35 USD par mois

Démarrer, sans aide

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).

1

Créer le compte

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 compte
2

Activer l'API

Dans FChat : Réglages › Administration › API et développeurs, puis l'interrupteur « API ». Le prix s'affiche avant de confirmer.

Se connecter
3

Créer une clé

« Nouvelle clé », un nom (ex. : site web). La clé fck_live_… s'affiche une seule fois : copiez-la dans la configuration de votre serveur.

4

Premier appel

Vérifiez la clé, puis envoyez votre premier message. Le webhook (facultatif) reçoit les réponses de vos clients.

Voir le code

Premier appel

# 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."}'

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é.

Référence

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.

GET/moi

L'entreprise, son numéro WhatsApp et la clé utilisée. Idéal pour tester la configuration.

GET/conversations?limite=50&avant=…

Les conversations, les plus récentes d'abord : id, nom, telephone, apercu, derniereActivite, nonLus, ville. Pagination : repassez suivant dans avant.

GET/conversations/{id}/messages

Les messages d'une conversation : sens (entrant ou sortant), type, texte, statut, le (millisecondes), media.

POST/messages

Corps : telephone, texte (4 096 caractères au plus), nom facultatif. Crée la conversation si elle n'existe pas.

POST/messages/modele

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.

GET/contacts   POST/contacts

Lister les contacts, ou créer et compléter un contact : telephone, nom, entreprise, ville.

Réponses et erreurs

Toute réponse porte ok. En cas d'erreur : { "ok": false, "erreur": "…" }, avec un message qui dit quoi corriger.

CodeSignification
200 / 201Réussi (201 : message ou contact créé)
400Paramètre manquant ou mal formé
401Clé absente, inconnue ou révoquée
403API non active pour l'entreprise, ou application bloquée
404Adresse inconnue
429Plus de 60 requêtes par minute avec la même clé : réessayez une minute plus tard

Webhook : recevoir les messages entrants

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'] || ''));

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é.

Tarif

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.

35USD / mois

jusqu'à 5 utilisateurs, puis 3 USD par utilisateur supplémentaire.

  • Clés illimitées dans la limite de 10 actives
  • 60 requêtes par minute et par clé
  • Webhook signé, envoi de modèles Meta
  • Désactivable à tout moment depuis FChat

Calculer

38 USD par mois

35 USD pour 5 utilisateurs + 1 × 3 USD

Créer mon compte

Questions fréquentes

Faut-il passer par Groupe ELAKO pour obtenir une clé ?

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.

Mon numéro WhatsApp doit-il déjà être relié ?

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.

Pourquoi mon message reste-t-il en « pending » puis échoue ?

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.

J'ai perdu ma clé, que faire ?

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.

Où vois-je ce que mon logiciel envoie ?

Dans FChat, la conversation du client : chaque envoi porte la mention « API » et le nom de la clé.