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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://help.withallo.com/llms.txt

Use this file to discover all available pages before exploring further.

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