Aller au contenu
WbizTool

Envoyez des messages WhatsApp avec cURL

Essayez l’API WhatsApp de WbizTool depuis votre terminal avant d’écrire la moindre ligne de code. Chaque commande ci-dessous est un POST vers https://wbiztool.com/api/v1/, et le message part de votre propre numéro, relié comme WhatsApp Web.

Essai gratuit

Essai gratuit : 50 messages sur n’importe quelle période de 30 jours, sans carte bancaire.

Comment ça marche

  1. Obtenez votre clé API et reliez votre numéro

    Inscrivez-vous, puis reliez votre numéro WhatsApp sur la page Numéros WhatsApp avec un code QR ou un code de connexion, comme WhatsApp Web. Dans Paramètres → Clés API, créez une clé et copiez votre Client ID (le guide des clés API ci-dessous montre où). L’ID affiché sur la carte du numéro (par exemple ID 678) est votre whatsapp_client.

  2. Testez vos identifiants

    Faites un POST de votre client_id et de votre api_key vers /api/v1/me/. "status": 1 avec "message": "Okay" signifie qu’ils fonctionnent. Rien n’est envoyé et aucun message n’est utilisé.

  3. Envoyez un message

    Faites un POST vers /api/v1/send_msg/ avec le numéro de téléphone et le texte. Une réponse avec "status": 1 et un msg_id signifie que le message est en file d’attente sur votre numéro.

  4. Vérifiez qu’il est parti

    Faites un POST vers /api/v1/message/status/<msg_id>/. Le statut 1 signifie Sent ; le statut 2 signifie Failed, avec la raison dans error.

Exemples de code cURL

Vérifier vos identifiants
curl -X POST https://wbiztool.com/api/v1/me/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678
  }'
Envoyer un texte
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Hi Aman, your order #4821 has shipped and will arrive on Thursday."
  }'
Réponse
{"status": 1, "message": "Created", "msg_id": 9817263}
Envoyer une image depuis une URL
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 1,
    "country_code": "91",
    "phone": "9876543210",
    "img_url": "https://example.com/offers/diwali-sale.jpg",
    "msg": "Our Diwali sale starts today 🎉"
  }'
Envoyer un PDF depuis une URL
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 2,
    "country_code": "91",
    "phone": "9876543210",
    "file_url": "https://example.com/invoices/invoice-4821.pdf",
    "file_name": "invoice-4821.pdf",
    "msg": "Your invoice for order #4821 is attached."
  }'
Téléverser un fichier depuis votre ordinateur
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -F client_id=12345 \
  -F api_key=YOUR_API_KEY \
  -F whatsapp_client=678 \
  -F msg_type=2 \
  -F country_code=91 \
  -F phone=9876543210 \
  -F "msg=Your invoice for order #4821 is attached." \
  -F file_name=invoice-4821.pdf \
  -F file=@./invoice-4821.pdf
Planifier un message
curl -X POST https://wbiztool.com/api/v1/schedule_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Hi Aman, a reminder that your appointment is today at 11:30 AM.",
    "date": "24/12/2026",
    "time": "09:00",
    "timezone": "Asia/Kolkata"
  }'
Vérifier le statut du message
curl -X POST https://wbiztool.com/api/v1/message/status/9817263/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY"
  }'

Ce que vous pouvez faire

  • JSON ou champs de formulaire

    Envoyez le corps en JSON, en champs de formulaire, ou en multipart form data (-F) quand vous téléversez un fichier. Les exemples fonctionnent tels quels une fois vos propres ID et clé ajoutés.

  • Images et fichiers

    msg_type 1 envoie une image depuis img_url, msg_type 2 un fichier depuis file_url. Les fichiers liés peuvent faire jusqu’à 100 Mo, et le lien doit être public.

  • Planification avec fuseau horaire

    schedule_msg accepte date (jj/mm/aaaa), time (HH:MM) et un nom de timezone comme America/New_York ou une abréviation comme IST ou EST.

  • Des webhooks pour chaque statut

    Ajoutez "webhook": "https://…" et WbizTool y envoie en POST le msg_id et SENT, FAILED, CANCELLED ou EXPIRED quand le message change d’état.

  • Les mêmes appels depuis n’importe quel outil

    Make, Pabbly Connect et d’autres outils d’automatisation envoient exactement ces requêtes avec leur module HTTP. Une collection Postman est aussi disponible dans la documentation.

Bon à savoir

  • "status": 1 signifie que le message est en file d’attente, pas qu’il est remis. Sent est l’état final de réussite ; l’API n’indique pas si le message a été remis ou lu.
  • Dans du JSON, écrivez un saut de ligne dans msg sous la forme \n. Un vrai saut de ligne ou une virgule finale rend le JSON invalide.
  • Une heure planifiée déjà passée est acceptée et le message part immédiatement. La date commence par le jour (24/12/2026) : vérifiez-la avant l’envoi.
  • Les erreurs d’envoi de message reviennent avec HTTP 400 (429 à la limite quotidienne) ; les erreurs de planification reviennent en général avec HTTP 200 et "status": 0 : décodez donc toujours le corps et vérifiez status.
  • L’envoi à un groupe WhatsApp via l’API (group_name au lieu de phone) fonctionne avec tous les forfaits, essai gratuit compris.
  • L’essai gratuit inclut 50 messages sur n’importe quelle période de 30 jours et 1 numéro, sans carte bancaire. Les forfaits payants commencent à 25 $ par mois aux États-Unis (votre prix figure sur la page Tarifs) et envoient des messages illimités dans le cadre d’un usage raisonnable : jusqu’à 1 000 par jour et par numéro.
  • Les messages partent de votre propre numéro WhatsApp, donc les règles de WhatsApp s’appliquent : écrivez aux personnes qui s’attendent à avoir de vos nouvelles.

Questions fréquentes

Quel est l’endpoint de l’API WhatsApp pour envoyer un message ?
POST https://wbiztool.com/api/v1/send_msg/ avec client_id, api_key, whatsapp_client, phone (plus country_code si le numéro n’en a pas) et msg. La réponse contient status et, en cas de succès, un msg_id.
Comment planifier un message WhatsApp avec cURL ?
Faites un POST vers https://wbiztool.com/api/v1/schedule_msg/ avec les mêmes champs plus date (jj/mm/aaaa), time (HH:MM) et timezone. Le msg_id de la réponse vous permet de le vérifier ou de l’annuler plus tard.
Comment savoir si le message a été envoyé ?
Une réponse avec "status": 1 et un msg_id signifie qu’il est en file d’attente. Passez une URL webhook pour recevoir un POST avec SENT, FAILED, CANCELLED ou EXPIRED, ou appelez l’endpoint de statut du message avec le msg_id. Sent est l’état final : l’API n’indique pas si le message a été remis ou lu.
Quel format de numéro de téléphone envoyer ?
Envoyez le numéro avec son indicatif pays (919876543210), ou sans (9876543210) avec country_code (91). Les espaces, le +, les tirets et les parenthèses sont retirés pour vous : +91 98765-43210 fonctionne aussi.
Ai-je besoin de l’API WhatsApp Business ou d’une validation Meta ?
Non. WbizTool envoie depuis votre propre numéro WhatsApp ou WhatsApp Business, relié comme WhatsApp Web. Pas de validation Meta, et aucun modèle de message à faire approuver.
Est-ce payant au message ?
Non. L’essai gratuit inclut 50 messages sur n’importe quelle période de 30 jours. Les forfaits payants envoient des messages illimités dans le cadre d’un usage raisonnable, jusqu’à 1 000 par jour et par numéro : Lite 25 $, Standard 59 $ et Advanced 149 $ par mois aux États-Unis ; la page Tarifs affiche le prix de votre pays.

Lire les guides

Voir aussi

Envoyez votre premier message WhatsApp automatisé dès aujourd'hui

Créez un compte, scannez le QR code et envoyez un message en moins de cinq minutes.

Essai gratuit

Forfaits payants à partir de 25 $ par mois aux États-Unis. Tarifs