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"
}'
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"
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
