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	String?	Oui

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.