Pas besoin d'être développeur. Ce guide vous explique étape par étape comment connecter TAMBA à votre site ou boutique pour offrir la livraison express à vos clients.
Vos clients commandent, TAMBA livre. Automatiquement.
Dès qu'une commande est passée sur votre boutique, TAMBA assigne un livreur automatiquement. Vous ne faites rien.
Vos clients voient où se trouve leur colis à chaque instant, directement depuis votre boutique ou par SMS.
Le prix de livraison est calculé et affiché automatiquement selon l'adresse de votre client. Transparent et honnête.
Voici ce qui se passe concrètement quand un client passe une commande
Il remplit son adresse de livraison normalement. TAMBA calcule automatiquement le prix de livraison (moto ou voiture) et l'affiche à côté des autres frais.
Exemple : "Livraison express moto — 2 500 FCFA (30-45 min)" ou "Livraison voiture — 5 000 FCFA"
Dès que le paiement est confirmé, votre boutique envoie automatiquement la demande à TAMBA. En quelques secondes, un livreur disponible dans la zone est assigné.
Votre client reçoit un SMS avec son code de suivi. Vous ne faites absolument rien de votre côté.
TAMBA vous envoie des notifications à chaque étape : livreur parti, en route, livré. Votre tableau de bord se met à jour en temps réel.
En cas de problème (client absent, mauvaise adresse), TAMBA vous contacte directement.
C'est le "mot de passe" qui connecte votre boutique à TAMBA. Il faut le faire une seule fois.
Inscrivez-vous
Allez sur tamba.app/partner-portal et créez un compte partenaire gratuitement (2 minutes).
Recevez votre clé
Votre clé API (tmb_live_xxx...) apparaît dans votre tableau de bord. Copiez-la.
Gardez-la secrète
Ne la partagez jamais publiquement. C'est comme votre mot de passe de banque en ligne.
Votre clé API ressemble à ça : tmb_live_aBcDeFgH1234... — Ne la mettez jamais dans le code visible de votre site (HTML, JavaScript côté client). Utilisez toujours votre serveur ou plugin pour l'utiliser.
Choisissez votre plateforme pour voir les étapes spécifiques
Plugin WordPress e-commerce
Installez le plugin TAMBA
Dans votre tableau de bord WordPress, allez dans Extensions → Ajouter. Recherchez "TAMBA Delivery" et cliquez sur Installer puis Activer.
Entrez votre clé API
Allez dans WooCommerce → Réglages → Expédition → TAMBA. Collez votre clé API (que vous avez obtenue dans votre espace partenaire TAMBA). Cliquez sur Enregistrer.
Configurez les zones
Indiquez votre adresse de départ (votre boutique). TAMBA calculera automatiquement le prix de livraison pour chaque commande selon la zone du client.
Testez avec une commande
Passez une commande test sur votre boutique. Vous devriez voir apparaître les options de livraison TAMBA (moto, voiture) avec les prix en FCFA.
Pour les sites vitrines ou blogs — copiez-collez ce code, c'est tout.
Ce widget ouvre un formulaire de commande TAMBA dans une fenêtre popup. Aucune installation, aucune configuration serveur. Il suffit de copier le code HTML ci-dessous.
<!-- Bouton Commander une livraison TAMBA -->
<script src="https://cdn.tamba.app/widget.js"
data-api-key="tmb_live_VOTRE_CLE_ICI"
data-color="#f97316"
data-label="Commander une livraison">
</script>
<!-- Ce bouton apparaîtra automatiquement sur votre page -->Changer la couleur
Remplacez #f97316 par votre couleur. Exemple :
Changer le texte du bouton
Modifiez data-label. Exemples :
Pour les développeurs — voici exactement comment appeler l'API pour afficher les tarifs.
En langage simple : Quand votre client saisit son adresse de livraison, vous envoyez cette adresse à TAMBA, et TAMBA vous répond avec le prix. Vous affichez ce prix à votre client. C'est tout.
1 Vous envoyez les adresses à TAMBA
async function obtenirPrixLivraison(adresseClient) {
const reponse = await fetch(
'https://api.tamba.app/v1/estimate?' + new URLSearchParams({
pickup_address: 'Bamako, Mon Magasin, ACI 2000', // votre adresse
delivery_address: adresseClient, // adresse du client
package_size: 'small', // taille du colis
}),
{
headers: { 'Authorization': 'Bearer tmb_live_VOTRE_CLE' }
}
);
const resultat = await reponse.json();
return resultat.options; // contient les prix moto et voiture
}2 TAMBA vous répond avec les prix
{
"success": true,
"options": [
{
"vehicle_type": "moto",
"vehicle_label": "🏍️ Livraison Moto",
"price": 2500, ← Affichez ce prix à votre client
"currency": "XOF",
"estimated_duration": "30-45 min"
},
{
"vehicle_type": "car",
"vehicle_label": "🚗 Livraison Voiture",
"price": 5000,
"currency": "XOF",
"estimated_duration": "45-60 min"
}
]
}3 Quand le client confirme, créez la livraison
async function creerLivraison(commande) {
const reponse = await fetch('https://api.tamba.app/v1/deliveries', {
method: 'POST',
headers: {
'Authorization': 'Bearer tmb_live_VOTRE_CLE',
'Content-Type': 'application/json',
},
body: JSON.stringify({
sender_name: 'Mon Magasin',
sender_phone: '+223 20 00 00 00',
receiver_name: commande.nomClient, // nom de votre client
receiver_phone: commande.telephoneClient, // téléphone de votre client
pickup_address: 'Bamako, Mon Magasin', // votre adresse
delivery_address: commande.adresseClient, // adresse de votre client
package_size: 'small',
vehicle_type: 'moto',
}),
});
const resultat = await reponse.json();
// Envoyez le code de suivi à votre client !
console.log('Code de suivi :', resultat.delivery.tracking_code);
// → "TLY-A3K9M2X7"
}✅ C'est tout ! Une fois que vous avez appelé cette fonction, TAMBA s'occupe du reste : trouver un livreur, le dispatching, le suivi client, les notifications SMS.
Tout ce que vous devez savoir avant de commencer
Notre équipe technique peut vous aider à intégrer TAMBA sur votre boutique, gratuitement, en moins de 30 minutes.
Vous êtes développeur et voulez la documentation technique complète ?
Voir la documentation API complète