Démarrer
FR
Click-to-chat WhatsApp

API des liens WhatsApp : wa.me & api.whatsapp.com expliqués

Un lien WhatsApp est une URL, pas une API. Voici les formats exacts, le paramètre text, un générateur gratuit et les limites du lien.

Démarrer
Fonctionnement

API des liens WhatsApp : comment fonctionnent vraiment les liens wa.me et api.whatsapp.com

Les deux ouvrent une discussion, puis une personne prend le relais.

  1. 1Quelqu'un ouvre l'URL
  2. 2WhatsApp ouvre la discussion
  3. 3Une personne appuie sur Envoyer
Définition

Qu'est-ce qu'une API de lien WhatsApp ?

Il n'existe pas d'API de lien WhatsApp. https://wa.me/<number> et https://api.whatsapp.com/send?phone=<number> sont des URL click-to-chat. Les API commencent là où le lien s'arrête.

Un lien WhatsApp
Configuration
Aucune
Au clic
Ouvre une discussion, préremplit le texte
Qui agit
Une personne appuie sur Envoyer
Une API WhatsApp
Configuration
Connexion du compte et clé API
À l'appel
Envoie, reçoit et liste les messages
Qui agit
Votre logiciel, au nom du compte connecté
Format

Quel est le format exact d'un lien wa.me ?

Le format documenté est https://wa.me/<number>, avec le numéro de téléphone complet au format international.

Anatomie de l'URL
https://wa.me/1XXXXXXXXXX
Hôte. Toujours le même.
Numéro. Indicatif pays en premier, chiffres uniquement.
À utiliserhttps://wa.me/1XXXXXXXXXX
À éviterhttps://wa.me/+001-(XXX)XXXXXXX
À retirer avant de générer+0 initialEspacesTiretsParenthèses

Source : Centre d'aide WhatsApp, « How to use click to chat »

Comparaison

Quelle différence entre wa.me et api.whatsapp.com/send ?

Les deux ouvrent la même conversation. Seul l'emplacement du numéro change.

wa.meDocumenté
https://wa.me/1XXXXXXXXXX?text=Hi

Numéro dans le chemin. Documenté par WhatsApp.

api.whatsapp.com/sendEncore très utilisé
https://api.whatsapp.com/send?phone=1XXXXXXXXXX&text=Hi

Numéro dans le paramètre phone. Absent de la page d'aide actuelle, d'après nos recherches.

Un manque de documentation, pas une dépréciation. Créez vos nouveaux liens sur wa.me.

Le paramètre text

Comment ajouter un message prérempli à un lien WhatsApp ?

Ajoutez ?text= suivi du message encodé pour l'URL : https://wa.me/<number>?text=<urlencodedtext>. Le texte reste modifiable.

Caractères à encoder
Espace%20
Retour à la ligne%0A
&%26
#%23
+%2B

Emojis et le reste : encodeURIComponent().

Pas de numéro ? https://wa.me/?text=... ouvre le sélecteur de contacts.

build-link.js
const number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}` +
  `?text=${encodeURIComponent(text)}`;
https://wa.me/1XXXXXXXXXX?text=Hi!%20I%20have%20a%20question.
Outil gratuit

Générez votre lien WhatsApp

Saisissez un numéro et un message, puis copiez ce dont vous avez besoin.

Chiffres uniquement, indicatif pays en premier.
Facultatif, reste modifiable.

S'exécute dans votre navigateur. Aucun numéro n'est envoyé à un serveur.

Lien wa.me
https://wa.me/15550123456?text=Bonjour%20!%20J'ai%20une%20question%20sur%20votre%20produit.
Équivalent api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Bonjour%20!%20J'ai%20une%20question%20sur%20votre%20produit.
Paramètre text encodé
Bonjour%20!%20J'ai%20une%20question%20sur%20votre%20produit.
Extrait HTML
<a href="https://wa.me/15550123456?text=Bonjour%20!%20J'ai%20une%20question%20sur%20votre%20produit." target="_blank" rel="noopener" aria-label="Chat on WhatsApp with 15550123456">Chat on WhatsApp</a>
Bouton « Chat on WhatsApp »
<a href="https://wa.me/15550123456?text=Bonjour%20!%20J'ai%20une%20question%20sur%20votre%20produit." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Chat on WhatsApp</a>

Un lien ouvre une discussion. Il n'envoie rien, et votre produit ne voit jamais la réponse.

Construisez ce qu'un lien ne sait pas faire
Réponse courte

Un lien WhatsApp envoie-t-il le message ?

Non. Rien n'est envoyé tant que la personne qui tient le téléphone n'appuie pas sur Envoyer.

Discussion ouverte
Texte prérempli
Envoyé seulement après un appui sur Envoyer
Les limites du lien

Que ne peut pas faire un lien WhatsApp ?

Un lien click-to-chat est sans état : votre application ne sait jamais ce qui s'est passé ensuite.

Ce que fait le lien
  • Lien cliqué
  • Discussion ouverte
  • Message prérempli
  • Envoi manuel
Le lien s'arrête ici
Ce qui exige une API
  • Réponse reçue
  • Historique de conversation
  • Événement webhook
  • Attribution par utilisateur
Aucun statut de remise ou de lecture
Aucune pièce jointe
Aucun déclenchement côté serveur
Échec silencieux sur un numéro sans WhatsApp
Comportement différent selon l'appareil
Aucun groupe, voir les limites de l'API de groupe WhatsApp
Créez une vraie intégration WhatsApp
Au-delà du lien

Comment récupérer la réponse dans votre application ?

Il vous faut une API qui maintient une session WhatsApp. Deux voies existent.

Meta Cloud APIEntreprise vérifiée
  • Exige un compte WhatsApp Business vérifié
  • Facturé au message depuis le 1er juillet 2025, voir les tarifs de l'API WhatsApp Business
  • Réponses dans la fenêtre de 24 heures : 1 000 gratuites par numéro et par mois depuis le 1er octobre 2026
Compte connecté, UnipileSans vérification Business
  • Chaque utilisateur final connecte son propre compte WhatsApp
  • Votre application agit au nom de l'utilisateur authentifié
  • Lit et envoie depuis l'inbox réelle, réponses comprises
  • La même API que LinkedIn, Telegram, Gmail et d'autres
Avec Unipile
  1. 1Connectez le compte par QR code ou code d'appairage
  2. 2Envoyez depuis votre application
  3. 3Recevez les réponses par webhook : message_received

Découvrez l'API WhatsApp d'Unipile et comment envoyer des messages WhatsApp via API. Référence : developer.unipile.com/v1.0/docs/whatsapp.

Construisez-le avec Unipile
Décision

Lien, Cloud API ou compte connecté : lequel vous faut-il ?

Choisissez selon qui écrit en premier.

Un lien

Une personne lance la discussion depuis votre page.

Auth
Aucune
Coût
Gratuit
Réponses
Invisibles pour votre application
Utiliser le générateur ci-dessus
Meta Cloud API

Une entreprise vérifiée envoie des modèles de messages.

Auth
Compte Meta Business vérifié
Coût
Au message, depuis le 1er juillet 2025
Réponses
Oui, via webhook
Guide d'intégration WhatsApp Cloud API
Compte connecté

Votre produit agit dans l'inbox de chaque utilisateur.

Auth
QR code ou code d'appairage
Coût
Forfait Unipile, sans facturation au message
Réponses
Oui, via webhook
Guide complet de l'API WhatsApp
Lancez-vous
Mise en œuvre

Comment intégrer un lien WhatsApp dans un produit ?

Générez-le par utilisateur dans vos templates. Ne codez jamais un numéro unique en dur dans un produit multi-tenant.

Modèle de lien
https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}
Numéro. Issu de la fiche utilisateur.
Texte. Encodé pour l'URL au rendu.
Bouton officiel

Le badge vert « Chat on WhatsApp » de WhatsApp, utilisé tel quel.

QR code

N'importe quel générateur de QR code transforme un lien wa.me en code imprimable.

Où il s'ouvre
Mobile
L'application WhatsApp
Ordinateur, appli installée
L'application de bureau
Ordinateur, sans appli
WhatsApp Web
Dépannage

Pourquoi mon lien WhatsApp ne fonctionne-t-il pas ?

Le plus souvent : le format du numéro ou un texte non encodé.

1 Le numéro n'est pas au format international brut
https://wa.me/+001-(XXX)XXXXXXX
https://wa.me/1XXXXXXXXXX

Solution : chiffres uniquement, indicatif pays en premier.

2 Le paramètre text n'a pas été encodé pour l'URL
?text=Hi there & welcome
?text=Hi%20there%20%26%20welcome

Solution : encodeURIComponent() ou urllib.parse.quote().

3 Aucun compte WhatsApp actif

La discussion échoue sans message d'erreur.

4 Ouvert dans un navigateur intégré

Utilisez le navigateur du système.

5 Un aperçu de lien a réécrit l'URL

La query string a été perdue. Testez l'URL brute.

Misez sur les comptes connectés

API des liens WhatsApp - FAQ

Réponses rapides pour les développeurs.

Non. wa.me et api.whatsapp.com/send sont des URL click-to-chat : elles ouvrent une discussion WhatsApp, sans authentification ni code. Les API de WhatsApp commencent là où le lien s'arrête.

https://wa.me/<number>, où <number> est le numéro complet au format international, sans zéros initiaux, parenthèses, espaces ni tirets. Par exemple : https://wa.me/1XXXXXXXXXX.

Les deux ouvrent la même conversation. wa.me/<number> est la forme courte documentée dans le Centre d'aide WhatsApp, avec le numéro dans le chemin. api.whatsapp.com/send?phone=<number> est la forme longue, avec le numéro en paramètre de requête.

Non. Le lien ouvre la conversation et peut préremplir le champ de texte. Rien n'est envoyé tant que la personne qui tient le téléphone n'appuie pas sur Envoyer.

Oui. Ajoutez ?text= et un message encodé pour l'URL, par exemple https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. Le texte reste modifiable avant l'envoi. Essayez le générateur ci-dessus.

En général, le numéro n'est pas au format international brut, ou le texte n'a pas été encodé pour l'URL. Vérifiez aussi que le numéro utilise WhatsApp et évitez les navigateurs intégrés aux applications.

Non. Un lien wa.me ou api.whatsapp.com/send ne nécessite ni compte Business ni accès à une API. La Cloud API est un produit distinct, soumis à vérification. Consultez le guide complet de l'API WhatsApp.

Pas avec un lien : il est sans état. Utilisez la Cloud API de Meta avec un compte Business vérifié, ou Unipile, où chaque utilisateur final connecte son propre compte par QR code ou code d'appairage et votre application agit au nom de l'utilisateur authentifié. Voir comment envoyer des messages WhatsApp via API.

Lien ou API ? Notre équipe vous aide à choisir.

Parler à un expert