Passer au contenu principal

​
Demarrage rapide

Ce guide vous accompagne dans la creation d’une instance, sa connexion et l’envoi de votre premier message.

​
Prerequis

  • Un compte Wappfy (inscription)
  • Un numero WhatsApp a connecter
  • Une cle API ou un jeton JWT Supabase

​
Etape 1 : Obtenir votre cle API

curl -X POST https://api.wappfy.io/api/api-keys \
  -H "Authorization: Bearer YOUR_SUPABASE_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "name": "My First Key" }'
Conservez la valeur key retournee — elle n’est affichee qu’une seule fois.

​
Etape 2 : Creer une instance

curl -X POST https://api.wappfy.io/api/instances \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production WhatsApp",
    "instance_type": "waha"
  }'
Conservez l’id retourne — vous l’utiliserez dans toutes les requetes suivantes.

​
Etape 3 : Se connecter via QR code

# Demarrer la connexion
curl -X POST https://api.wappfy.io/api/instances/INSTANCE_ID/connect \
  -H "X-Api-Key: YOUR_API_KEY"

# Obtenir le QR code
curl https://api.wappfy.io/api/instances/INSTANCE_ID/qr \
  -H "X-Api-Key: YOUR_API_KEY"
Ouvrez WhatsApp sur votre telephone, allez dans Appareils connectes et scannez le QR code retourne dans le champ qr (image base64).

​
Etape 4 : Envoyer un message

Une fois que le statut de l’instance est connected, vous pouvez envoyer votre premier message : 
curl -X POST https://api.wappfy.io/api/instances/INSTANCE_ID/messages/send \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "type": "text",
    "body": "Hello from Wappfy!"
  }'

​
Reponse

{
  "success": true,
  "data": {
    "message": "Message queued for delivery",
    "jobId": "12345"
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-02-10T12:00:00.000Z"
  }
}

​
Etapes suivantes

Envoyer tous les types de messages

Images, videos, sondages, contacts, et bien plus

Configurer les webhooks

Recevoir les messages entrants et les statuts de livraison