Documentation API

Introduction

L'API ABS est une API REST simple et puissante qui vous permet d'envoyer des messages WhatsApp (texte, images, PDF) depuis vos applications métier.

URL de base : https://abs.plaisirorientalsn.com

Pour utiliser l'API, vous aurez besoin :

D'un compte ABS actif
De votre Clé API (disponible dans votre Dashboard)
D'avoir scanné le QR Code depuis votre Dashboard pour connecter votre numéro WhatsApp

Authentification

Ajoutez votre clé API dans l'en-tête Authorization de chaque requête :

Authorization: Bearer VOTRE_CLE_API

Ne partagez jamais votre clé API publiquement (surtout pas en JavaScript front-end).

Envoyer un message texte

Envoyez un message texte simple à n'importe quel numéro WhatsApp.

POST https://abs.plaisirorientalsn.com/api/sendText

Paramètres (JSON Body)

Paramètre	Type	Statut	Description
`number`	String	Requis	Numéro avec indicatif, sans + (ex: `221771234567`)
`message`	String	Requis	Contenu du message. Supporte les sauts de ligne `\n`.

Exemple cURL

# Envoyer un message texte simple curl -X POST https://abs.plaisirorientalsn.com/api/sendText \ -H "Authorization: Bearer VOTRE_CLE_API" \ -H "Content-Type: application/json" \ -d '{ "number": "221771234567", "message": "Bonjour depuis ABS !" }'

Réponse succès

// HTTP 202 Accepted
{
  "success": true,
  "message": "Message queued for sending"
}
                

Envoyer une pièce jointe (PDF / Image)

Envoyez un fichier encodé en Base64 avec un message de légende optionnel. Disponible sur les forfaits Pro et Enterprise.

POST https://abs.plaisirorientalsn.com/api/sendText

Paramètres supplémentaires

Paramètre	Type	Statut	Description
`number`	String	Requis	Numéro avec indicatif (ex: `221771234567`)
`message`	String	Optionnel	Texte de légende affiché sous le fichier
`base64Data`	String	Requis	Fichier en Data URL : `data:application/pdf;base64,JVBERi0...`
`mimeType`	String	Optionnel	Type MIME : `application/pdf`, `image/png`, etc.
`fileName`	String	Optionnel	Nom du fichier (ex: `facture_001.pdf`)

Exemple PHP — Envoyer un PDF

<?php // Lire et encoder le PDF en Base64 $pdfPath = '/chemin/vers/facture.pdf'; $pdfBase64 = 'data:application/pdf;base64,' . base64_encode(file_get_contents($pdfPath)); $ch = curl_init('https://abs.plaisirorientalsn.com/api/sendText'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Authorization: Bearer VOTRE_CLE_API', 'Content-Type: application/json' ]); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([ 'number' => '221771234567', 'message' => 'Voici votre facture en pièce jointe.', 'base64Data' => $pdfBase64, 'mimeType' => 'application/pdf', 'fileName' => 'facture_001.pdf' ])); $response = json_decode(curl_exec($ch), true); curl_close($ch); ?>

Codes d'erreur

Code HTTP	Signification	Solution
202 Accepted	Message envoyé avec succès	—
401 Unauthorized	Clé API invalide ou manquante	Vérifiez votre clé API dans le Dashboard
400 Bad Request	WhatsApp non connecté	Scannez le QR Code dans votre Dashboard
402 Payment Required	Limite de messages atteinte	Passez à un forfait supérieur
403 Forbidden	Pièces jointes non autorisées	Disponible sur les forfaits Pro et Enterprise

Exemples complets

JavaScript (fetch)

// Envoyer un message depuis un serveur Node.js const response = await fetch('https://abs.plaisirorientalsn.com/api/sendText', { method: 'POST', headers: { 'Authorization': 'Bearer VOTRE_CLE_API', 'Content-Type': 'application/json' }, body: JSON.stringify({ number: '221771234567', message: 'Bonjour depuis JavaScript !' }) }); const data = await response.json(); console.log(data);

Python (requests)

import requests response = requests.post( 'https://abs.plaisirorientalsn.com/api/sendText', headers={ 'Authorization': 'Bearer VOTRE_CLE_API', 'Content-Type': 'application/json' }, json={ 'number': '221771234567', 'message': 'Bonjour depuis Python !' } ) print(response.json())