L’envoi de SMS par Icodia

Envoyez des SMS via votre logiciel de messagerie ou un webservice directement depuis votre site.

Le principe de base est le suivant :

Vous envoyez un email (via la fonction mail de php par exemple ou depuis votre client de messagerie préféré) à une adresse spécifique avec comme contenu un identifiant et mot de passe, le contenu du message, les numéros de téléphone.
Cet email est ensuite converti par nos robots en envoi SMS.

Concernant l’envoi en lui même :

1 SMS = 160 caractères maximum

Voici la liste des caractère qui comptent pour un caractère:
abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 _!?&()*+,-.=

Voici la liste des caractère qui comptent pour deux caractères:
‘\»#%/:;<>@{|}~÷àáâãäçèéêëìíîïñòóôõøùúûüÀÁÂÃÄÇÈÉÊËÌÍÎÏÑÒÓÔÕØÙÚÛÜ

Les accents comptent pour deux caractères.

Tarifs :

Il faut précréditer un compte, le tarif par sms est le suivant, à chaque fois par tranche de précrédit. Aucun précrédit n’est remboursable, même partiellement, car Icodia obtient ses tarifs auprès des opérateurs par le même biais.

Le tarif par SMS est unique, quel que soit l’endroit où se trouve le mobile dans le monde.

* Précrédit de 100 euros HT pour le compte SMS: 0,15 eur / SMS, soit environ 665 SMS.
* Précrédit de 500 euros HT pour le compte SMS: 0,13 eur / SMS, soit environ 3846 SMS.
* Précrédit de 1000 euros HT pour le compte SMS: 0,12 eur / SMS, soit environ 8333 SMS.
* Précrédit de 2000 euros HT pour le compte SMS: 0,11 eur / SMS, soit environ 18181 SMS.
* Précrédit de 5000 euros HT pour le compte SMS: 0,09 eur / SMS, soit environ 55555 SMS.

(Chaque SMS envoyé, quel que soit l’état de réception est facturé)

Protocole technique:

L’email est à adresser sur: robotsms@icodia.com.

Le sujet de l’email n’a aucune influence et peut être vide.

Le contenu de l’email est le suivant :

command=sendsms
accountid=votre_compte_fourni_par_icodia
password=votre_mot_de_passe_fourni_par_icodia
text=votre_contenu_sms (les caractères autorisés sont : abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789 ‘_!?\ »#%&()*+,-./:;<>?@{|}~÷=àáâãäçèéêëìíîïñòóôõøùúûüÀÁÂÃÄÇÈÉÊËÌÍÎÏÑÒÓÔÕØÙÚÛÜ )
encoding=plain
sourceid=votre_numéro_expéditeur_ou_message (il doit contenir maximum 11 caractères, voici les caractères autorisés: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz.0123456789 +
(et « espace ») )
receps=numéros_de_téléphone_de_réception_au_format_international_séparés_par_des_points_virgules
mailfrom=adresse_email_de_notification_de_l_état_de_l_envoi

Exemple de script PHP d’envoi:

<?php
$message ='command=sendsms'."\n";
$message .='accountid=votre_compte_fourni_par_icodia'."\n";
$message .='password=votre_mot_de_passe_fourni_par_icodia'."\n";
$message .='text=Ceci est un envoi de test!'."\n";
$message .='encoding=plain'."\n";
$message .='sourceid=votre_numéro_expéditeur_ou_message'."\n";
$message .='receps=336xxxxxxxx;336xxxxxxxx'."\n";
$message .='mailfrom=email@votredomaine'."\n";
mail('robotsms@icodia.com','', $message);
?>

Pour connaitre votre crédit sms restant, la fonction « smscredit » est à votre disposition.

Exemple:

<?php
$message ='command=smscredit'."\n";
$message .='accountid=votre_compte_fourni_par_icodia'."\n";
$message .='password=votre_mot_de_passe_fourni_par_icodia'."\n";
$message .='mailfrom=email@votredomaine'."\n";
mail('robotsms@icodia.com','', $message);
?>

Vous recevrez alors par email (mailfrom) votre crédit sms.

Autres possibilités d’envoi:

Vous pouvez effectuer vos envois via une url en « GET » toujours sur le même principe de fonctionnement:

http://websrv.icodia.com/sms/?command=sendsms&accountid=votre_compte_fourni_par_icodia&password=votre_mot_de_passe_fourni_par_icodia&text=Ceci est un envoi de test!&encoding=plain&sourceid=votre_numéro_expéditeur_ou_message&receps=336xxxxxxxx;336xxxxxxxx

Le principe est le même pour visualiser son crédit sms:

http://websrv.icodia.com/sms/?command=smscredit&accountid=votre_compte_fourni_par_icodia&password=votre_mot_de_passe_fourni_par_icodia

Encore plus simple:

Une fonction php a également été ajoutée sur la plateforme mutualisée pour une utilisation simplifiée, il s’agit de la fonction « icosms » :

<?php
icosms("commande","id","pass","texte sms","expediteur","liste  destinataire séparée par ';'");
?>

Exemple pour l’envoi SMS:

<?php

echo icosms("sendsms","votre_compte_fourni_par_icodia","votre_mot_de_passe_fourni_par_icodia","Ceci est un envoi de test!","votre_numéro_expéditeur_ou_message","336xxxxxxxx;337xxxxxxxx");

?>

Pour visualiser votre crédit SMS, même principe :

<?php

echo icosms("smscredit","votre_compte_fourni_par_icodia","votre_mot_de_passe_fourni_par_icodia","","","");

?>

N’hésitez pas à nous contacter pour plus d’informations.