Documentation de l'API WhatsApp

Commencez ici

Votre première demande en quatre étapes

Connectez-vous et activez WhatsApp pour un mobile pris en charge.

Confirmez le destinataire avec le point de terminaison de vérification du numéro.

Envoyez avec waonly=yes.

Pour les messages entrants, activez la récupération, synchronisez, puis appelez /getwa.

L'application mobile sécurisée SMSMobileAPI connectant un téléphone au tableau de bord Web et à l'API REST pour les opérations SMS et d'appel — Connexion mobile à plateforme cryptée

Application mobile officielle

Le pont sécurisé entre votre téléphone, votre tableau de bord et votre API.

Les opérations SMS et appels passent par l'application officielle SMSMobileAPI installée sur votre téléphone connecté. L'application associe en toute sécurité l'appareil à votre compte, synchronise les événements autorisés et relie le réseau mobile au tableau de bord et à l'API REST.

1Application mobileAssocie le téléphone et sa carte SIM 2Lien cryptéAuthentifie et protège les données dans transit 3Tableau de bord et APIContrôle les flux de travail et l'activité

Communications signées distribuées via les listes officielles de Google Play et Apple App Store
Contrôles d'examen, de signature et de distribution des plateformes Google et Apple
Couplage sécurisé des appareils, transport HTTPS et accès API authentifié
Uniquement les autorisations requises pour les fonctionnalités mobiles que vous activez

Obtenez l'application officielle SMSMobileAPI sur Google Play

Téléchargez l'application officielle SMSMobileAPI sur l'App Store d'Apple

Les fonctionnalités dépendent des autorisations et de l'accès en arrière-plan autorisés par Android ou iOS.

Authentification

Conservez les informations d'identification sur votre serveur

Utilisez apikey pour les intégrations directes. Les informations d'identification du client OAuth2 sont disponibles pour les applications côté serveur ; demandez un jeton et envoyez-le comme autorisation : porteur ACCESS_TOKEN.

POST · GET

Envoyer un message WhatsApp

ENDPOINThttps://api.smsmobileapi.com/sendsms

Envoie un texte WhatsApp ou un média pris en charge via l'environnement connecté.

Quand l'utiliser

Utilisez-le pour des destinataires individuels ou un groupe de contacts du tableau de bord.

Paramètres

Nom	Taper	Exigence	Description
`apikey`	chaîne	Requis	Votre clé API ; à omettre lors de l'utilisation d'un jeton Bearer.
`recipients`	téléphone	Requis	Code du pays plus numéro, sans + ou 00.
`message`	chaîne	Requis	Corps du texte ; plusieurs lignes sont prises en charge.
`waonly`	Oui	Requis	Vous devez répondre oui pour demander une livraison via WhatsApp uniquement.
`url_media`	URL HTTPS	Facultatif	PDF public, document, archive ou URL JPG/PNG.
`url_media_shorted`	Oui	Facultatif	Utilisez une URL de téléchargement raccourcie avec le mode d'aperçu PDF.
`pdf_with_image`	Oui	Facultatif	Ajoutez un aperçu d'image pour un PDF.
`encrypt_message`	Oui	Facultatif	Exiger un déchiffrement côté destinataire.
`contactGroup`	GUID	Facultatif	Envoyer à chaque contact dans un tableau de bord groupe.

Exemple de demande

boucle

curl -X POST "https://api.smsmobileapi.com/sendsms?waonly=yes" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=191728660" \
  --data-urlencode "message=Your order is ready."

Exemple de réponse

JSON

{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "MESSAGE_GUID",
    "send_with_whatsapp": "1"
  }
}

Vous souhaitez exécuter cette requête ?Connectez votre clé API en haut de la page pour déverrouiller le testeur interactif.

Clé de connexion ↑

Bien pour savoir

Les URL de médias prises en charge doivent être des ressources HTTPS publiques.
Formatage WhatsApp : *gras*, _italique_, ~barré~ et triple backtick monospace.

POST · GET

Renvoyer un message WhatsApp non envoyé

ENDPOINThttps://api.smsmobileapi.com/resendwa/

Réessaye un message WhatsApp qui a actuellement un statut d'erreur.

Quand l'utiliser

Utilisez-le après avoir diagnostiqué une entrée de journal WhatsApp ayant échoué.

Paramètres

Nom	Taper	Exigence	Description
`apikey`	chaîne	Requis	Votre clé API.
`guid`	chaîne	Requis	GUID du message ayant échoué.

Exemple de demande

boucle

curl "https://api.smsmobileapi.com/resendwa/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID"

Vous souhaitez exécuter cette requête ?Connectez votre clé API en haut de la page pour déverrouiller le testeur interactif.

Clé de connexion ↑

Bien pour savoir

Seuls les messages ayant échoué peuvent être renvoyés.

OBTENIR

Activer la récupération entrante

ENDPOINThttps://api.smsmobileapi.com/getwa/active/

Active, désactive ou active la récupération des messages WhatsApp.

Quand l'utiliser

Appelez-le une fois avant d'utiliser la synchronisation WhatsApp entrante.

Paramètres

Nom	Taper	Exigence	Description
`apikey`	chaîne	Requis	Votre clé API.
`statut`	0 \| 1 \| x	Facultatif	1 active, 0 désactive, x ou omission fait basculer l'état actuel.

Exemple de demande

boucle

curl "https://api.smsmobileapi.com/getwa/active/?apikey=YOUR_API_KEY&statut=1"

Exemple de réponse

JSON

{
  "success": true,
  "read_message_active": 1,
  "status_note": "Activated"
}

Vous souhaitez exécuter cette requête ?Connectez votre clé API en haut de la page pour déverrouiller le testeur interactif.

Clé de connexion ↑

Bien pour savoir

La récupération entrante est désactivée par défaut pour des raisons de confidentialité.

OBTENIR

Synchroniser les messages entrants

ENDPOINThttps://api.smsmobileapi.com/getwa/synchronisation/

Demande une nouvelle synchronisation WhatsApp avant la récupération.

Quand l'utiliser

Appelez-le immédiatement avant /getwa lorsque votre application a besoin de données entrantes actuelles.

Paramètres

Nom	Taper	Exigence	Description
`apikey`	chaîne	Requis	Votre clé API.

Exemple de demande

boucle

curl "https://api.smsmobileapi.com/getwa/synchronisation/?apikey=YOUR_API_KEY"

Exemple de réponse

JSON

{
  "error": "0",
  "messages": "synchronized",
  "expire_at": "2026-03-11 12:27:00",
  "expire_at_unix": "1773232020"
}

Vous souhaitez exécuter cette requête ?Connectez votre clé API en haut de la page pour déverrouiller le testeur interactif.

Clé de connexion ↑

Bien pour savoir

La synchronisation sert uniquement à recevoir des messages. Ne l'appelez pas avant l'envoi.

OBTENIR

Récupérer les messages WhatsApp

ENDPOINThttps://api.smsmobileapi.com/getwa

Renvoie les messages WhatsApp entrants synchronisés.

Quand l'utiliser

Utilisez-le après avoir activé et synchronisé la récupération entrante.

Paramètres

Nom	Taper	Exigence	Description
`apikey`	chaîne	Requis	Votre clé API.
`before`	Horodatage Unix	Facultatif	Renvoyer les enregistrements avant cela horodatage.
`date`	AAAA-MM-JJ	Facultatif	Renvoyer les enregistrements pour une date.
`message_type`	texte \| audio	Facultatif	Filtrer les messages texte ou les messages audio convertis en texte ; omettre pour les deux.

Exemple de demande

boucle

curl "https://api.smsmobileapi.com/getwa/?apikey=YOUR_API_KEY&message_type=text"

Exemple de réponse

JSON

{
  "date": "2026-03-11",
  "hour": "12:27:00",
  "timestamp": "1773232020",
  "number": "19176728660",
  "contact": "SMSMobileAPI",
  "message": "When will I receive my order?",
  "guid": "652fcfc0-12a8-46f5-b5ba-9391135b8b4c"
}

Vous souhaitez exécuter cette requête ?Connectez votre clé API en haut de la page pour déverrouiller le testeur interactif.

Clé de connexion ↑

OBTENIR

Vérifier un numéro WhatsApp

ENDPOINThttps://api.smsmobileapi.com/whatsapp/checknumber/

Vérifie si un numéro de téléphone est disponible sur WhatsApp.

Quand l'utiliser

Utilisez-le avant l'envoi pour réduire les échecs évitables.

Paramètres

Nom	Taper	Exigence	Description
`apikey`	chaîne	Requis	Votre clé API.
`recipients`	téléphone	Requis	Code du pays plus numéro, sans + ou 00.

Exemple de demande

boucle

curl "https://api.smsmobileapi.com/whatsapp/checknumber/?apikey=YOUR_API_KEY&recipients=19176728660"

Exemple de réponse

JSON

{
  "contact_found_on_whatsapp": "yes",
  "recipients": "19176728660"
}

Vous souhaitez exécuter cette requête ?Connectez votre clé API en haut de la page pour déverrouiller le testeur interactif.

Clé de connexion ↑

POSTE

Créez un jeton d'accès OAuth2

ENDPOINThttps://api.smsmobileapi.com/oauth2/token

Échange les informations d'identification du client contre un jeton Bearer.

Quand l'utiliser

Utilisez-le pour les intégrations de serveur à serveur où les informations d'identification de courte durée sont préférées.

Paramètres

Nom	Taper	Exigence	Description
`grant_type`	chaîne	Requis	Doit être client_credentials.
`client_id`	chaîne	Requis	ID client du tableau de bord.
`client_secret`	chaîne	Requis	Secret client du tableau de bord.

Exemple de demande

boucle

curl -X POST "https://api.smsmobileapi.com/oauth2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

Vous souhaitez exécuter cette requête ?Connectez votre clé API en haut de la page pour déverrouiller le testeur interactif.

Clé de connexion ↑

Bien pour savoir

Gardez le secret client sur votre serveur. Ne l'incluez jamais dans le code du mobile ou du navigateur.

Dépannage

Erreurs et tentatives sécurisées

Lisez l'état HTTP et le champ d'erreur JSON avant de réessayer. Ne réessayez pas les échecs de validation ou d'authentification sans d'abord corriger la demande.

HTTP	Code	Que faire
400	`missing_parameter`	Un paramètre obligatoire est vide ou absent. Vérifiez la table des paramètres du point de terminaison.
403	`invalid_apikey`	La clé API est inconnue, expirée ou non autorisée pour la fonctionnalité demandée.
429	`too_many_requests`	Les demandes arrivent trop rapidement. Attendez, puis réessayez avec un intervalle exponentiel.
500	`server_error`	Le service n'a pas pu terminer la demande. Conservez la réponse et contactez l'assistance si elle persiste.

Règle de nouvelle tentativeRéessayez uniquement les réponses 429 et 5xx transitoires. Commencez après 1 seconde, puis revenez à 2, 4 et 8 secondes.

Besoin d'aide ?

Apportez le contexte de la requête, pas vos secrets.

Partagez le point de terminaison, l'horodatage, l'état HTTP et la réponse nettoyée. N'incluez jamais de clés API, de jetons ou de contenu de message privé.

Contactez l'assistance API →