Gestion des Noms d’Expéditeur SMS

Le nom d’expéditeur (senderId) est l’identité affichée sur les SMS envoyés. Il est limité à 11 caractères alphanumériques et nécessite une validation par les opérateurs téléphoniques.

Utilisation

Après avoir initialisé votre SDK, vous pouvez utiliser la propriété sender pour gérer vos noms d’expéditeur.

Création d’un nom d’expéditeur

lib/services/sender_service.dart


import 'package:mon_sms_pro/mon_sms_pro.dart';
 
Future<void> createSender() async {
  try {
    final res = await sms.sender.create(
      name: 'MonShop',
      description: 'Notifications e-commerce',
    );
 
    if (res.success) {
      print('Sender créé: ${res.data?.name}');
      print('Statut: ${res.data?.status}'); // PENDING
    }
  } catch (error) {
    print('Erreur: $error');
  }
}

Un nouveau sender a le statut PENDING jusqu’à validation par les opérateurs. Utilisez sms.sender.list() pour suivre l’état de vos senders.

Liste des noms d’expéditeur

lib/services/sender_service.dart


Future<void> listSenders() async {
  try {
    // Récupère la liste paginée des senders
    final res = await sms.sender.list(
      count: 20,
      page: 1,
      sort: SortList.desc,
    );
 
    if (res.success) {
      for (final sender in res.data ?? []) {
        print('${sender.name} - ${sender.status}');
      }
    }
  } catch (error) {
    print('Erreur: $error');
  }
}

Campagnes par expéditeur

Pour récupérer les campagnes associées à un sender, utilisez sms.campaign.list :


Future<void> getSenderCampaigns(String senderId) async {
  final res = await sms.campaign.list(
    senderId: senderId,
  );
 
  if (res.success) {
    for (final campaign in res.data ?? []) {
      print('${campaign.text} - ${campaign.type}');
    }
  }
}

Documentation de l’API

sms.sender.create

Crée un nouveau nom d’expéditeur.

Nom	Description	Type	Facultatif
name	Nom de l’expéditeur (3-11 caractères)	String	Non
description	Description pour les opérateurs	String	Non
example	Exemple de message	String?	Oui
types	Types de SMS autorisés	List<String>?	Oui
companyId	Identifiant de l’entreprise	String?	Oui

sms.sender.list

Récupère la liste de vos noms d’expéditeurs avec pagination.

sms.sender.get

Récupère les détails d’un sender par son identifiant.

sms.sender.update

Archive ou restaure un sender.


final res = await sms.sender.update(
  id: 'sender_id',
  archived: true, // Archive le sender
);

Statuts des Senders

Statut	Description
`PENDING`	En attente de soumission
`SUBMITED`	Soumis aux opérateurs
`ACCEPTED`	Validé et utilisable
`REFUSED`	Refusé par les opérateurs