SamaBot pour WordPress — Guide d'intégration

🎯 3 méthodes d'intégration

Choisissez la méthode qui vous convient :

📋

Code dans le footer

Coller un script via "Insert Headers and Footers"

📄

Shortcode PHP

Pour les développeurs (functions.php)

🚀 Méthode 1 — Plugin WordPress (recommandé)

Téléchargez le plugin

Cliquez sur le bouton ci-dessous pour récupérer le ZIP du plugin officiel SamaBot.

⬇️ Télécharger samabot-wp.zip

Créez votre bot SamaBot

Si vous n'avez pas encore de bot, créez-le gratuitement et notez votre Bot ID.

Créer mon bot →

Installez le plugin sur WordPress

Dans WordPress: Extensions → Ajouter → Téléverser une extension → sélectionnez le ZIP → Installer → Activer.

Configurez votre Bot ID

Allez dans Réglages → SamaBot, collez votre Bot ID, choisissez votre couleur, et enregistrez.

✅ C'est fait !

La bulle de chat apparaît automatiquement sur tout votre site. Utilisez les shortcodes pour aller plus loin.

🎉 Total : ~2 minutes. Votre site WordPress est maintenant connecté à SamaBot.

🧱 Shortcodes disponibles

Une fois le plugin installé, utilisez ces shortcodes dans n'importe quelle page ou article WordPress :

🛍️ Catalogue produits

[samabot_catalogue limit="8"]

Affiche vos produits avec photo, prix et bouton "Commander". Idéal pour pages "Menu", "Boutique", "Services".

💬 Bouton "Discuter"

[samabot_chat texte="Discuter sur WhatsApp"]

Bouton CTA qui ouvre le chat. Personnalisez le texte.

⭐ Avis clients

[samabot_avis limit="5"]

Affiche les avis avec note moyenne. Excellent pour social proof.

📊 Note moyenne (badge)

[samabot_rating]

Petit badge "⭐ 4.5 (28 avis)" à mettre dans le header ou footer.

🖼️ Chat intégré (iframe)

[samabot_chat_embed height="600"]

Intègre le chat complet dans une page (idéal pour page "Contact").

📋 Méthode 2 — Code manuel (sans plugin)

Si vous préférez ne pas installer le plugin :

Installez "Insert Headers and Footers"

Dans WordPress: Extensions → Ajouter → Cherchez "Insert Headers and Footers" (par WPBeginner) → Installer + Activer.

Allez dans Réglages → Insert Headers and Footers

Trouvez la section "Scripts in Footer".

Collez ce code (remplacez VOTRE_BOT_ID)

Save → C'est fait !

La bulle apparaît sur tout le site.

📄 Méthode 3 — Shortcode PHP custom (développeurs)

Pour les développeurs qui veulent intégrer dans functions.php sans plugin :

// Dans functions.php du thème enfant function mon_catalogue_samabot() { $bot_id = 'VOTRE_BOT_ID'; $url = 'https://api.samabot.app/api/v1/bots/' . $bot_id . '/catalogue'; $response = wp_remote_get($url, ['timeout' => 5]); if (is_wp_error($response)) return ''; $data = json_decode(wp_remote_retrieve_body($response), true); if (empty($data['catalogue'])) return ''; $html = '<div class="catalogue">'; foreach ($data['catalogue'] as $p) { $html .= '<div><h3>' . esc_html($p['nom']) . '</h3>'; $html .= '<p>' . number_format($p['prix']) . ' FCFA</p></div>'; } return $html . '</div>'; } add_shortcode('mon_catalogue', 'mon_catalogue_samabot'); // Usage dans une page: [mon_catalogue]

🛠️ Compatibilité

Plateforme	Support	Notes
WordPress 5.8+	✅ Oui	Plugin officiel
WooCommerce	✅ Oui	Shortcode `[samabot_chat]` sur fiches produit
Elementor	✅ Oui	Widget HTML + shortcode
Divi	✅ Oui	Module Code + shortcode
Beaver Builder	✅ Oui	Module HTML + shortcode
Gutenberg	✅ Oui	3 blocs natifs (Catalogue, Avis, Chat)
Multilangue (WPML/Polylang)	✅ Oui	Le bot répond en wolof + français automatiquement

❓ FAQ

Le plugin ralentit-il mon site ?

Non. Le widget se charge en mode async (n'empêche pas l'affichage de la page) et le catalogue est mis en cache 5-10 min.

Compatible avec tous les thèmes ?

Oui. Le plugin s'injecte via wp_footer, qui fonctionne avec 99% des thèmes.

Je peux personnaliser le design ?

Oui : couleur dans les réglages, et CSS custom via .samabot-catalogue, .samabot-avis, etc.

Le widget marche sur mobile ?

Parfaitement. Il s'adapte automatiquement aux petits écrans.

Je peux désactiver la bulle sur certaines pages ?

Oui. Dans les réglages, ajoutez les slugs des pages à exclure (ex: checkout, mon-compte).