Passer au contenu principal
POST
/
v1
/
api
/
sms#france
Send SMS (France)
curl --request POST \
  --url 'https://api.withallo.com/v1/api/sms#france' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sender_id": "MyCompany",
  "to": "+33612345678",
  "message": "Bonjour, ceci est un message de test"
}
'
{
  "data": {
    "from_number": "MyCompany",
    "to_number": "+33612345678",
    "type": "OUTBOUND",
    "content": "Bonjour, ceci est un message de test",
    "start_date": "2024-01-15T10:30:00"
  }
}
Pour envoyer des SMS en France, vous avez besoin d’un Sender ID vérifié. Contactez l’équipe Allo pour enregistrer votre Sender ID avant d’utiliser ce endpoint.
Les opérateurs français bloquent les SMS envoyés depuis des numéros mobiles classiques (+33 6xx / +33 7xx) via API. Vous devez utiliser un Sender ID alphanumérique ou un numéro court pour envoyer des SMS professionnels en France.

​
Pourquoi les numéros mobiles classiques ne fonctionnent pas

Les opérateurs français (Orange, SFR, Bouygues Telecom, Free Mobile) interdisent l’utilisation de numéros mobiles pour les SMS professionnels. L’ARCEP — le régulateur des télécoms en France — a formalisé cette interdiction en janvier 2023.Si vous essayez d’envoyer un SMS depuis un numéro +33 6 ou +33 7 via API, les opérateurs bloquent le message au niveau du réseau. Les numéros qui dépassent les seuils de volume sont automatiquement suspendus.Allo propose deux alternatives conformes : Sender ID alphanumérique et Numéro court.

​
Vos options

​
Sender ID alphanumérique

Votre SMS affiche un nom personnalisé (jusqu’à 11 caractères) au lieu d’un numéro de téléphone. Par exemple, vos destinataires voient “MOBILEFIRST” au lieu de +33 6 12 34 56 78.Comment ça marche : Allo envoie votre SMS avec le nom de votre marque comme expéditeur. Les destinataires voient le nom de votre entreprise sur leur téléphone. Aucun numéro de téléphone n’apparaît.Idéal pour : Rappels de rendez-vous, confirmations de commande, notifications de paiement et campagnes marketing unidirectionnelles.Règles de formatage :
  • 3 à 11 caractères
  • Lettres (A-Z, a-z) et chiffres (0-9) uniquement
  • Doit contenir au moins une lettre
  • Pas d’espaces ni de caractères spéciaux
Limitation principale : Les destinataires ne peuvent pas répondre. Pour les SMS marketing, incluez une instruction STOP dans le corps du message (ex. : “STOP au 36179”).Délai de mise en place : 1 à 5 jours ouvrables. Aucun coût supplémentaire au-delà de votre forfait SMS.

​
Configuration

  1. Contacter le support Allo — Contactez l’équipe Allo avec le nom d’expéditeur souhaité (3 à 11 caractères). Exemple : “MOBILEFIRST”.
  2. Vérification de la marque — Allo vérifie votre nom d’expéditeur selon les règles des opérateurs français. Certains noms sont restreints — les termes génériques comme “Alerte” ou “Banque” et les noms de marques protégées (institutions publiques, grandes banques) sont bloqués par l’AF2M.
  3. Activation — Une fois approuvé, Allo active votre Sender ID. Tous les SMS sortants de votre compte affichent le nom de votre marque. Cela prend 1 à 5 jours ouvrables.

​
Numéro court (5 chiffres)

Un numéro dédié ou partagé à 5 chiffres (ex. : 36xxx pour le marketing, 38xxx pour les messages transactionnels). Géré par l’AF2M, l’association multi-opérateurs française.Comment ça marche : Allo envoie votre SMS depuis un numéro à 5 chiffres. Les destinataires peuvent répondre directement à ce numéro.Idéal pour : Conversations bidirectionnelles, service client, campagnes par mot-clé et marketing à haut volume avec gestion native du STOP.Avantage principal : Les destinataires peuvent répondre. Cela permet des conversations directes et le traitement automatique des désinscriptions.Délai de mise en place : 2 à 4 mois pour un code dédié. Quelques jours à quelques semaines pour un code partagé via un agrégateur.Coût : Plus élevé que le Sender ID alphanumérique. Les numéros courts dédiés impliquent des frais de réservation AF2M, des frais de connexion opérateur et des frais d’hébergement mensuels.

​
Configuration

  1. Contacter le support Allo — Indiquez à l’équipe Allo que vous avez besoin d’un numéro court pour la France. Précisez si vous en avez besoin pour le marketing (plage 36xxx) ou les messages transactionnels (plage 38xxx).
  2. Choisir dédié ou partagé — Dédié : Numéro exclusif pour votre entreprise. Coût plus élevé, mise en place plus longue. Partagé : Numéro partagé avec d’autres entreprises via routage par mot-clé. Coût réduit, mise en place plus rapide.
  3. Enregistrement et activation — Allo gère la réservation AF2M et l’intégration opérateur. Pour un code dédié, fournissez un Kbis (extrait d’immatriculation de moins de 3 mois). L’activation prend 2 à 4 mois pour les codes dédiés, ou quelques jours à quelques semaines pour les codes partagés.
La plupart des petites entreprises commencent avec le Sender ID alphanumérique. Ajoutez un numéro court plus tard si vous avez besoin de messagerie bidirectionnelle.

​
Règles de conformité SMS en France

L’envoi de SMS professionnels en France nécessite de respecter trois ensembles de règles : ARCEP (télécoms), CNIL (protection des données) et AF2M (charte sectorielle).Consentement :
  • SMS B2C (consommateur) : Consentement explicite (opt-in) requis avant l’envoi. Les cases pré-cochées sont illégales.
  • SMS B2B (professionnel) : Pas d’opt-in préalable requis, mais le message doit être en rapport avec l’activité professionnelle du destinataire. Vous devez vous identifier et proposer une option de désinscription.
Restrictions horaires (SMS marketing uniquement) :
  • Pas de SMS marketing le dimanche ni les jours fériés français
  • Pas de SMS marketing entre 20h00 et 08h00
  • Les SMS transactionnels (confirmations de commande, OTP, alertes) n’ont pas de restrictions horaires
Mécanisme STOP : Chaque SMS marketing doit inclure des instructions de désinscription. Avec un numéro court, les destinataires répondent “STOP” directement. Avec un Sender ID alphanumérique, incluez une référence au numéro court dans le corps du message (ex. : “STOP au 36179”).Restrictions sur les Sender ID : L’AF2M maintient une liste de noms d’expéditeurs protégés. Les noms usurpant des institutions publiques, des banques ou des grandes marques sont bloqués. Allo vérifie votre nom d’expéditeur lors de la vérification.

​
Questions fréquentes

Puis-je utiliser mon numéro Allo existant pour envoyer des SMS en France ? Non. Les opérateurs français bloquent les SMS envoyés depuis des numéros mobiles classiques (+33 6 / +33 7) via API. Vous avez besoin d’un Sender ID alphanumérique ou d’un numéro court.Les destinataires peuvent-ils répondre à mon Sender ID alphanumérique ? Non. Les Sender ID alphanumériques sont unidirectionnels uniquement. Si vous avez besoin de messagerie bidirectionnelle, utilisez un numéro court.Combien coûte un Sender ID alphanumérique ? Pas de frais de mise en place supplémentaires. Vous payez les tarifs standard par message inclus dans votre plan Business.Combien de temps prend la mise en place d’un numéro court ? Un numéro court dédié prend 2 à 4 mois. Un numéro court partagé via un agrégateur prend quelques jours à quelques semaines. Allo gère le processus pour vous.Quels noms d’expéditeurs sont interdits ? Les termes génériques (“Alerte”, “Banque”, “Livraison”, “Test”) et les noms usurpant des institutions publiques, des banques ou des grandes marques sont bloqués par l’AF2M. Votre nom d’expéditeur doit représenter votre entreprise réelle.Ai-je besoin du consentement pour envoyer des SMS à des contacts professionnels en France ? Pour les contacts B2B, aucun opt-in préalable n’est requis. Le message doit être en rapport avec leur activité professionnelle, vous identifier clairement comme expéditeur et inclure des instructions de désinscription.Puis-je envoyer des SMS marketing à n’importe quelle heure ? Non. Les SMS marketing sont limités aux jours ouvrables (lundi à samedi) entre 08h00 et 20h00, hors jours fériés français. Les SMS transactionnels n’ont pas de restrictions horaires.

Autorisations

​
Authorization
string
header
requis

Scope needed: SMS_SEND

Corps

application/json

Request body for sending an SMS message in France using a verified Sender ID

​
sender_id
string
requis

Your verified Sender ID (must be verified by the Allo team). This is an alphanumeric identifier that will appear as the sender of the SMS.

Exemple:

"MyCompany"

​
to
string
requis

Recipient phone number in France (E.164 format, must start with +33)

Exemple:

"+33612345678"

​
message
string
requis

Message content

Required string length: 1 - 1000
Exemple:

"Bonjour, ceci est un message de test"

Réponse

SMS sent successfully

Standard response wrapper for sent SMS

​
data
object

Sent SMS message details