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

1

Téléchargez l'application de bureau

Téléchargez et installez All-in-One Messenger Hub sur votre ordinateur Windows.

2

Connectez votre WhatsApp

Ajoutez votre compte WhatsApp à l'application en scannant le code QR.

3

Créez une Session API

Allez dans l'onglet WhatsApp et créez une nouvelle Session API. Reliez-la à votre canal WhatsApp.

4

Copiez votre clé API

Copiez la clé API générée. Conservez-la en lieu sûr - c'est votre authentification.

5

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
POST

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

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

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.

Bientôt disponible

API Chatbot

Déclenchez des réponses de chatbot et gérez les conversations de façon programmatique.

Bientôt disponible

API Contacts

Accédez à vos contacts de messagerie et gérez-les sur toutes les plateformes.

Bientôt disponible

Webhooks

Recevez des notifications en temps réel lorsqu'un message est reçu ou envoyé.