Per iniziare

Questa documentazione ti mostrerà come inviare degli SMS, importare delle liste e gestire i tuoi account all’interno della nostra API. Per poterlo usare, assicurati di avere un account. Puoi creare il tuo account qui. Une fois votre compte créé, nous conseillons de vous connecter à la plateforme pour mettre en place une alerte solde. Cette alerte vous permettra de recevoir un mail ou un SMS lorsque votre crédit de SMS atteindra le seuil critique que vous aurez défini (exemple : 10, 100, 500 SMS).

La nostra base URL per tutte le richieste inerenti la API è https://api.smsfactor.com

Autenticazione

Una volta creato un account e un token API, puoi autenticarti tramite l’header HTTP Autorizzazione in questo modo


Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMTY1NiIsImlhdCI6MTUxOTEyMDg2NX0.ZnGgbDC0OI3hPm2UXyl4rxU9JlpMTMBcTJT8RVgJbtQ
        
    

Content-Types

La nostra API supporta i Content-Type application/json e application/xml. Puoi specificare un Content-Type con Accept Header in HTTP. Di default, la nostra API riceve e ritorna XML.


Accept: application/json
        
      

Stato della richiesta

Here's the list of all the request statuses our API can send:

status Descrizione
1 OK
-1 Errore di autenticazione
-2 Errore XML
-3 Crediti insufficienti
-4 Posticipazione data non corretta
-5 Errore nella lista contatti
-6 Errore JSON
-7 Errore dei dati
-8 La tua campagna è in attesa di moderazione
-99 Errore sconosciuto

Alcune informazioni sugli SMS

Combien de caractères compte un SMS ?

Un SMS è fatto di 160 caratteri, secondo norme internazionali. Nei 160 caratteri sono compresi gli spazi, la punteggiatura, le lettere, le cifre e i caratteri speciali. 1 SMS ogni 153 caratteri.

Which are the two types of professional SMS?

Bien qu’il n’y ait techniquement qu’un seul SMS, il existe une distinction séparant deux types de SMS selon leur usage et législation : le SMS d’alerte et le SMS promotionnel.
L’SMS Promozionale è progettato per offerte commerciali, vendite private, regali, eventi commerciali etc.. Il est autorisé uniquement entre 8h et 20h du lundi au samedi et est interdit le dimanche et les jours fériés. Pour ce type de SMS, il est obligatoire de proposer aux destinataires un mode de désabonnement car il s’agit d’offres commerciales.
Alert SMS is designed for meetings, gatherings, weather alerts, emergencies, financial transactions, etc. Siccome sono SMS informativi e non commerciali, non sono sottoposti al medesimo regolamento. Gli SMS Alert possono essere inviati tutti i giorni e a tutte le ore del giorno. Il n’est pas obligatoire de mettre une mention STOP pour les alertes par sms car ils n’ont pas de portée commerciale.

La scelta fra un SMS promozionale e un SMS Alert è solo tua, e ti ringraziamo se rispetterai queste norme. Si vous n’êtes pas sûr du type d’envoi de sms que vous souhaitez réaliser, n’hésitez pas à contacter notre service client qui sera ravi de vous aider. Sachez qu’en cas de problème dû à un non-respect de la règlementation, si vous envoyez par exemple des sms marketing comme des sms transactionnels sans mention STOP, vous serez tenu pour responsable.

How does unsubscription work?

You must always add a way for recipients to unsubscribe from your promotional SMS whereas it’s optional for alert sms. In France, if the sender is not personalized, a 5-digit number will be displayed as the sender of the SMS. The recipients will then be able to reply “STOP” directly to this number, thus a STOP mention won’t be added. If the sender is customized, a STOP mention will automatically be added at the end of the message, indicating to the recipient how to unsubscribe (example: “STOP SMS at 36173”) You should know that every country has its own rules about the sender, so feel free to contact us if you wanna know anything about sending toward a particular country. Because of the European data protection regulation, make sure you only send your promotional SMS campaigns to clients that have given their explicit consent and to always offer a way to unsubscribe.

How to receive replies to SMS sendings?

In order to receive replies, you can't personalize the sender as it prevents the recipients from replying. You should also know that replies aren't available in every country. For instance, they're available in France and Belgium but are not in Switzerland. If replies are allowed in the country you're sending towards, you can create a webhook to receive them, .

How does sender personalization work?

As said before, every country has its own rules regarding the sender. For instance, for France, the sender can be up to 11 alphanumeric characters (no special character allowed). Remember that when the sender is personalized, your recipients are unable to reply. The sender can't be personalized for Belgium and must be for Switzerland (default sender if left empty). You should also know that some phone models like iPhones are known for not being able to properly display 3 or less characters senders.

What is URL shortening used for?

Adding an URL to your message can be convenient but it would also take too many characters. URL shortening allows you to insert a link that's only 18 to 20 characters long. Furthermore, it also allows you to track the click of your recipients so you can see when and at which rate your recipients actually click on your link.

In which format the contacts’ numbers must be in when a list is created?

When you create a contact list, the numbers must be added in the international format E.164 (example: 33600000000, 33700000000 for France). Beware, every SMS sent is charged by operators, an updated list will avoid unnecessary spending. Therefore, you should delete false numbers (too short or too long numbers) but also invalid numbers.

How long is user related data hold?

We allow our clients to choose the retention period of their data on our platform or through the API. Therefore, it’s now possible to customize the retention period of messages, campaigns, contacts lists and surveys. Whether you choose to personalize the retention period of your data or not, know that we do not keep your data forever: a maximum period is decreed anyway. Therefore, you should delete false numbers (too short or too long numbers) but also invalid numbers.