Fonctionnalité disponible : TOUS LES PLANS PAYANTS
Smappen Match vous indique dans quelle zones de votre carte Smappen se situe une adresse. Votre site web, CRM ou outil interne envoie une adresse, et Smappen renvoie la zone correspondante en temps réel : chaque demande arrive ainsi au bon franchisé, point de vente, commercial ou technicien.
Smappen Match fait partie de l’API Smappen. Votre carte reste l’unique endroit où vos territoires sont définis : chaque zone est prise en compte dès que vous la dessinez, et tout changement est utilisé dès la requête suivante.
À quoi ça sert ?
- Rediriger les demandes de votre site web vers le bon franchisé ou le bon point de vente
- Vérifier si une zone est encore disponible avant de la vendre à un nouveau franchisé
- Attribuer les leads ou demandes de devis au bon commercial
- Affecter les interventions au bon technicien ou prestataire
Ce qu’il vous faut
- Un plan Smappen payant (Smappen Match n’est pas disponible sur le plan gratuit)
- Vos zones dessinées sur une carte Smappen
- Quelqu’un qui peut connecter l’API à votre site web ou CRM : un développeur, un outil no-code capable d’envoyer des requêtes HTTP (comme Make ou Zapier), ou un assistant IA pour vous aider à écrire la connexion
Comment ça marche
Chaque requête envoie :
- une localisation : une adresse, un nom de lieu ou un code postal (Smappen le convertit d’abord en coordonnées GPS), ou des coordonnées GPS si vous les avez déjà. Un code postal est placé à son point central : envoyez une adresse complète quand vous avez besoin d’un rattachement précis
- l’ID de la carte où vos zones sont dessinées
Smappen renvoie :
- l’ID de la zone
- le nom de la zone
- le nom du dossier
- les coordonnées du point de repère de la zone
- la distance à vol d’oiseau entre la localisation et le point de repère
- le nombre de crédits qu’il vous reste
Si une adresse se situe dans plusieurs zones, Smappen les renvoie toutes, avec la distance au point de repère de chaque zone. C’est votre système qui décide laquelle utiliser.
Si une adresse se situe en dehors de toutes vos zones, Smappen renvoie un résultat vide. Smappen Match ne renvoie pas la zone la plus proche, et la requête consomme quand même des crédits. C’est votre système qui décide de la suite, par exemple envoyer la demande au siège.
Si vous modifiez une zone dans Smappen, le changement est pris en compte immédiatement : Smappen Match lit votre carte telle qu’elle est au moment de la requête, donc une nouvelle zone, déplacée ou renommée, est utilisée dès la requête suivante. Il n’y a rien à republier. Une zone conserve son ID quand vous la renommez.
Nommer vos zones et dossiers
Donnez à vos zones et dossiers des noms sur lesquels votre site web ou CRM peut agir :
- Nom de zone : le titulaire, ou un code déjà utilisé dans votre CRM. Par exemple « Lyon Nord – J. Martin » ou « AG-069-01 »
- Dossier : ce sur quoi vous routez. Par exemple « Vendues » et « Disponibles », ou un dossier par région ou par marque
Crédits et tarifs
Smappen Match utilise 5 crédits.
Chaque plan payant inclut 200 crédits par mois, soit environ 40 adresses. Pour en avoir davantage, vous pouvez ajouter des packs de 10 000 crédits (environ 2 000 adresses) :
| Pack de 10 000 crédits | Mensuel | Annuel, par mois | Annuel, par an |
|---|---|---|---|
| EUR | 100 | 90 | 1 080 |
| USD | 130 | 117 | 1 404 |
| GBP | 90 | 81 | 972 |
| AUD | 170 | 153 | 1 836 |
| CAD | 170 | 153 | 1 836 |
Les packs ne peuvent pas encore être achetés depuis l’espace client. Pour ajouter des crédits, contactez votre responsable de compte Smappen ou l’équipe à [email protected]
Gérer vos crédits
- Les crédits non utilisés ne sont pas reportés : votre compteur est remis à zéro chaque mois. Sur un plan annuel, les crédits se renouvellent chaque mois, pas une seule fois par an.
- Si vous dépassez vos crédits mensuels, les requêtes sont refusées (erreur 402) jusqu’à ce que des crédits soient ajoutés ou renouvelés
- Une requête qui ne trouve aucune zone consomme quand même des crédits, une requête en échec côté Smappen n’en consomme pas
- Si vous résiliez votre abonnement, vos crédits restent valables jusqu’à la fin de l’abonnement, puis les requêtes sont refusées (erreur 403)
Pour consulter votre solde de crédits :
- Dans Smappen : ouvrez l’onglet Developers dans le menu de votre compte. Le bloc Utilisation des crédits indique les crédits utilisés sur votre total pour la période de facturation en cours, ainsi que la date de renouvellement
- Dans chaque réponse : chaque requête Smappen Match et chaque géocodage renvoient leur coût et votre solde restant (en-têtes X-Credits-Cost et X-Credits-Remaining)
Pour commencer
- Dans Smappen, ouvrez l’onglet Developers dans le menu de votre compte et cliquez sur Créer une clé
- Donnez à chaque clé un nom qui indique où elle est utilisée (par exemple « Formulaire du site web » ou « Salesforce »), pour les distinguer facilement
- Chaque utilisateur d’un abonnement payant peut créer une clé. Il n’y a pas de limite au nombre de clés ; toutes les clés de l’abonnement partagent les mêmes crédits
La documentation de l’API est disponible sur api.smappen.com/api/public/v1/docs. Vous pouvez appeler Smappen Match depuis n’importe quel outil capable d’envoyer une requête HTTP, y compris Make, Zapier ou les workflows Salesforce.
