Envoyer un message WhatsApp avec une API en Python

Envoyer un message WhatsApp depuis votre code ne demande ni numéro vert, ni validation Meta Business à rallonge : une simple requête HTTP suffit. Ce guide montre comment faire en Python, de la clé d'API au premier message livré.

Ce qu'il vous faut

• Un compte SenWaAPI et une clé d'API (préfixe snw_), disponible dans votre tableau de bord.
• Une session WhatsApp liée (scan du QR code une seule fois).
• Python 3.9+ avec la librairie requests (pip install requests).

Premier envoi en 8 lignes

L'API expose un endpoint REST qui prend un destinataire et un texte. Voici l'envoi minimal :

import requests

resp = requests.post(
    "https://senwaapi.com/api/send-message",
    headers={"Authorization": "Bearer snw_votre_cle_api"},
    json={"to": "+221771234567", "text": "Bonjour depuis Python 👋"},
)
resp.raise_for_status()
print(resp.json())

Le numéro est au format international (indicatif pays compris). En cas de succès, l'API renvoie un objet JSON confirmant la mise en file du message.

Gérer les erreurs proprement

En production, ne supposez jamais qu'un envoi réussit. Les deux cas les plus fréquents sont une clé invalide (401) et une session WhatsApp non liée. Isolez l'appel pour réagir sans planter votre application :

try:
    resp = requests.post(
        "https://senwaapi.com/api/send-message",
        headers={"Authorization": "Bearer snw_votre_cle_api"},
        json={"to": numero, "text": message},
        timeout=10,
    )
    resp.raise_for_status()
except requests.HTTPError as e:
    # Journalisez le code et le corps côté serveur, jamais côté client.
    print("Échec de l'envoi:", e.response.status_code)

Cas d'usage concrets

• Notifications de commande pour une boutique e-commerce.
• Codes de vérification (OTP) à usage unique.
• Rappels de rendez-vous automatiques.

Pour les détails de chaque endpoint (médias, statut de session, webhooks), consultez la documentation de l'API. Et pour estimer votre volume, jetez un œil aux tarifs.

Et la limite de débit ?

Chaque session WhatsApp respecte un délai minimal entre deux envois pour rester conforme aux règles de la plateforme. Espacez vos messages ou mettez-les en file côté application — n'essayez pas de contourner cette limite, c'est ce qui protège votre numéro d'un bannissement.

Vous avez maintenant tout pour intégrer WhatsApp à votre application Python.