Gestion des Contacts SMS

Notre SDK Dart offre des méthodes complètes pour créer, lister, mettre à jour et supprimer vos contacts SMS.

Structure des contacts


ContactModel(
  phone: '0701020304',     // Numéro de téléphone (obligatoire)
  name: 'John Doe',        // Nom complet (optionnel)
  firstName: 'John',       // Prénom (optionnel)
  lastName: 'Doe',         // Nom de famille (optionnel)
  sex: SexType.m,          // Genre M ou F (optionnel)
)

⚠️

Incluez l’indicatif du pays sans le symbole (+) avant le numéro. Exemple : "22500000000" pour un numéro ivoirien.

Utilisation

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

Création de contacts en masse

lib/services/contact_service.dart


import 'package:mon_sms_pro/mon_sms_pro.dart';
 
Future<void> createContacts() async {
  try {
    final res = await sms.contact.create(
      contacts: [
        ContactModel(phone: '22500000000', name: 'John Doe'),
        ContactModel(phone: '22500000001', name: 'Jane Doe', sex: SexType.f),
      ],
    );
 
    if (res.success) {
      print('Contacts créés avec succès');
    }
  } catch (error) {
    print('Erreur: $error');
  }
}

Création d’un contact unique


Future<void> createSingleContact() async {
  final res = await sms.contact.createSingle(
    phone: '22500000000',
    name: 'John Doe',
    firstName: 'John',
    lastName: 'Doe',
  );
 
  if (res.success) {
    print('Contact créé: ${res.data?.name}');
  }
}

Liste des contacts


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

Mise à jour d’un contact


Future<void> updateContact(String id) async {
  final res = await sms.contact.update(
    id: id,
    name: 'Nouveau Nom',
    phone: '22500000002',
  );
 
  if (res.success) {
    print('Contact mis à jour');
  }
}

Suppression de contacts


Future<void> deleteContacts() async {
  final res = await sms.contact.delete(
    contactIds: ['contact_id_1', 'contact_id_2'],
  );
 
  if (res.success) {
    print('Contacts supprimés');
  }
}

Le SDK fournit six méthodes pour les contacts : create (masse), createSingle, list, get, update et delete.

Documentation de l’API

sms.contact.create

Crée un ou plusieurs contacts.

Nom	Description	Type	Facultatif
contacts	Liste des contacts à créer	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.contact.list

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

sms.contact.get

Récupère un contact par son identifiant.

sms.contact.update

Met à jour les informations d’un contact existant.

sms.contact.delete

Supprime un ou plusieurs contacts par leurs identifiants.

sms.contact.createSingle

Crée un seul contact avec tous les champs disponibles.