Allo

Envoyer un SMS (France)

Pour envoyer des SMS en France, vous avez besoin d'un nom d'expediteur declare, ce que les operateurs appellent un Sender ID. Declarez-le depuis Parametres…

POST/v1/api/sms
Pourquoi un Sender ID verifie est necessaire

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.


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.

Autorisation

Authorizationstring · headerrequis

Scope needed: SMS_SEND

Corps

fromstringrequis

Your Allo phone number (must be owned by your account)

tostringrequis

Recipient phone number (E.164 format, same country as 'from')

messagestringrequis

Message content

Réponses

200SMS sent successfully
dataobject

Sent SMS message details

6 champs
from_numberstring | null

Phone number that sent the message. Null when sender_id is used instead.

sender_idstring | null

Sender ID used for the message (alphanumeric identifier). Only populated when sending with a verified Sender ID (e.g., for France SMS). Null when from_number is used.

to_numberstring

Phone number that received the message

typeenum<string>

Direction of the message (always OUTBOUND for sent messages)

OUTBOUND

contentstring

Content of the SMS message

start_datestring<date-time>

When the message was sent

400Bad request
codestring

Error code identifying the type of error

detailsobject[]

Additional error details, or null if not applicable

2 champs
messagestring
fieldstring
401
403
429