LinkedIn
Instagram
Telegram
Gmail
Outlook
Google Agenda
Rejoindre la communauté Slack Table des matières
Le Lien
Créer un lien
Au-delà du lien
Liens Clic-pour-Discuter WhatsApp
API de lien WhatsApp : Comment faire wa.me et api.whatsapp.com Les liens fonctionnent vraiment
Un lien WhatsApp est une URL, et non une API. Ce guide vous donne l'exact wa.me et api.whatsapp.com/send les formats text paramètre, un générateur gratuit, et le point où le lien s'arrête et où une véritable intégration doit commencer.
Essai gratuit de 7 jours, aucune carte de crédit requise
Juste une URL
Pas d'authentification, pas de code
Bonjour ! J'ai une question concernant votre produit.
Ouvre le chat. Un humain doit toujours appuyer sur envoyer.
Définition
Qu'est-ce qu'une API de lien WhatsApp ?
Il n'y a pas d'API de lien WhatsApp.
https://wa.me/<number> et https://api.whatsapp.com/send?phone=<number> sont des URL de clic pour clavarder : cliquer sur l'une d'elles ouvre une conversation dans WhatsApp. Elles nécessitent pas d'authentification, pas de compte développeur et pas de code. Les API de WhatsApp constituent une couche distincte, et elles commencent exactement là où s'arrête le lien.Critère
Un lien WhatsApp
Une API WhatsApp
Format
LienUne URL que vous pouvez coller n'importe où
APIUn point de terminaison HTTP authentifié
Mise en place
LienAucun. Cela fonctionne instantanément
APIAssociation de comptes, une clé API, une bibliothèque client
Que se passe-t-il au clic / à l'appel
LienOuvre une discussion et peut pré-remplir un champ de texte
APIEnvoie, reçoit et liste des messages par programmation
Qui joue
LienUn humain appuie sur envoyer
APIVotre logiciel agit au nom du compte lié
Format
Quel est le format exact du lien wa.me ?
Le format documenté est
https://wa.me/<number>, où <number> est un numéro de téléphone complet au format international. Le centre d'aide de WhatsApp indique que vous devez omettre les zéros, les parenthèses ou les tirets.Utiliser : https://wa.me/1XXXXXXXXXX
Ne pas utiliser : https://wa.me/+001-(XXX)XXXXXXX Ce qu'il faut garder
Code pays plus numéro d'abonné, chiffres uniquement. Pas de préfixe
+. Quoi enlever
Zéros non significatifs, espaces, tirets, parenthèses. Aucun d'entre eux n'a sa place dans le chemin.
Comparaison
Quelle est la différence entre wa.me et api.whatsapp.com/send ?
Tous les deux ouvrent la même conversation.
wa.me/ le format court est-il documenté dans le centre d'aide de WhatsApp, avec le numéro dans le chemin. api.whatsapp.com/send?phone= est la version longue, toujours très utilisée, qui transporte le numéro sous forme de paramètre de requête.Anatomie d'une URL, segment par segment
https://wa.me/1XXXXXXXXXXBonjour
https://api.whatsapp.com/envoyer?phone=1XXXXXXXXXXSalut
Hôte
Chemin fixe
Le nombre
Le message
Critère
wa.me
api.whatsapp.com/send
Où vit le nombre
wa.meDans le chemin de l'URL
api.whatsapp.comDans le
téléphone paramètre de requêteDocumenté dans le centre d'aide de WhatsApp
wa.meOui, ce format exact
api.whatsapp.comIntrouvable sur la page d'aide actuelle
Comportement observé
wa.meOuvre le chat
api.whatsapp.comOuvre le même chat
Une lacune de documentation, pas une dépréciation. Nous n'avons pas pu trouver de page WhatsApp ou Meta actuelle et officielle qui documente
api.whatsapp.com/send. Cela ne signifie pas qu'il a cessé de fonctionner : les deux formats redirigent vers la même conversation aujourd'hui. Cela signifie que le propre centre d'aide de WhatsApp ne couvre que wa.me. Créez de nouveaux liens selon le format documenté.Le paramètre de texte
Comment ajouter un message pré-rempli à un lien WhatsApp ?
Ajouter
?text= suivi du message encodé en URL : https://wa.me/<number>?text=<urlencodedtext>. Le texte atterrit dans le champ de saisie du chat, pré-rempli et modifiable.https://wa.me/1XXXXXXXXXX?text=I'minterestedinyourcarforsale// pas de numéro : ouvre un sélecteur de contacts à la placehttps://wa.me/?text=I'minquiringabouttheapartmentlisting Sans numéro, WhatsApp ouvre la liste des contacts de l'expéditeur au lieu d'une discussion spécifique. Le
L'encodage, les certaines correspondances text se pré-remplit toujours une fois qu'un contact est sélectionné. Personnage
Espace
Nouvelle ligne
&
#
Codé en
%20
%0A
%26
%23
Bon à savoir également :
Créer le lien dans le code + encode en %2B. Pour tout le reste, emojis compris, ne construisez pas le tableau vous-même : appelez encodeURIComponent() en JavaScript ou urllib.parse.quote() en Python. // JavaScriptconst number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}?text=${encodeURIComponent(text)}`;# Pythonfrom urllib.parse import quote
number, text = "1XXXXXXXXXX", "Bonjour ! J'ai une question."
link = f"https://wa.me/{number}?text={quote(text)}"Outil gratuit
Générez votre lien WhatsApp
Entrez un numéro et un message. Obtenez le wa.me le lien api.whatsapp.com l'équivalent, le texte encodé, un extrait HTML et le bouton officiel, le tout en même temps.
Fonctionne entièrement dans votre navigateur. Aucun numéro n'est jamais envoyé à un serveur.
Numéro international complet. Pas de +, pas de 0, ni espaces ni tirets.
Optionnel. S'inscrit dans le champ de saisie du chat, toujours modifiable par l'expéditeur.
lien wa.me
https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product.
Équivalent de api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Hi!%20I%20have%20a%20question%20about%20your%20product.
paramètre text, encodé
Bonjour ! J'ai une question concernant votre produit.
Extrait HTML, prêt à être collé
<a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener" aria-label="Discuter sur WhatsApp">Discuter sur WhatsApp</a>
Bouton officiel "Discuter sur WhatsApp"
Discuter sur WhatsApp <a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Discuter sur WhatsApp</a>
Ce lien ouvre une conversation. Il n'envoie pas le message et votre produit ne verra pas la réponse.
Est-ce qu'un lien WhatsApp envoie le message ?
Non. Un lien "cliquer pour discuter" ouvre la conversation et pré-remplit le champ de texte. Rien n'est envoyé tant que la personne qui tient le téléphone n'appuie pas sur envoyer.
La partie honnête
Que ne peut pas faire un lien WhatsApp ?
Un lien "cliquer pour discuter" est sans état. Votre produit ne sait jamais si le lien a été cliqué, si le message a été envoyé ou si le destinataire a répondu.
Là où s'arrête le lien
Lien cliqué
Le chat s'ouvre
Message prérempli
Envoi manuel
Lienarrêtsici
Réponse reçue
Historique de conversation
Événement webhook
Attribution par utilisateur
Pas d'accusé de réception ni de lecture
Aucune réponse n'a été acheminée vers votre application
Aucun historique de conversation
Pas de pièces jointes
Aucun déclencheur côté serveur. Il faut un humain et un clic
Pas d'attribution par utilisateur dans un produit multi-locataire
Échec silencieux si le numéro n'a pas de compte WhatsApp actif
Comportement différent entre l'ordinateur de bureau, WhatsApp Web et mobile
Aucune création ou gestion de groupe. Un lien ouvre uniquement une discussion individuelle, voir le API de groupe WhatsApp limites pour tout ce qui concerne les groupes
Un lien ne peut pas enregistrer de clics, de réponses ou d'historique. Une API le peut. Créer une véritable intégration WhatsApp
Collez le lien
Comment récupérez-vous la réponse dans votre application ?
Vous avez besoin d'une API qui gère une session WhatsApp. Deux routes existent : API Cloud de Meta, qui nécessite un compte professionnel vérifié, ou un API de compte connecté comme Unipile, où l'utilisateur final associe son propre compte WhatsApp pour le compte de l'utilisateur authentifié, par code QR ou code d'appairage.
API Meta CloudEntreprise vérifiée
Nécessite un compte WhatsApp Business vérifié
Facturé par message depuis le 1er juillet 2025, voir le Prix de l'API WhatsApp Business panne
La fenêtre de service client de 24 heures existe toujours, elle détermine ce qui est gratuit, pas ce qui est facturé
Conçu pour des notifications modélisées à grande échelle
Compte connecté, UnipileAucune vérification
Chaque utilisateur final lie son propre compte WhatsApp, pour le compte de l'utilisateur authentifié
Par code QR ou code d'association, sans vérification Meta Business
Lit et envoie depuis la boîte de réception active associée, réponses incluses
Même schéma de connexion, d'envoi, de liste et d'écoute que LinkedIn, Instagram, Telegram, Gmail, Outlook et IMAP
// 1. Lier le compte, au nom de l'utilisateur authentifié
const { qrCodeString } = await client.compte.connecterWhatsapp();// 2. Envoyer un message une fois lié
POST /api/v1/chats/{chat_id}/messages{ "texte": "Bonjour ! Votre commande a été expédiée." }// 3. Recevoir les réponses via un webhook, pas de scrutin{ "event": "message_reçu", "chat_id": "chat_182...", "message": "Est-ce toujours disponible ?"}Pour le guide complet d'envoi, les charges utiles et la gestion des webhooks, voir comment envoyer des messages WhatsApp via l'API. Référence du point de terminaison : developer.unipile.com/docs/whatsapp.
Décision
Lien, API Cloud ou compte connecté : lequel vous faut-il ?
Utilisez un lien lorsqu'un humain initie la conversation à partir d'une page que vous contrôlez. Utilisez l'API Cloud lorsqu'une entreprise vérifiée envoie des notifications modélisées à grande échelle. Utilisez une API de compte connecté lorsque votre produit doit lire et envoyer des messages à partir de la propre boîte de réception WhatsApp de l'utilisateur.
Critère
Lien
API Meta Cloud
Compte connecté
Qui prend l'initiative
LienUn être humain, depuis une page que vous contrôlez
API dans le nuageVotre entreprise envoie d'abord, standardisé
Compte connectéDe chaque côté, depuis la boîte de réception liée
Auth requise
LienAucun
API dans le nuageCompte Meta Business vérifié
Compte connectéCode QR ou code d'association, pas de vérification d'entreprise
Coût
LienGratuit
API dans le nuagePar message, depuis le 1er juillet 2025
Compte connectéTarification des forfaits Unipile, non facturé par message
Reçoit des réponses
LienNon
API dans le nuageOui, via webhook
Compte connectéOui, via webhook
Historique de conversation
LienNon
API dans le nuageOui,
Compte connectéOui,
Produits multi-locataires
LienPauses, un nombre en dur
API dans le nuageNécessite un routage personnalisé par numéro d'entreprise
Compte connectéNatif, un compte lié par utilisateur final
Temps de préparation
Lienrapidement
API dans le nuageDe quelques jours à quelques semaines, vérification d'entreprise
Compte connectéMinutes en heures
J'ai juste besoin d'un lien
Utiliser le générateur au-dessus. Pas de compte, pas de configuration.
Envoi de notifications modélisées
Voir le Intégration de l'API WhatsApp Cloud guide.
Lecture et envoi par l'utilisateur
Commencez par le Guide complet de l'API WhatsApp.
La plupart des produits deviennent trop grands pour ce lien en moins d'une semaine. Commencez là où vous finirez réellement. Commencer à construire
Mise en œuvre
Comment intégrez-vous un lien WhatsApp dans un produit ?
Générez le lien côté serveur, par utilisateur, et ne codez jamais de numéro de téléphone en dur dans un produit multi-tenant. Le lien est simplement une balise ancre, il appartient donc à votre couche de modèle, et non à votre couche API.
<a href="https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}"
cible="_blank" relatif="noopener"
aria-label="Discuter sur WhatsApp"Discuter sur WhatsAppa>Bouton officiel
WhatsApp publie un badge " Discuter sur WhatsApp " prêt à l'emploi, vert et blanc, en quelques tailles fixes, destiné à être utilisé sans modification.
Discuter sur WhatsApp Code QR
Tout générateur de code QR qui accepte une URL transforme un
wa.me lien vers un code scannable pour l'impression, l'emballage ou la signalétique physique. Mobile Ouvre directement l'application WhatsApp, avec la conversation et le texte pré-rempli prêts.
Bureau, application installée Ouvre l'application de bureau WhatsApp au lieu du navigateur.
Bureau, pas d'application Ouvre WhatsApp Web dans le navigateur et invite à se connecter via un code QR si la session n'est pas déjà active.
Pourquoi le lien se rompt dans les produits multi-locataires : un seul numéro codé en dur ne peut pas différencier vos clients. Générez le lien à partir de l'enregistrement de l'utilisateur ou de l'espace de travail spécifique à chaque fois, afin qu'il contienne le numéro exact que cet utilisateur possède réellement, et non un numéro collé une seule fois dans un modèle.
Dépannage
Pourquoi mon lien WhatsApp ne fonctionne-t-il pas ?
Les deux causes les plus courantes sont un numéro de téléphone qui n'est pas au format international standard et un
text paramètre qui n'était pas codé en URL.CauseNuméro de téléphone non au format international standard
RéparerUtilisez le numéro international complet, chiffres uniquement : non
+, sans introduction 0, sans espaces, tirets ou parenthèses.CauseLe paramètre texte n'a pas été encodé en URL
RéparerFaites passer le message
encodeURIComponent() en JavaScript ou urllib.parse.quote() en Python avant de l'ajouter.CauseLe numéro n'a pas de compte WhatsApp actif
RéparerLe lien s'ouvre toujours, mais le chat échoue silencieusement. Vérifiez d'abord que le numéro est bien enregistré sur WhatsApp.
CauseOuvert dans le navigateur intégré d'une application tierce
RéparerLes navigateurs intégrés des applications de réseaux sociaux ou publicitaires bloquent parfois la redirection ou la gèrent mal. Ouvrez plutôt le lien dans le navigateur du système.
CauseUn robot d'exploration d'aperçu de lien a réécrit l'URL
RéparerCertaines plates-formes enveloppent les liens sortants dans leur propre redirection, ce qui peut supprimer la chaîne de requête. Testez le brut
wa.me URL directement.API de lien WhatsApp - FAQ
Tout ce que les développeurs demandent sur wa.me, api.whatsapp.com, le paramètre text et où le lien s'arrête.
Il n'existe pas de API unique pour les liens WhatsApp. wa.me et api.whatsapp.com/send sont des URL de clic pour clavarder : en ouvrir une lance une conversation sur WhatsApp, sans aucune authentification, compte de développeur ou code requis. Les propres API de WhatsApp constituent une couche distincte qui commence exactement là où le lien s'arrête, une fois qu'une personne doit répondre.
Le format documenté est https://wa.me/<number>, où <number> est le numéro de téléphone complet au format international. Le Centre d'aide de WhatsApp indique d'omettre tous les zéros non significatifs, crochets, espaces ou tirets, par exemple https://wa.me/1XXXXXXXXXX.
Tous les deux ouvrent la même conversation. wa.me/ la version abrégée est-elle documentée dans le Centre d'aide de WhatsApp, avec le numéro dans le chemin de l'URL. api.whatsapp.com/send?phone= est la forme longue, encore largement utilisée, qui transporte le nombre sous forme de paramètre de requête à la place.
Non. Un lien click-to-chat ouvre la conversation et peut pré-remplir le champ de texte, mais rien n'est envoyé tant que la personne qui tient le téléphone n'appuie pas sur envoyer.
Oui. Ajouter à la fin ?text= suivi d'un message encodé en URL, par exemple https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. Le texte arrive dans le champ de saisie du chat, pré-rempli et toujours modifiable avant l'envoi. Essayez-le dans générateur au-dessus.
Les deux causes les plus courantes sont un numéro de téléphone qui n'est pas au format international standard et un text paramètre qui n'a pas été encodé pour les URL. Vérifiez également que le numéro possède un compte WhatsApp actif et que le lien n'a pas été ouvert dans le navigateur intégré d'une application tierce.
Non. A wa.me ou api.whatsapp.com/send lien ne nécessite aucun compte professionnel, aucune vérification et aucun accès à l'API. La plateforme WhatsApp Business, ou Cloud API, est un produit vérifié distinct pour les entreprises qui ont besoin d'envoyer des notifications modélisées à grande échelle ou de recevoir des réponses par programmation. Voir le Guide complet de l'API WhatsApp.
Un lien en soi ne peut pas renvoyer de réponses à votre application, il est sans état. Pour lire et envoyer à partir d'une véritable boîte de réception, vous avez besoin d'une API qui gère une session WhatsApp : soit l'API Cloud de Meta avec un compte professionnel vérifié, soit une API de compte connecté telle que Unipile, où chaque utilisateur final lie son propre compte WhatsApp pour le compte de l'utilisateur authentifié, par code QR ou code d'appairage. Voir comment envoyer des messages WhatsApp via l'API.
Vous ne savez toujours pas si vous avez besoin d'un lien ou d'une API ? Notre équipe peut vous aider à vous décider.
FR 
EN 
ES 
DE 
IT 
BR 
NL 
PL 
TR