Gestion des Noms d’Expéditeur SMS

Le nom d’expéditeur (senderId) est un élément crucial pour l’identité de vos SMS. Il permet d’identifier clairement l’origine de vos messages et d’améliorer leur délivrabilité. Le senderId peut représenter votre marque, votre entreprise ou tout autre identifiant pertinent, limité à 11 caractères alphanumériques.

Fonctionnalités

Création de noms d’expéditeur personnalisés
Gestion de plusieurs identifiants
Suivi des campagnes par expéditeur
Validation par les opérateurs téléphoniques
Amélioration de la délivrabilité des SMS

Utilisation

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

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

/api/sender


import { sms } from "@/libs/sms";
 
const createSender = async () => {
  try {
    // Crée un nouveau nom d'expéditeur
    const res = await sms.sender.create({
      name: "My Sender",
      description: "This is the name of my marque",
    });
 
    console.log(res);
  } catch (error) {
    console.error(error);
  }
};
 
const getSenders = async () => {
  try {
    // Récupère la liste des noms d'expéditeurs existants
    const res = await sms.sender.list();
 
    console.log(res);
  } catch (error) {
    console.error(error);
  }
};
 
const getSenderCampain = async () => {
  try {
    // Récupère la liste des campagnes du nom d'expéditeur par son id
    const res = await sms.sender.campains({
      id: "id_of_the_sender",
    });
 
    console.log(res);
  } catch (error) {
    console.error(error);
  }
};

La variable sms est l’instance initialisée de notre SDK. Elle fournit trois méthodes principales pour la gestion des noms d’expéditeur : create pour la création, list pour la liste et campains pour le suivi des campagnes.

Documentation de l’API

sms.sender.create

Crée un nouveau nom d’expéditeur pour vos SMS.

Nom	Description	Type	Facultatif	Valeur par défaut
name	Nom de l’expéditeur entre 3 et 11 caractères	Texte	Non
description	Description fournie aux opérateurs téléphoniques pour valider le nom de l’expéditeur utilisé.	Texte	Non

sms.sender.campains

Récupère la liste des campagnes associées à un nom d’expéditeur spécifique.

Nom	Description	Type	Facultatif	Valeur par défaut
id	Identifiant unique du nom d’expéditeur. Obtenez-le via la méthode `sms.sender.list`, c’est la clé `id` de chaque senderId.	Texte	Non

sms.sender.list

Récupère la liste complète de tous vos noms d’expéditeurs.
Cette méthode ne reçoit aucun argument.

Bonnes pratiques

Nommage : Choisissez des noms d’expéditeur courts et mémorisables
Cohérence : Utilisez le même nom d’expéditeur pour une même campagne
Validation : Attendez la validation par les opérateurs avant d’utiliser un nouveau senderId
Description : Fournissez une description claire pour faciliter la validation
Suivi : Surveillez régulièrement les performances de vos campagnes par expéditeur

Cas d’utilisation

Marketing et campagnes promotionnelles
Notifications transactionnelles
Alertes et communications d’urgence
Service client et support
Rappels et confirmations