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": null,
    "sender_id": "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 verifie. Configurez votre Sender ID depuis Parametres > Conformite.
Les operateurs francais bloquent les SMS envoyes depuis des numeros mobiles standards (+33 6xx / +33 7xx) via API. Vous devez utiliser un Sender ID alphanumerique ou un numero court (Short Code) pour envoyer des SMS professionnels en France.

​
Pourquoi les numeros mobiles standards ne fonctionnent pas

Les operateurs francais (Orange, SFR, Bouygues Telecom, Free Mobile) interdisent l’utilisation de numeros mobiles pour les SMS professionnels. L’ARCEP — le regulateur des telecoms en France — a formalise cette interdiction en janvier 2023.Si vous essayez d’envoyer un SMS depuis un numero +33 6 ou +33 7 via API, les operateurs bloquent le message au niveau du reseau. Les numeros qui depassent les seuils de volume sont automatiquement suspendus.Allo propose deux alternatives conformes : Sender ID alphanumerique et Short Code.

​
Vos options

​
Sender ID alphanumerique

Votre SMS affiche un nom textuel personnalise (jusqu’a 11 caracteres) au lieu d’un numero de telephone. Par exemple, vos destinataires voient “MOBILEFIRST” au lieu de +33 6 12 34 56 78.Ideal pour : Les rappels de rendez-vous, confirmations de commande, notifications de paiement et campagnes marketing unidirectionnelles.Regles de formatage :
  • 3 a 11 caracteres
  • Lettres (A-Z, a-z) et chiffres (0-9) uniquement
  • Doit contenir au moins une lettre
  • Pas d’espaces ni de caracteres speciaux
Limitation principale : Les destinataires ne peuvent pas repondre.Delai de mise en place : 1 a 5 jours ouvrables.

​
Short Code (numero a 5 chiffres)

Un numero dedie ou partage a 5 chiffres (ex. 36xxx pour le marketing, 38xxx pour les messages transactionnels).Ideal pour : Les conversations bidirectionnelles, le service client, les campagnes par mots-cles et le marketing a haut volume avec gestion native du STOP.Avantage principal : Les destinataires peuvent repondre.Delai de mise en place : 2 a 4 mois pour un code dedie. Quelques jours a quelques semaines pour un code partage.
La plupart des petites entreprises commencent avec un Sender ID alphanumerique. Ajoutez un Short Code plus tard si vous avez besoin de messagerie bidirectionnelle.

​
Regles de conformite SMS en France

Consentement :
  • B2C : Consentement explicite (opt-in) requis.
  • B2B : Pas de consentement prealable requis, mais le message doit etre en lien avec l’activite professionnelle du destinataire.
Restrictions horaires (SMS marketing uniquement) :
  • Pas de SMS marketing le dimanche ni les jours feries francais
  • Pas de SMS marketing entre 20h00 et 08h00
Mecanisme STOP : Chaque SMS marketing doit inclure des instructions de desabonnement.

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