WhatsApp Chatbot API — Créez des conversations intelligentes

Créez des chatbots propulsés par l'IA, des répondeurs à règles et des flux conversationnels sur WhatsApp. Connectez votre logique à notre API et traitez les conversations clients automatiquement.

Comment fonctionne un chatbot WhatsApp

Un chatbot WhatsApp comporte trois composants : la couche de connexion, la couche de traitement et la couche de réponse. Notre API gère entièrement la couche de connexion. Vous construisez les couches de traitement et de réponse.

Le flux est simple :

1. Un client envoie un message à votre numéro WhatsApp
2. Notre API reçoit le message et le transmet à votre URL de webhook
3. Votre gestionnaire de webhook traite le message — c'est là que réside la logique de votre chatbot
4. Votre gestionnaire appelle notre API pour renvoyer une réponse au client
5. Le client reçoit la réponse dans sa conversation WhatsApp

Cette boucle complète s'exécute généralement en moins de 200 millisecondes. Le client voit la réponse presque instantanément, ce qui crée une expérience conversationnelle naturelle.

Modèles d'architecture de chatbot

Modèle 1 : bot simple à règles

Le chatbot le plus simple utilise la correspondance par mots-clés. Lorsqu'un client envoie "suivre commande", le bot répond avec le lien de suivi. Lorsqu'il envoie "horaires", le bot répond avec les heures d'ouverture. Ce modèle convient bien aux bots de type FAQ et peut être implémenté en moins de 50 lignes de code.

# Python example - simple rule-based bot
def handle_message(message):
    msg = message.lower()
    if 'track' in msg or 'order' in msg:
        return 'Track your order here: https://example.com/track'
    elif 'hours' in msg:
        return 'We are open Mon-Fri, 9AM-6PM.'
    elif 'help' in msg:
        return 'Type: track, hours, or contact for support.'
    else:
        return 'I am not sure how to help. Type "help" for options.'

Modèle 2 : bot conversationnel à états

Un bot plus sophistiqué suit l'état de la conversation. Le client parcourt un flux — choisir une option de menu, fournir des informations, confirmer une action. Chaque étape dépend de la précédente. Vous devez stocker l'état de la conversation (dans une base de données, Redis ou en mémoire) et vous y référer lors du traitement de chaque nouveau message.

Ce modèle est idéal pour la prise de rendez-vous, la passation de commandes, la qualification de leads et tout processus en plusieurs étapes. Le bot pose une question, attend la réponse, pose la question suivante, et ainsi de suite jusqu'à la fin du flux.

Modèle 3 : bot propulsé par l'IA

Connectez notre webhook à un modèle d'IA (OpenAI, Claude ou tout autre LLM) et laissez le bot gérer les conversations libres. L'IA génère les réponses à partir de votre prompt système, de votre base de connaissances et de l'historique de conversation. Cela fonctionne remarquablement bien pour le support client, les questions produits et les demandes générales.

// Node.js example - AI-powered bot
app.post('/webhook', async (req, res) => {
    const { message, from } = req.body.data;

    // Call your AI model
    const aiResponse = await openai.chat.completions.create({
        model: 'gpt-4',
        messages: [
            { role: 'system', content: 'You are a helpful support agent for...' },
            { role: 'user', content: message }
        ]
    });

    // Send the AI response back via WhatsApp
    await fetch('https://api2whats.com/send-text', {
        method: 'POST',
        headers: { 'Authorization': 'Bearer ' + API_KEY },
        body: JSON.stringify({
            to: from,
            message: aiResponse.choices[0].message.content
        })
    });

    res.json({ success: true });
});

Modèle 4 : bot hybride

L'approche la plus pratique combine règles, état et IA. Les requêtes simples obtiennent des réponses rapides à base de règles. Les requêtes complexes déclenchent l'IA. Si l'IA ne peut pas résoudre le problème, la conversation est escaladée vers un agent humain. Vous obtenez la vitesse des règles, la flexibilité de l'IA et le filet de sécurité du support humain.

Créer un chatbot : étape par étape

Étape 1 : configurer la connexion API

Créez un compte, connectez un numéro WhatsApp et récupérez votre clé API. Configurez votre URL de webhook dans le tableau de bord ou via l'API. Vérifiez que les messages entrants atteignent votre serveur en consultant les journaux de webhook.

Étape 2 : concevoir vos flux conversationnels

Cartographiez les conversations que votre bot doit gérer. Commencez par les 5 à 10 demandes clients les plus courantes. Pour chacune, définissez :

• Ce qui déclenche le flux (mots-clés, intentions ou commandes directes)
• Quelles questions le bot pose
• Quelles informations le bot demande au client
• Quelle réponse ou action le bot fournit
• Ce qui se passe si le bot ne peut pas aider (chemin d'escalade)

Étape 3 : implémenter le gestionnaire de webhook

Écrivez un point de terminaison serveur qui reçoit les requêtes POST de notre API. Analysez le message entrant, appliquez votre logique de chatbot et envoyez une réponse via notre API. Gérez les cas particuliers : messages vides, messages média, messages de numéros inconnus.

Étape 4 : tester et itérer

Connectez votre numéro personnel comme instance de test. Envoyez-lui des messages depuis un autre téléphone. Testez chaque flux conversationnel. Vérifiez que le bot gère correctement les entrées inattendues. Surveillez les journaux de webhook pour détecter les erreurs.

Étape 5 : déployer et surveiller

Déployez votre gestionnaire de webhook sur un serveur de production. Mettez en place une surveillance des temps de réponse, des taux d'erreur et des taux d'achèvement des conversations. Utilisez les webhooks de statut des messages pour suivre les taux de livraison et de lecture.

Cas d'usage des chatbots WhatsApp

Support client

Traitez automatiquement les demandes de support les plus courantes : statut de commande, politiques de retour, horaires, questions de compte. Réduisez le volume de tickets de 40 à 60 % tout en fournissant des réponses instantanées 24h/24 et 7j/7. Escaladez les problèmes complexes vers des agents humains avec le contexte complet de la conversation.

E-commerce

Envoyez automatiquement confirmations de commande, mises à jour d'expédition et notifications de livraison. Laissez les clients suivre leurs commandes en envoyant leur numéro de commande. Recommandez des produits selon l'historique d'achat. Gérez les retours et échanges via des flux conversationnels.

Prise de rendez-vous

Laissez les clients réserver directement dans WhatsApp. Affichez les créneaux disponibles, collectez les informations nécessaires, envoyez des confirmations et gérez les reprogrammations. Intégrez votre système de calendrier pour éviter les doubles réservations.

Génération de leads

Qualifiez les leads via des flux conversationnels. Renseignez-vous sur le budget, le calendrier, les besoins et la taille de l'entreprise. Notez automatiquement les leads et transmettez les prospects qualifiés à votre équipe commerciale. Envoyez des messages de suivi à intervalles planifiés.

Outils internes

Créez des chatbots internes pour votre équipe. Bots de helpdesk informatique pour les réinitialisations de mot de passe et les vérifications d'état système. Bots RH qui répondent aux questions de politique. Bots opérationnels qui signalent la santé du système et déclenchent des alertes.

Bonnes pratiques

• Gardez des réponses courtes — WhatsApp est une plateforme mobile d'abord. Les longs paragraphes sont ignorés. Visez 1 à 3 phrases par réponse.
• Utilisez des réponses rapides — Quand c'est possible, proposez des options numérotées ("Répondez 1 pour le statut de commande, 2 pour les retours") plutôt que des questions ouvertes.
• Offrez toujours une sortie — Chaque flux conversationnel doit permettre de joindre un agent humain. "Tapez 'agent' pour parler à une personne."
• Personnalisez — Utilisez le nom du client et référez-vous à sa commande ou à son compte. Les messages personnalisés obtiennent un engagement 3 à 5 fois supérieur.
• Testez avec de vrais utilisateurs — Votre bot sera utilisé par de vraies personnes avec de vraies questions que vous n'avez pas anticipées. Testez tôt et souvent.
• Surveillez et améliorez — Suivez les messages qui provoquent confusion ou abandon. Affinez vos flux à partir des données d'utilisation réelles.

Avancé : prise en charge multilingue

Si vos clients parlent plusieurs langues, votre chatbot doit le gérer. Il existe deux approches :

Détection de la langue

Analysez le message entrant pour détecter la langue, puis répondez dans la même langue. Pour les bots à règles, maintenez des jeux de mots-clés séparés par langue. Pour les bots IA, demandez au modèle de répondre dans la langue détectée.

Sélection de la langue

Commencez la conversation en demandant au client de choisir sa langue : "Répondez 1 pour français, 2 pour anglais, 3 pour arabe." C'est plus simple à implémenter et plus fiable que la détection automatique.

Notre API prend en charge Unicode — les messages en arabe, hébreu, hindi, chinois et dans toute autre écriture fonctionnent parfaitement. Le texte de droite à gauche est géré par le client WhatsApp lui-même.

Intégration avec les modèles d'IA

Les chatbots les plus puissants utilisent de grands modèles de langage pour générer des réponses. Voici comment intégrer les modèles d'IA populaires :

OpenAI (GPT-4)

Envoyez le message WhatsApp entrant à l'API OpenAI avec un prompt système décrivant votre entreprise et la manière dont le bot doit répondre. Transmettez l'historique de conversation comme contexte. Renvoyez la réponse de l'IA au client via notre API.

Claude (Anthropic)

Semblable à l'intégration OpenAI. Claude excelle dans les conversations nuancées et le suivi d'instructions complexes. Utilisez l'API Messages avec un prompt système adapté à votre cas d'usage.

Modèles locaux

Pour les entreprises qui exigent la confidentialité des données, exécutez un LLM local (comme Llama ou Mistral) sur vos propres serveurs. Le modèle d'intégration est identique — recevoir le message, l'envoyer à votre modèle local, renvoyer la réponse.

Considérations de coût : les bots IA coûtent plus cher par conversation que les bots à règles, mais ils couvrent un spectre de requêtes bien plus large. Commencez avec des règles pour les 20 principales requêtes et ajoutez l'IA pour la longue traîne.