Es-tu un développeur ? Tu as besoin d’envoyer des SMS par lots, mais tu ne veux pas te donner la peine d’écrire un programme pour faire le travail à ta place ? Eh bien, nous avons une solution pour toi !

L’interface de ligne de commande (CLI) de ClickSend est conçue pour rendre l’automatisation de l’envoi de messages facile et amusante sans avoir à écrire une seule ligne de code.

Envoie des SMS à partir de ton terminal préféré

Envoie et reçois des messages SMS à partir de ton système d’exploitation et de ton shell préférés :

  • Envoi de SMS depuis Linux et Unix
    Exécute des commandes à travers des shells populaires comme bash, bsh, zsh et plus encore pour envoyer des textes sur macOS, Linux et Unix.
  • Ligne de commande Windows SMS
    Que tu sois fidèle à l’Invite de commande ou que tu préfères Powershell, tu pourras envoyer des textes en quelques minutes.
  • Envoi de messages à distance
    Exécute les commandes d’envoi de SMS par l’intermédiaire de terminaux distants tels que PuTTY ou SSH.

Avant de commencer

Tu as besoin d’un compte ClickSend gratuit

Tu devras s’inscrire à un compte ClickSend gratuit . Nous te donnerons même un crédit gratuit à utiliser pour essayer !
Si tu as déjà un compte, saute cette étape.

Tu dois avoir installé Node et Git sur ton système.

Nous te laissons le soin de télécharger et d’installer Node et un serveur Git en ligne de commande. Ils sont nécessaires.

Note : nous travaillons à rendre cette application installable via NPM, mais pour l’instant, tu devras télécharger le code depuis GitHub. Une fois que nous aurons mis en place l’enregistrement NPM, Git sera optionnel.

Commencer à envoyer des SMS à partir de la ligne de commande

Installe et commence à envoyer des messages texte via ton interface de ligne de commande préférée en 3 étapes.

1. Obtiens ton nom d’utilisateur ClickSend et ton jeton API

Connecte-toi à notre tableau de bord et navigue jusqu’à la section Références API en utilisant le lien Developers > API Credentials sur le côté gauche de la page.

Si tu n’as pas de sous-compte configuré avec les informations d’identification de l’API, tu peux en créer un en cliquant sur le bouton “Ajouter un sous-compte”. Assure-toi que ton sous-compte dispose des autorisations dont tu auras besoin plus tard. Dans ce cas, nous voulons nous assurer que l’option “Accès SMS” est activée.

Capture d'écran montrant comment ajouter un sous-compte à ton compte ClickSend dans le tableau de bord ClickSend.

Trouve le sous-compte qui va envoyer ton message et saisis le nom d’utilisateur et la clé API. La clé API est un UUID au format XXXXXXXX-XXXX-XXXXXX-XXXXXXXXXX.

2. Installation de l’interface de programmation ClickSend

Télécharge le CLI ClickSend :

git clone https://github.com/ClickSend/cli.git

Installe ensuite ClickSend CLI :

cd cli 
npm install -g

3. Envoyer ces textes de ligne de commande

Remplace les valeurs de [square brackets] par des valeurs par défaut raisonnables et évidentes et appuie sur la touche Entrée. Voilà ! Ton message est propulsé par les réseaux jusqu’à ton destinataire.

clicksend sms send  
  --to [phonenumber]  
  --body "[The message]"  
  --csuser [your user id]  
  --cstoken [your API token]

Note : [phonenumber] doit être un numéro de téléphone mobile au format international. format international (ou format E.164), ce qui signifie qu’il doit commencer par un plus (+), suivi de l’indicatif du pays, puis de tous les chiffres.

Exemple de code :

clicksend sms send 
    --to +61422222222 
    --body "You have been a good developer this year." 
    --csuser GoodDeveloper 
    --cstoken XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Si le corps du message comporte plus de 160 caractères, tu seras facturé pour plusieurs parties du message. Pour savoir combien cela va te coûter, envoie exactement la même commande mais utilise la sous-commande “calculer” au lieu de “envoyer”. 

clicksend sms calculate  
  --to [phonenumber]  
  --body "[The message]"  
  --csuser [your user id]  
  --cstoken [your API token]

Si tu souhaites envoyer le même message à 1 000 numéros de téléphone, tu peux en ajouter autant que tu le souhaites après –à, en séparant les numéros par des espaces.

La réponse de la commande

Il y a beaucoup de bonnes informations dans la réponse qui revient au format JSON. En voici un exemple : 

{
"http_code": 200,
"response_code": "SUCCESS",
"response_msg": "Messages queued for delivery.",
"data": {
	"total_price": 0.077,
	"total_count": 1,
	"queued_count": 1,
	"messages": [
		{
		"direction": "out",
		"date": 1639990444,
		"to": "+61422222222",
		"body": "You have been a good developer this year.",
		"from": "+61447213651",
		"schedule": 1639990444,
		"message_id": "AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE",
		"message_parts": 1,
		"message_price": "0.0770",
		"from_email": null,
		"list_id": null,
		"custom_string": "",
		"contact_id": null,
		"user_id": 222222,
		"subaccount_id": 111111,
		"country": "AU",
		"carrier": "Vodafone",
		"status": "SUCCESS"
		}
	],
	"_currency": {
		"currency_name_short": "AUD",
		"currency_prefix_d": "$",
		"currency_prefix_c": "c",
		"currency_name_long": "Australian Dollars"
	}
}
}

Passer à l’étape suivante

Cache ces informations d’identification

Tu n’as pas besoin de transmettre le nom d’utilisateur et le jeton à chaque appel. Sur ton système, configure des variables d’environnement avec ces valeurs et l’interface de programmation les récupérera pour toi : 

CLICKSEND_USER 
CLICKSEND_TOKEN

Envoyer des messages de test

Utilise l’un de nos téléphone de test pour envoyer un message à /dev/null sans encourir de frais. Voici quelques exemples de numéros de test pour les SMS :

  • +61411111111
  • +61422222222
  • +61433333333
  • +61444444444
  • +14055555555
  • +14055555666
  • +447777777777
  • +8615555555555

Définir l’ID de l’expéditeur

Tu peux spécifier une option --from dans la commande d’envoi de sms et ce numéro sera affiché lorsque ton destinataire le recevra. L’envoi d’un nom d’expéditeur comme --from Santa fonctionnera également, mais le destinataire ne pourra pas te répondre. Si tu ne spécifies pas d’option “from”, ClickSend utilisera un numéro provenant d’un pool de numéros partagés.

Vérifier les réponses

Utilise la commande sms incoming pour voir qui a répondu.

clicksend sms incoming

Mais attends, ce n’est pas tout

Utilise l’aide intégrée de notre CLI pour te faire une idée de toutes les fonctionnalités actuellement disponibles.

clicksend help 
clicksend sms help 
clicksend sms send help

Facile à faire

Amuse-toi à intégrer les puissantes capacités de messagerie de ClickSend dans tout ce que tu construis. Envoie-nous des nouvelles de ce que tu as créé, nous serions ravis de voir ce que tu fais avec la plateforme. sur ce que tu as construit, nous serions ravis de voir ce que tu fais avec la plateforme.