Gestion des Groupes SMS

Les groupes permettent d’organiser vos contacts pour des campagnes SMS ciblées. Notre SDK Dart offre des méthodes complètes pour créer, lister, mettre à jour et supprimer vos groupes.

Utilisation

Après avoir initialisé votre SDK, utilisez la propriété group pour gérer vos groupes.

Création d’un groupe

lib/services/group_service.dart


import 'package:mon_sms_pro/mon_sms_pro.dart';
 
Future<void> createGroup() async {
  try {
    final res = await sms.group.create(
      name: 'Clients Premium',
      contacts: [
        ContactModel(phone: '22500000000', name: 'John Doe'),
        ContactModel(phone: '22500000001', name: 'Jane Doe'),
      ],
    );
 
    if (res.success) {
      print('Groupe créé: ${res.data?.name}');
    }
  } catch (error) {
    print('Erreur: $error');
  }
}

Liste des groupes


Future<void> listGroups() async {
  final res = await sms.group.list(
    count: 20,
    page: 1,
    sort: SortList.desc,
    orderBy: 'createdAt',
  );
 
  if (res.success) {
    for (final group in res.data ?? []) {
      print('${group.name} - ${group.count?.contacts} contacts');
    }
  }
}

Détails d’un groupe


Future<void> getGroupDetails(String groupId) async {
  final res = await sms.group.get(
    id: groupId,
  );
 
  if (res.success) {
    final group = res.data;
    print('Groupe: ${group?.name}');
    print('Contacts: ${group?.contacts?.length}');
  }
}

Contacts d’un groupe


Future<void> getGroupContacts(String groupId) async {
  final res = await sms.group.getContacts(
    groupId: groupId,
    page: 1,
    count: 50,
  );
 
  if (res.success) {
    for (final contact in res.data ?? []) {
      print('${contact.name} - ${contact.phone}');
    }
  }
}

Mise à jour d’un groupe


Future<void> updateGroup(String groupId) async {
  final res = await sms.group.update(
    id: groupId,
    name: 'Nouveau Nom',
    contacts: [
      ContactModel(phone: '22500000000', name: 'John'),
    ],
  );
 
  if (res.success) {
    print('Groupe mis à jour');
  }
}

Suppression d’un groupe


Future<void> deleteGroup(String groupId) async {
  final res = await sms.group.delete(
    id: groupId,
  );
 
  if (res.success) {
    print('Groupe supprimé');
  }
}

Le SDK fournit six méthodes pour les groupes : create, list, get, getContacts, update et delete.

Documentation de l’API

sms.group.create

Crée un nouveau groupe de contacts.

Nom	Description	Type	Facultatif
name	Nom du groupe	String	Non
contacts	Liste des contacts du groupe	List<ContactModel>	Non
companyId	Identifiant de l’entreprise (auto-injecté depuis la config SDK)	String?	Oui

Si vous avez configuré companyId lors de l’initialisation du SDK, il sera automatiquement injecté dans les appels. Vous n’avez pas besoin de le passer manuellement.

sms.group.list

Récupère la liste paginée de vos groupes.

sms.group.get

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

sms.group.getContacts

Récupère les contacts d’un groupe avec pagination.

sms.group.update

Met à jour le nom et les contacts d’un groupe.

sms.group.delete

Supprime un groupe par son identifiant.