Guide d'intégration de l'API
Connectez votre CRM, votre système de réservation ou toute application pour envoyer des messages WhatsApp grâce à notre API simple.
Démarrez en 5 étapes simples
Téléchargez l'application de bureau
Téléchargez et installez All-in-One Messenger Hub sur votre ordinateur Windows.
Connectez votre WhatsApp
Ajoutez votre compte WhatsApp à l'application en scannant le code QR.
Créez une Session API
Allez dans l'onglet WhatsApp et créez une nouvelle Session API. Reliez-la à votre canal WhatsApp.
Copiez votre clé API
Copiez la clé API générée. Conservez-la en lieu sûr - c'est votre authentification.
Commencez à envoyer des messages
Utilisez l'API depuis votre application. Laissez l'application de bureau en cours d'exécution pour livrer les messages.
Authentification
Tous les points de terminaison de l'API nécessitent une authentification via votre clé API. Vous pouvez transmettre la clé de l'une de ces façons :
| Méthode | Exemple |
|---|---|
| En-tête X-API-Key (recommandé) | X-API-Key: your-api-key |
| Paramètre de requête ou de corps | key=your-api-key |
| Paramètre alternatif | api_key=your-api-key |
Envoyer un message
Envoyez un message WhatsApp à un numéro de téléphone ou à un groupe. Les messages sont mis en file d'attente et livrés lorsque l'application de bureau est en cours d'exécution.
POST https://onemessengerhub.com/api/whatsapp-session/send
Paramètres
| Paramètre | Type | Requis | Description |
|---|---|---|---|
key |
string | Oui | Votre clé API issue de l'application de bureau |
mobile |
string | Conditionnel | Numéro de téléphone avec indicatif pays (requis sans group_id) |
group_id |
string | Conditionnel | ID de groupe WhatsApp (requis sans mobile). Le suffixe @g.us est ajouté automatiquement. |
message |
string | Oui | Texte du message (4096 caractères maximum) |
Exemple de requête
curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mobile": "1234567890", "message": "Hello!"}'
Requête GET simple (navigateur ou lien)
https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!
Réponse de succès (201)
{
"success": true,
"message": "Message queued successfully",
"data": {
"message_id": 123,
"recipient": "1234567890",
"status": "pending"
}
}
Enregistrer un contact
Enregistrez ou renommez un contact dans votre WhatsApp. L'opération est mise en file d'attente et traitée par l'application de bureau.
POST https://onemessengerhub.com/api/whatsapp-session/save-contact
Paramètres
| Paramètre | Type | Requis | Description |
|---|---|---|---|
key |
string | Oui | Votre clé API issue de l'application de bureau |
contact_id |
string | Oui | Numéro de téléphone du contact ou ID WhatsApp (50 caractères maximum). Le suffixe @c.us est ajouté automatiquement. |
name |
string | Oui | Nom d'affichage du contact (255 caractères maximum) |
Exemple de requête
curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contact_id": "1234567890", "name": "John Doe"}'
Réponse de succès (201)
{
"success": true,
"message": "Contact save operation queued",
"data": {
"operation_id": 456,
"contact_id": "[email protected]",
"status": "pending"
}
}
Supprimer un contact
Supprimez un contact de votre WhatsApp. L'opération est mise en file d'attente et traitée par l'application de bureau.
POST https://onemessengerhub.com/api/whatsapp-session/remove-contact
Paramètres
| Paramètre | Type | Requis | Description |
|---|---|---|---|
key |
string | Oui | Votre clé API issue de l'application de bureau |
contact_id |
string | Oui | Numéro de téléphone du contact ou ID WhatsApp (50 caractères maximum). Le suffixe @c.us est ajouté automatiquement. |
Exemple de requête
curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contact_id": "1234567890"}'
Réponse de succès (201)
{
"success": true,
"message": "Contact remove operation queued",
"data": {
"operation_id": 789,
"contact_id": "[email protected]",
"status": "pending"
}
}
Gestion des erreurs
L'API utilise des codes de statut HTTP standard. Voici les réponses d'erreur courantes :
Erreur d'authentification (401)
{
"success": false,
"message": "Invalid or inactive API key"
}
Erreur de validation (422)
{
"success": false,
"message": "Validation failed",
"errors": {
"mobile": ["The mobile field is required when group id is not present."],
"message": ["The message field is required."]
}
}
Ce que vous pouvez créer
Intégration CRM
Envoyez des messages de relance, des rappels et des mises à jour directement depuis votre système CRM.
Confirmations de réservation
Envoyez automatiquement aux clients des confirmations de rendez-vous et des rappels.
Notifications de commande
Informez les clients du statut de la commande, des mises à jour d'expédition et des informations de livraison.
Systèmes d'alerte
Envoyez des alertes et des notifications importantes à votre équipe ou à vos clients.
Campagnes marketing
Envoyez des messages promotionnels et des mises à jour à votre liste de contacts.
Flux de travail personnalisés
Intégrez Zapier, Make, n8n ou toute plateforme d'automatisation.
Plus d'API bientôt disponibles
Nous élargissons notre offre d'API pour couvrir davantage de plateformes et de cas d'usage.
API Chatbot
Déclenchez des réponses de chatbot et gérez les conversations de façon programmatique.
API Contacts
Accédez à vos contacts de messagerie et gérez-les sur toutes les plateformes.
Webhooks
Recevez des notifications en temps réel lorsqu'un message est reçu ou envoyé.
All-in-One Messenger Hub