Passer au contenu principal
POST
Declare sender ID
Scope requis : PARTNER
Déclare un Sender ID alphanumérique sur l’un de vos comptes, pour que le compte envoie des SMS sous le nom de sa marque plutôt que depuis un numéro. En France, les SMS automatisés ne peuvent pas partir d’un numéro mobile : le Sender ID est donc ce qui permet à votre logiciel d’écrire aux clients du compte. La réponse renvoie le Sender ID avec le statut PENDING.

Requête

  • sender_id est requis : 1 à 11 lettres ou chiffres, sans espace ni symbole, par exemple PLOMBMARTIN. Une valeur absente échoue avec MISSING_FIELD, tout autre format avec SENDER_ID_INVALID_FORMAT. Le nom doit représenter l’activité réelle du compte, voir les règles de nommage du Sender ID.
  • example_content est optionnel : un exemple de message que le compte enverra, jusqu’à 1 000 caractères. Le relecteur d’Allo le lit. Une valeur plus longue échoue avec EXAMPLE_CONTENT_TOO_LONG.

Règles

  • Un Sender ID n’appartient qu’à un seul compte Allo. Un nom déjà détenu par un autre compte Allo échoue avec 409 SENDER_ID_ALREADY_EXISTS.
  • Un compte détient au plus 3 Sender ID. Un quatrième échoue avec 409 MAX_SENDER_IDS_REACHED.
  • Renvoyer le même sender_id pour le même compte renvoie le Sender ID existant : une nouvelle tentative est sans risque.
  • Vous ne pouvez déclarer des Sender ID que sur les comptes créés par votre propre clé API. Tout autre compte renvoie 404 PARTNER_ACCOUNT_NOT_FOUND.

Validation

Allo valide chaque Sender ID à la main, en général en 1 à 5 jours ouvrés. À la fin de la validation, Allo envoie partner.sender_id.validated ou partner.sender_id.failed à votre propre endpoint webhook. Sans endpoint webhook, interrogez Obtenir un Sender ID. Une fois le Sender ID VALIDATED, le compte envoie des SMS avec lui via Envoyer un SMS (France).

Autorisations

Authorization
string
header
requis

Paramètres de chemin

account_id
string
requis

The account id returned by Create account (usr-*).

Corps

application/json
sender_id
string
requis

1 to 11 letters or digits, with no spaces or symbols. It must not belong to another Allo account.

Required string length: 1 - 11
Exemple:

"PLOMBMARTIN"

example_content
string | null

Optional. An example of a message the account will send, shown to the Allo reviewer.

Maximum string length: 1000
Exemple:

"Bonjour, votre intervention est confirmée demain à 9h. Plomberie Martin"

Réponse

Sender ID declared, waiting for Allo's review

data
object

An alphanumeric sender ID declared on an account you provisioned.