✆ 01 76 41 10 75

Guide d'installation

Installer le connecteur Conexteo sur Make : SMS, RCS et webhooks

De la connexion au premier scénario, puis aux accusés de réception et aux réponses entrantes. Onze modules, aucune ligne de code, et les deux pièges qui font perdre du temps si personne ne les a signalés.

C Envoyer un SMS
Connexion
Mon compte Conexteo
Contenu du SMS
Bonjour prénom, votre commande est prête.
Destinataires
téléphone
Estimer sans envoyer
OK

L'écran que vous allez remplir :
trois champs pour un premier envoi

Ce que le connecteur met à disposition

Onze modules, répartis en trois familles : les envois, les lectures, et les déclencheurs qui démarrent un scénario quand il se passe quelque chose côté mobile. Les noms techniques ci-dessous sont ceux qui apparaissent dans le sélecteur de modules de Make.

ENVOYER
Cinq modules d'envoi

Un SMS simple, un RCS texte, une carte RCS avec image et boutons, un carrousel de deux à dix cartes. Chaque envoi RCS peut porter un repli SMS, utilisé automatiquement si le destinataire n'est pas compatible.

Envoyer un SMS
Envoyer un RCS texte
Envoyer une carte RCS
Envoyer un carrousel RCS
LIRE
Crédits, historique, appel libre

De quoi conditionner un scénario au solde restant, parcourir l'historique des envois, ou appeler n'importe quel endpoint de l'API sans attendre qu'un module dédié existe.

Lire les crédits du compte
Rechercher des messages
Effectuer un appel API
DÉCLENCHER
Trois déclencheurs instantanés

Le scénario démarre à la seconde où l'événement arrive : un accusé de réception, une réponse de votre destinataire, ou un statut RCS. Pas d'interrogation périodique, pas de délai.

Nouvel accusé de réception SMS
Nouvelle réponse entrante
Nouveau statut RCS

Le connecteur est gratuit. Vous ne payez que les messages effectivement envoyés, sans abonnement ni engagement, en packs prépayés ou en postpaiement. L'inscription est gratuite et comprend cinq messages de test, sans carte bancaire. Les tarifs détaillés sont sur la page tarifs SMS et la page tarifs RCS.

Prérequis

Un compte Make, quel que soit le forfait, y compris le gratuit. Un compte Conexteo, gratuit également. Pour les envois RCS, un agent RCS vérifié : Conexteo se charge de la création et du dossier auprès de Google, comptez deux à quatre semaines de validation. En attendant, vos envois partent en SMS classique, sans rien changer à vos scénarios.

Installation, étape par étape

ÉTAPE 1
Ajouter le connecteur à votre espace Make

Le connecteur Conexteo se rejoint par lien d'invitation : ouvrez le lien d'ajout en étant connecté à Make, et confirmez. Le connecteur apparaît ensuite dans le sélecteur de modules de tous vos scénarios, sous le nom Conexteo, exactement comme une application du catalogue.

ÉTAPE 2
Récupérer vos deux identifiants Conexteo

Dans votre compte Conexteo, ouvrez l'onglet Développeurs, section API. Deux valeurs y figurent : la Clef API, longue, et l'App ID, courte. Gardez-les sous la main, vous allez les coller une seule fois.

ÉTAPE 3
Créer la connexion

Ajoutez un module Conexteo dans un scénario, puis cliquez sur Create a connection. Collez la Clef API dans le champ du même nom, l'App ID dans le sien, validez. Make vérifie immédiatement les identifiants en interrogeant votre solde de crédits : si la connexion se crée, c'est qu'elle fonctionne. Vous la réutiliserez dans tous vos scénarios, sans la ressaisir.

Le piège : une connexion refusée alors que les identifiants sont bons

Le symptôme est déroutant : Make refuse la connexion, vous vérifiez vos deux valeurs, elles sont exactes, vous recommencez, même refus. Neuf fois sur dix, la Clef API et l'App ID ont été intervertis. Les deux champs se ressemblent à l'écran et un copier-coller rapide les échange sans qu'on s'en aperçoive.

Le moyen de ne plus se tromper : la Clef API est la longue, l'App ID est la courte. Un coup d'œil à la longueur des deux chaînes avant de valider suffit à éliminer la question.

ÉTAPE 4
Envoyer votre premier SMS

Choisissez le module Envoyer un SMS. Trois champs suffisent : le contenu, les destinataires et l'expéditeur. Les destinataires se saisissent au format national (0606060606) ou international (+33606060606), et se mappent naturellement depuis le module précédent de votre scénario.

Avant le premier envoi réel, cochez Estimer sans envoyer : le module renvoie le nombre de crédits nécessaires, les doublons repérés et les destinataires en liste d'opposition, sans rien expédier. C'est la façon la plus sûre de valider un scénario de masse avant de le lancer.

ÉTAPE 5
Passer au RCS

Les modules RCS fonctionnent de la même manière, avec deux différences à connaître. Il n'y a pas de champ expéditeur : c'est l'agent RCS vérifié de votre compte qui est assigné automatiquement, et c'est précisément ce qui affiche votre nom et votre logo dans la conversation. Et les images doivent être en PNG ou JPG : le WebP est refusé par l'API, ce qui surprend souvent parce que beaucoup d'outils convertissent en WebP sans le dire.

Renseignez le repli SMS dans chaque module RCS. Les 15 % de destinataires non compatibles recevront ce texte en SMS classique, la décision étant prise destinataire par destinataire au moment de l'envoi. Sans repli renseigné, ces destinataires ne reçoivent rien.

ÉTAPE 6
Brancher les accusés de réception et les réponses

Placez l'un des trois déclencheurs en tête d'un nouveau scénario, créez le webhook, et copiez l'URL que Make vous affiche. Retournez dans Conexteo, onglet Développeurs, section Webhooks, et collez cette URL dans le champ correspondant : accusés de réception SMS, réponses entrantes, ou statuts RCS.

Activez le mode signé avant d'enregistrer. Ce n'est pas une option de confort, c'est ce qui détermine si vos événements arrivent : voir l'encadré ci-dessous.

Le piège : des événements qui disparaissent sans la moindre erreur

Un webhook non signé n'est envoyé qu'une seule fois. S'il échoue — scénario en pause, maintenance Make, un délai réseau de trop — l'événement est perdu définitivement, et rien ne le signale nulle part. Un webhook signé est réessayé jusqu'à huit fois sur environ dix-huit heures. C'est la différence entre perdre des accusés de réception en silence et n'en perdre aucun.

Deuxième surprise, liée : chaque champ d'URL est unique pour tout le compte Conexteo. Coller une nouvelle URL remplace celle qui s'y trouvait. Si vos accusés de réception arrivaient bien puis se sont arrêtés d'un coup, commencez par vérifier que quelqu'un n'a pas branché un autre scénario — ou un autre outil — sur le même champ.

À retenir : mode signé systématiquement, et un seul scénario Make par type d'événement et par compte.

Référence des champs

Les champs du module Envoyer un SMS, le plus utilisé. Les modules RCS reprennent la même logique, avec les spécificités décrites plus haut.

ChampRequisDescription
Contenu du SMSOuiLe texte du message. Accepte les variables mappées depuis les modules précédents.
DestinatairesOuiListe de numéros, au format national ou international.
ExpéditeurNonOnze caractères maximum. Vide, l'expéditeur par défaut du compte s'applique.
Envoyer leNonProgramme l'envoi à une date et une heure, interprétées en UTC. Vide, l'envoi est immédiat.
Identifiant externeNonVotre propre référence. Conexteo refuse un second envoi portant le même identifiant, ce qui protège des doublons si un scénario est rejoué.
Lien raccourciNonRaccourcit une URL dans le message, avec un lien commun ou un lien distinct par destinataire.
Estimer sans envoyerNonRenvoie crédits nécessaires, doublons et destinataires en opposition, sans expédier.

Ce que le module renvoie

Chaque envoi renvoie un identifiant de message, à conserver si vous voulez relier plus tard un accusé de réception à l'envoi qui l'a produit, ainsi que le nombre de crédits consommés. En mode estimation, les champs de comptage remplacent ces valeurs.

ErreurCause probable
Identifiants invalidesClef API et App ID intervertis, ou clé régénérée depuis la création de la connexion. Recréez la connexion.
Crédits insuffisantsLe message indique les crédits requis et les crédits restants. Rechargez le compte ; le scénario reprend seul.
Requête invalideContenu vide, expéditeur de plus de onze caractères, ou numéro mal formé.
Doublon refuséUn envoi portant le même identifiant externe a déjà été traité. C'est le garde-fou anti-doublon qui joue son rôle.
Service indisponibleIncident temporaire côté envoi. Make applique un délai et réessaie automatiquement, sans intervention.

Les contraintes RCS à connaître avant de construire

Le RCS n'est pas un SMS enrichi sans limites : la norme impose des bornes que l'API applique strictement. Les connaître avant de concevoir un message évite de découvrir un refus au moment de l'envoi.

ÉlémentLimiteConséquence pratique
ImagesPNG ou JPGLe WebP est refusé. Vérifiez le format réellement servi par votre hébergeur, pas l'extension dans l'URL.
Boutons4 maximumTitre de 25 caractères au plus. Au-delà, le libellé est tronqué à l'affichage : écrivez court dès la conception.
Carrousel2 à 10 cartesUne seule carte n'est pas un carrousel : utilisez le module carte. Au-delà de dix, découpez en deux envois.
ExpéditeurAucun champL'agent RCS vérifié du compte s'applique. Le champ n'existe que sur le repli SMS.

Trois scénarios pour démarrer

Les trois assemblages qui reviennent le plus souvent, et qui se construisent chacun en moins d'un quart d'heure une fois la connexion créée.

01
Confirmation après un formulaire

Un module de réception de formulaire, puis Envoyer un SMS. Le numéro se mappe depuis le champ du formulaire, le prénom s'insère dans le texte. C'est le scénario à deux modules qui sert de test de bout en bout : s'il fonctionne, votre connexion est bonne.

02
Rappel de rendez-vous programmé

Un déclencheur d'agenda, puis Envoyer un SMS avec le champ Envoyer le renseigné à la veille du rendez-vous. Conexteo garde le message et l'expédie à l'heure dite : inutile de faire tourner un scénario en attente. Pensez à raisonner en UTC.

03
Traiter les réponses de vos clients

Le déclencheur Nouvelle réponse entrante en tête de scénario, puis un routeur : une branche qui crée une tâche quand le client répond en texte libre, une autre qui met à jour une fiche quand il clique sur une suggestion RCS. Les deux cas se distinguent par un simple booléen en sortie du déclencheur.

Attention aux horaires sur les envois promotionnels. Un scénario tourne aussi la nuit et le dimanche : c'est tout l'intérêt de l'automatisation, et c'est aussi son risque. Les messages promotionnels s'envoient du lundi au vendredi de 8h à 20h et le samedi de 10h à 19h, dimanches et jours fériés exclus. Ces créneaux relèvent des recommandations de la CNIL et des usages du secteur, pas d'un décret : le décret sur les plages horaires vise le démarchage téléphonique. Les messages transactionnels — confirmation, rappel, accusé — ne sont pas concernés. Un filtre sur l'heure en amont de votre module d'envoi suffit à tenir la règle. Voir RGPD et SMS marketing.

Questions fréquentes sur l'installation

Où trouver la Clef API et l'App ID dans mon compte Conexteo ?
Dans l'onglet Développeurs de votre compte, section API. Les deux valeurs y sont affichées ensemble. La Clef API est la chaîne longue, l'App ID la chaîne courte : c'est le repère le plus fiable pour ne pas les intervertir, l'erreur la plus fréquente à la création d'une connexion.
Pourquoi mon image RCS est-elle refusée alors que le fichier s'affiche correctement ?
Parce qu'elle est probablement au format WebP. L'API n'accepte que le PNG et le JPG, et de nombreux outils — gestionnaires de médias, CDN, exports d'e-commerce — convertissent automatiquement en WebP sans que l'extension du fichier change dans l'URL. Vérifiez le format réellement servi, et hébergez l'image en PNG ou JPG si nécessaire.
Pourquoi n'y a-t-il pas de champ expéditeur sur les modules RCS ?
Parce qu'en RCS l'expéditeur n'est pas un texte libre : c'est l'agent RCS vérifié de votre compte, assigné automatiquement. C'est cette vérification qui permet d'afficher votre nom, votre logo et la pastille de validation dans la conversation. Le champ expéditeur n'existe que sur le repli SMS, où il redevient une chaîne de onze caractères.
Puis-je faire tourner plusieurs scénarios Make sur les accusés de réception ?
Non, pas sur le même compte Conexteo. Chaque type d'événement dispose d'un seul champ d'URL dans la configuration du compte : y coller une nouvelle adresse remplace la précédente. Si plusieurs traitements doivent réagir au même événement, faites-les cohabiter dans un seul scénario Make, avec des routeurs — c'est aussi plus simple à superviser.
Comment éviter de traiter deux fois le même accusé de réception ?
Un webhook signé pouvant être réessayé plusieurs fois, le même événement peut vous parvenir en plusieurs exemplaires. Chaque déclencheur expose pour cela un identifiant de livraison, identique entre toutes les tentatives d'un même événement. Stockez-le et ignorez un identifiant déjà vu : c'est le garde-fou prévu pour ça.
Comment tester un scénario d'envoi en masse sans consommer de crédits ?
Cochez Estimer sans envoyer dans le module d'envoi SMS. Le scénario s'exécute normalement, mais aucun message ne part : vous récupérez le nombre de crédits qui seraient consommés, le nombre de destinataires réellement retenus, les doublons détectés et les numéros en liste d'opposition. Décochez la case une fois le résultat conforme à vos attentes.

Votre premier scénario en quelques minutes

Inscription gratuite, cinq messages offerts, sans carte bancaire. Le connecteur est gratuit : vous ne payez que ce que vous envoyez.

Créer un compte gratuitement →
À lire aussi