Gestion des Listes
L'utilisation des listes proposée par les fournisseurs de service SMS peut être très utile :
- Elle décharge de le serveur du site SPIP. Plutôt qu'envoyer dans une tache cron de multiples SMS, un serveur dédié s'en charge avec la liste créée. SPIP n'a plus qu'à passer commande, dans le sens propre du terme.
- Elle permet d'avoir des informations personnalisées liées au contact. Ces informations peuvent ensuite être affichées à l'intérieur de chaque message SMS, comme des champs lors d'une opération de fusion / publipostage sous un traitement de texte. Cela évite de redévelopper cela sous SPIP
- Elle permet de gérer les NPAI et les Listes noires, ce qui est précieux, notamment pour nettoyer les tables concernées sous SPIP.
Je vais vous proposer une demande d'ajout (une branche) avec :
- une petite fonction
lister_sms
(presque aussi simple queenvoyer_sms
mais avec un retour plus explicite qu'un booléen). Elle pourra être déclinée pour d'autres API que SMSFactor (si quelqu'un veut s'y coller). - des squelettes en
inclure
pour visualiser la liste des listes... - des actions pour supprimer des listes...
- une configuration qui rappelle discrètement les listes disponibles (et leurs identifiants).
La fonction lister_sms
répond aux instructions suivantes :
creer
Cette commande vous permet de créer et de peupler une liste.
@link https://dev.smsfactor.com/en/api/sms/list/create-list
annuaire
Cette commande vous permet d'avoir une liste des listes.
@link https://dev.smsfactor.com/en/api/sms/list/get-lists
lister
Cette commande vous permet de lire une liste de contacts.
@link https://dev.smsfactor.com/en/api/sms/list/get-list
nettoyer
Cette commande vous permet d'ajouter le NPAI de votre liste d'envoi
dans votre liste NPAI et de supprimer le NPAI dans la liste d'envoi.
@link https://dev.smsfactor.com/en/api/sms/list/clear
npai
La phrase « n'habite plus à l'adresse indiquée » (NPAI),
signifie que le SMS ne peut parvenir à destination
Cette commande vous permet de récupérer votre liste NPAI.
supprimer_liste
Cette commande vous permet de détruire une liste de contacts.
@link https://dev.smsfactor.com/en/api/sms/list/delete-list
liste_noire
Cette commande vous permet de récupérer votre liste noire.
Un contact qui répond STOP ou se désabonne via le lien STOP
sera automatiquement déplacé dans votre liste noire.
@link https://dev.smsfactor.com/en/api/sms/list/get-blacklist
Il est à noter que j'ai développé une class
plutôt que de reprendre tout le SDK proposé par SMSFactor. Est-ce pertinent ? Vous me direz...