Vos clients vous demandent d'envoyer des SMS depuis votre logiciel. Avec l'API Conexteo, votre application crée un compte d'envoi pour chacun d'eux dès qu'il s'inscrit, le crédite quand il achète un pack, et envoie ses messages avec ses propres identifiants. Vous achetez en gros, vous revendez au détail, et le rapport mensuel par client vous donne de quoi facturer.
Un logiciel de gestion de salon, de cabinet, d'agence immobilière, un CRM ou une plateforme de réservation finit toujours par recevoir la même demande : « est-ce qu'on peut envoyer des SMS depuis votre outil ? ». Développer un opérateur SMS n'a pas de sens. Brancher un compte unique pour tous vos clients en a encore moins : leurs contacts, leurs désinscriptions et leur consommation se mélangeraient, et vous ne sauriez pas qui facturer pour quoi.
La réponse est l'organisation en super compte et sous-comptes. Votre compte éditeur devient un super compte. Chaque client de votre logiciel a son sous-compte Conexteo, créé et piloté par l'API, sans qu'il ait à s'inscrire chez nous ni même à savoir que nous existons. Cette page explique le modèle économique, puis les appels d'API à brancher, dans l'ordre où votre logiciel en a besoin.
Le SMS se vend au volume : plus le pack est gros, plus le prix unitaire baisse. Vos clients, pris un par un, envoient trop peu pour accéder aux meilleurs paliers. Vous, en regroupant leurs envois, y accédez. La différence entre votre prix d'achat et le prix auquel vous revendez les packs dans votre logiciel est votre marge.
| Exemple | |
|---|---|
| Vous achetez 100 000 SMS au palier le plus bas de la grille publique | 100 000 × 0,042 € HT = 4 200 € HT |
| Vous revendez des packs de 500 SMS dans votre logiciel, au prix que vous fixez — ici 0,08 € HT le SMS | 200 packs × 40 € = 8 000 € HT |
| Votre marge brute sur ces envois | 3 800 € HT |
Le prix de revente est un exemple : c'est vous qui le fixez, selon votre marché et la valeur que le SMS apporte dans votre logiciel. Côté achat, c'est la grille publique, dégressive selon le volume, de 0,065 € HT l'unité sur le pack de 1 000 à 0,042 € HT au-delà de 100 000, sans abonnement, avec des crédits qui n'expirent pas tant que le compte est utilisé.
La création se fait par un seul appel, authentifié avec les identifiants de votre super compte : X-APP-ID et X-API-KEY, dans les en-têtes. Le déclencheur dépend de votre modèle : à l'inscription d'un client sur votre logiciel, ou seulement le jour où il achète son premier pack de SMS.
curl -X POST https://api.conexteo.com/subaccount \
-H "X-APP-ID: $CONEXTEO_APP_ID" \
-H "X-API-KEY: $CONEXTEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "contact@salon-lila.fr",
"social_reason": "Salon Lila",
"firstName": "Lila",
"lastName": "Martin",
"phoneNumber": "0606060606",
"credits_mode": "self"
}'La réponse contient l'identifiant du sous-compte et, surtout, ses propres identifiants d'API :
{
"subaccount_id": 1842,
"email": "contact@salon-lila.fr",
"social_reason": "Salon Lila",
"credits_mode": "self",
"appId": "EXEMPLE-APPID-1842",
"apikey": "EXEMPLE-APIKEY-1842"
}Enregistrez appId et apikey tout de suite, chiffrés, rattachés à votre client. Ce sont eux qui serviront à envoyer ses messages. Le champ email est le seul obligatoire ; si vous n'envoyez pas de password, il est généré automatiquement — votre client n'a pas besoin de se connecter à Conexteo pour que tout fonctionne.
Gardez le subaccount_id. C'est lui qui sert à créditer le compte, à changer son mode de consommation et à rapprocher le rapport mensuel de vos propres fiches clients.
Le champ credits_mode décide d'où viennent les crédits consommés par le sous-compte. Il se fixe à la création et se change ensuite par l'API.
| Mode | D'où viennent les crédits | Quand l'utiliser |
|---|---|---|
| self | Du sous-compte lui-même. Il dispose des crédits que vous lui attribuez, ou de ceux qu'il achète. | Vous vendez des packs dans votre logiciel et voulez qu'un client ne consomme que ce qu'il a payé. |
| parent | De votre super compte. Le sous-compte puise directement dans vos crédits. | Le SMS est inclus dans votre abonnement, et vous refacturez la consommation réelle en fin de mois. |
En mode self, quand un client achète un pack de 500 SMS dans votre logiciel, votre application crédite son sous-compte :
curl -X PUT https://api.conexteo.com/subaccount/1842/credits/add \
-H "X-APP-ID: $CONEXTEO_APP_ID" \
-H "X-API-KEY: $CONEXTEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "quantity": 500 }'L'appel symétrique, PUT /subaccount/{id}/credits/remove, retire des crédits, par exemple après un remboursement. GET /subaccount/{id}/credits renvoie le solde, pour l'afficher dans l'interface de votre client. Et PUT /subaccount/{id}/credits/mode, avec { "value": "parent" }, fait basculer un client d'un mode à l'autre, par exemple quand il passe à une formule tout compris.
Pour envoyer un SMS de votre client, votre application appelle l'endpoint d'envoi habituel avec les identifiants du sous-compte, pas ceux du super compte. Le message est décompté de ses crédits, ou des vôtres en mode parent, et rangé dans son historique.
curl -X POST https://api.conexteo.com/messages/sms \
-H "X-APP-ID: $APPID_DU_CLIENT" \
-H "X-API-KEY: $APIKEY_DU_CLIENT" \
-H "Content-Type: application/json" \
-d '{
"content": "Rappel : votre rendez-vous demain à 10h au Salon Lila.",
"sender": "SalonLila",
"recipients": ["+33612345678"]
}'Tout ce qui existe pour un compte existe pour un sous-compte. Le RCS, les listes de contacts, les modèles de messages, la gestion des STOP et les webhooks d'accusés de réception s'utilisent avec les identifiants du sous-compte. Les guides par langage — PHP, Python, Node.js, C# et Go — s'appliquent tels quels.
Chaque fin de mois, Conexteo envoie à votre super compte un rapport de consommation détaillé par sous-compte. Vous savez combien chaque client a envoyé, et vous facturez sur cette base : au réel en mode parent, ou en contrôle de ce que vous avez vendu en mode self.
Conexteo vous facture vos achats de crédits ; la facturation de vos clients reste la vôtre, à votre prix et dans votre outil. C'est ce qui vous laisse la relation commerciale et la marge.
Le cloisonnement compte aussi pour la conformité : un client qui répond STOP à un salon n'est pas retiré des envois d'un autre salon équipé de votre logiciel. Le cadre du consentement et des désinscriptions est détaillé dans le guide RGPD et SMS marketing.
| Vous êtes… | Ce que vous faites des sous-comptes | La page pour vous |
|---|---|---|
| Éditeur de logiciel | Votre application les crée et les pilote par l'API, intégrés à votre produit | Cette page |
| Agence ou revendeur | Vous gérez les campagnes de vos clients, éventuellement sous votre propre marque | Agences & marque blanche |
| Réseau multi-sites | Le siège organise les envois de ses propres filiales ou franchisés | SMS multi-filiales |
Ce que l’API ne fait pas à votre place. Elle ne facture pas vos clients : le rapport mensuel vous donne les volumes, la facture reste à émettre depuis votre outil. Elle ne crée pas non plus d'agent RCS automatiquement : le nom et le logo affichés dans un message RCS sont ceux d'un agent vérifié, et un agent correspond à une marque. Si vos clients veulent envoyer du RCS sous leur propre nom, chacun a besoin de son agent — 150 € HT une fois, 2 à 4 semaines de validation, dossier monté par Conexteo. Voir l’agent RCS.
Inscription gratuite, 5 messages de test. Testez l'envoi avec vos propres identifiants.
Conexteo active la création de sous-comptes sur votre compte.
POST /subaccount à l'inscription, credits/add à l'achat d'un pack, /messages/sms à l'envoi.
Rapprochez le rapport de consommation de vos fiches clients et émettez vos factures.
En faisant de votre compte Conexteo un super compte, puis en créant par l'API un sous-compte pour chaque client avec POST /subaccount. La réponse fournit les identifiants d'API propres au client, que votre logiciel utilise pour envoyer ses messages. Chaque client a ainsi ses contacts, ses modèles et ses désinscriptions, sans s'inscrire lui-même chez Conexteo.
Oui. L'appel POST /subaccount, authentifié avec les identifiants du super compte, crée le sous-compte et renvoie son subaccount_id, son appId et son apikey. Seul l'e-mail est obligatoire ; le mot de passe est généré automatiquement s'il n'est pas fourni. Vous pouvez déclencher l'appel à l'inscription ou au premier achat de SMS.
Vous achetez les crédits en gros au tarif dégressif de Conexteo, puis vous revendez des packs plus petits dans votre logiciel au prix que vous fixez. Votre application crédite le sous-compte du client à chaque achat, et le rapport de consommation mensuel par sous-compte vous permet de contrôler et de facturer. La différence entre prix d'achat et prix de revente constitue votre marge.
En mode self, le sous-compte consomme ses propres crédits, ceux que vous lui avez attribués ou qu'il a achetés. En mode parent, il puise directement dans les crédits du super compte. Le mode se choisit à la création et se change ensuite avec PUT /subaccount/{id}/credits/mode.
Conexteo envoie chaque fin de mois au super compte un rapport de consommation détaillé par sous-compte. En cours de mois, l'appel GET /subaccount/{id}/credits renvoie le solde de crédits d'un client, que vous pouvez afficher dans votre logiciel.
Non. L'API est une REST en JSON sur HTTPS, authentifiée par deux en-têtes, X-APP-ID et X-API-KEY. N'importe quel client HTTP suffit, dans n'importe quel langage. Des guides de code existent pour PHP, Python, Node.js, C# et Go.
La grille publique s'applique selon le volume acheté, sans abonnement : de 0,065 € HT le SMS sur le pack de 1 000 à 0,042 € HT au-delà de 100 000, avec des crédits qui n'expirent pas tant que le compte est utilisé.
Oui, à condition que chacun ait son agent RCS. Le nom et le logo affichés dans un message RCS sont ceux d'un agent vérifié, et un agent correspond à une marque. La création coûte 150 € HT une seule fois, la validation prend 2 à 4 semaines, et Conexteo monte le dossier. Les mobiles qui ne lisent pas le RCS reçoivent automatiquement le message en SMS.
Créez votre compte, testez l'API avec 5 messages offerts, puis demandez le passage en super compte.