Envoyer des messages

Chaque SMS qui quitte votre passerelle suit le même chemin : il entre dans la file d'attente, la passerelle choisit un téléphone et une SIM capables de l'envoyer tout de suite, le téléphone le remet à l'opérateur, et son statut suit ce qui se passe ensuite. Cette page explique comment envoyer, comment suivre ce que vous avez envoyé, et ce que la passerelle fait d'elle-même quand quelque chose se passe mal.

Les façons d'envoyer

Toutes partagent la file, le routage, les quotas et les nouvelles tentatives décrits plus bas. Les campagnes sont le seul trafic retenu par les pauses de nuit et du dimanche.

Voir aussi : Conversations, Campagnes, Automatisation et le guide de l'API.

Envoi rapide

L'Envoi rapide envoie un message, immédiatement ou plus tard, à un ou plusieurs destinataires.

Choisir les destinataires

Choisissez l'un des trois modes sous Destinataires :

Les numéros se lisent au format international : un + suivi de l'indicatif du pays. Un numéro écrit avec 00 au lieu de + est accepté et converti, et les espaces, points, tirets et parenthèses sont ignorés. Un numéro sans indicatif (0341234567) n'est pas reconnu.

Pendant la saisie, l'écran compte les destinataires valides et les lignes ignorées, format non reconnu. Un même numéro collé deux fois n'est envoyé qu'une fois.

En mode Groupe de contacts, l'écran lit le groupe entier avant l'envoi, quel que soit son nombre de membres, et affiche le nombre réel de destinataires, ainsi que les contacts désinscrits écartés. Le bouton Envoyer attend la fin du comptage. Si le groupe ne peut pas être lu, un message le signale avec un bouton Réessayer.

Limites. Un envoi rapide accepte 500 destinataires au maximum, groupe entier compris. Au-delà, l'écran le signale (pour un groupe : « Ce groupe compte 1 250 contacts, plus que les 500 destinataires d'un envoi rapide »), refuse l'envoi et propose une campagne, conçue pour les gros envois : elle cadence le trafic, respecte la pause de nuit et vous donne des statistiques. Rien n'est jamais envoyé à une partie seulement d'un groupe.

Rédiger le message

Le compteur sous le message indique le nombre de caractères, le nombre de SMS qu'il coûtera et l'encodage :

Un message long n'est jamais refusé : il est découpé en plusieurs SMS que le téléphone du destinataire réassemble. Mais chaque partie est facturée par votre opérateur et compte dans le quota journalier de la SIM. L'écran vous avertit au-delà de six SMS par destinataire, et affiche le total, par exemple « 3 messages, 6 SMS au total ».

Raccourcir et suivre les liens

Sous le message, l'interrupteur Raccourcir et suivre les liens (désactivé par défaut) remplace chaque adresse qui commence par http:// ou https:// par un lien court servi par votre passerelle, qui compte les clics. Le remplacement a lieu au clic sur Envoyer ; la même adresse écrite deux fois donne un seul lien, partagé par tous les destinataires. L'écran vous indique combien de liens seront fabriqués et comment la longueur change (caractères et SMS par destinataire, avant et après), et le compteur comme le coût total sont calculés sur le texte avec ses liens courts. Les liens apparaissent ensuite dans Liens courts. Voir Liens courts.

Choisir le téléphone et l'heure

Cliquez sur Envoyer. La confirmation « N messages acceptés par la passerelle » signifie que les messages sont dans la file, pas encore remis. Derniers envois, en bas de l'écran, liste vos derniers messages sortants avec leur statut en direct.

Un message programmé attend dans la file avec le statut En file et la mention « Programmé pour » sa date. Il part à cette heure-là, de jour comme de nuit : la pause de nuit ne s'applique pas à lui.

La file d'attente

L'écran File d'attente liste les messages et permet de relancer ceux qui ne sont pas partis. Il s'ouvre filtré sur les messages en Échec, puisque ce sont eux qui ont besoin de vous.

Les colonnes montrent le Statut, le Destinataire, l'Appareil qui a porté le message, le nombre de Tentatives, la date de création et le Motif d'un échec ou d'une annulation.

Le Motif est une phrase dans votre langue, la même que dans la conversation et dans le journal d'activité, par exemple « La SIM ne captait pas le réseau. » ou « Retiré avant son départ : sa campagne a été annulée. ». Survolez-le pour voir le code technique (NO_SERVICE, CAMPAIGN_CANCELLED...), celui que l'API renvoie dans errorCode. Un code que le tableau de bord ne connaît pas encore, remonté par une version plus récente de l'application du téléphone, s'affiche « Le téléphone ou la passerelle a signalé une erreur (CODE). ».

Quand des messages attendent le quota journalier d'une SIM, un bandeau en haut de l'écran indique combien, avec un lien Modifier les quotas vers l'écran Appareils.

Un message En file qui attend le rythme de ses SIM le dit sous son statut, avec l'heure de son prochain essai : « En attente de la cadence de la SIM, nouvel essai à 14:32 » (intervalle minimal) ou « En attente de la limite par minute des SIM ». Rien n'est en panne : il part de lui-même à cette heure-là.

Les statuts

Envoyé n'est pas Reçu. « Reçu » dépend d'un accusé de réception de l'opérateur du destinataire. Certains opérateurs n'en envoient pas, ou tardivement : un message peut rester Envoyé alors qu'il a bien été reçu. Un accusé négatif, en revanche, est définitif : le message passe en Échec.

Nouvelles tentatives

Quand un envoi se passe mal, la passerelle n'abandonne pas tout de suite. Ce qu'elle fait dépend de la cause :

Quand les tentatives sont épuisées, le message passe en Échec. Le nombre de tentatives et les attentes entre elles se règlent dans Paramètres > Envoi (voir Options).

Dans l'API, le champ errorCode d'un message en échec ou annulé en donne la raison. La colonne Motif affiche ces mêmes codes sous forme de phrases :

Traitez tout autre code comme un échec générique : une version plus récente de l'application du téléphone peut en ajouter.

Relancer à la main

Un message en Échec, Quota atteint ou En pause peut être relancé :

• depuis la File d'attente, en le cochant puis en cliquant sur Relancer la sélection ;
• depuis sa conversation, avec Réessayer sous le message en échec ;
• par l'API, avec POST /messages/{messageId}/retry.

Un message relancé part aussitôt, sans attendre la tentative programmée suivante. Il est refusé si le destinataire s'est désinscrit entre-temps. Les messages Reçu, Envoyé et Annulé ne se relancent pas : ce serait les envoyer deux fois.

Cadence des SIM

Vous pouvez imposer à chaque SIM un nombre minimal de secondes entre deux SMS, dans Paramètres > Envoi, champ Intervalle minimal entre deux SMS par SIM, en secondes. Une SIM qui envoie à un rythme régulier, humain, ressemble moins à une source de spam aux yeux de son opérateur qu'une SIM qui envoie en rafale.

Comment cela fonctionne.

• Il s'applique à tous les SMS, quelle que soit leur origine : API, envoi rapide, campagne, réponse de conversation, réponse automatique, alerte par SMS, et nouvelles tentatives.
• L'intervalle se compte à partir du moment où la passerelle remet le SMS au téléphone, pas de la confirmation du téléphone ni de l'accusé de réception.
• Vous n'avez jamais rien à attendre : vous pouvez envoyer 50 messages d'un coup, ils sont tous acceptés, attendent dans la file en En file, et partent d'eux-mêmes, l'un après l'autre, dès que leur SIM est libre. L'écran File d'attente les affiche « En attente de la cadence de la SIM » avec l'heure de leur prochain essai.
• Chaque SIM a sa propre horloge. Une SIM qui attend ne retient jamais une autre SIM, pas même la seconde SIM du même téléphone : avec deux SIM et 30 secondes, deux SMS partent toutes les 30 secondes.
• Un message adressé à un téléphone précis (deviceId) le garde pendant qu'il attend.
• L'attente ne consomme aucune tentative. Une nouvelle tentative après un échec attend elle aussi l'intervalle si nécessaire.
• Le délai d'accusé commence quand le SMS est remis au téléphone : un message qui attend sa SIM n'expire donc jamais dans la file.
• La passerelle consulte la file toutes les deux secondes : un message part environ deux secondes au plus après la fin de l'intervalle.
• Les messages qui attendent leur SIM partent dans l'ordre. Il n'y a pas de priorité : une alerte attend comme n'importe quel SMS, mais un message arrivé pendant l'attente des autres prend le prochain créneau libre.

Une SIM avec sa propre valeur. Dans Appareils, le crayon à côté d'une SIM ouvre une fenêtre où Intervalle propre à cette SIM remplace le réglage pour cette SIM seulement (Superadministrateur). 0 signifie aucune attente sur cette SIM, même quand le réglage en demande une ; désactiver l'interrupteur fait de nouveau suivre le réglage à la SIM. Une nouvelle valeur vaut pour le SMS suivant ; les messages qui attendent déjà gardent leur heure.

Comment il se combine avec les autres limites. Chaque limite doit autoriser l'envoi ; la plus stricte l'emporte.

Exemples : avec un intervalle de 10 secondes, une SIM envoie au plus 6 SMS par minute ; une limite par minute de 6 ou plus ne change donc rien, et une limite plus basse (3, par exemple) s'applique toujours. Une campagne à 60 messages par minute sur deux SIM avec un intervalle de 30 secondes envoie en réalité 4 messages par minute : c'est l'intervalle qui limite. Le quota journalier compte toujours chaque SMS.

À 0, la valeur par défaut, l'intervalle n'ajoute aucune attente : la passerelle se comporte comme avant.

Pauses de nuit et du dimanche : les campagnes seulement

Vous pouvez interdire aux campagnes d'envoyer la nuit et le dimanche, dans Paramètres > Envoi, sous Pause nocturne des campagnes. Un message de campagne dû pendant une pause passe En pause et part automatiquement à la fin de la pause.

Ces pauses ne retiennent que les campagnes. Un envoi rapide, un appel d'API, une réponse de conversation ou une réponse automatique part à toute heure : quelqu'un l'attend. Une campagne est le seul trafic que personne n'a demandé à ce moment-là, et un SMS promotionnel à trois heures du matin vous coûte plus de sympathie qu'il ne rapporte.

Les heures se lisent dans le fuseau de la plateforme, réglé dans le même onglet. Ce fuseau gouverne aussi l'heure des envois programmés et l'affichage des dates dans le tableau de bord. Ce n'est pas l'heure de chaque téléphone : l'en-tête affiche l'heure locale de vos téléphones et vous prévient quand l'un d'eux vit à une autre heure (voir Appareils).

Suivre l'activité

Le Tableau de bord montre combien de messages sont partis et arrivés, dans le graphique Activité des 24 dernières heures. Choisissez la période avec les boutons 24 h, 7 j, 30 j et 90 j : le graphique affiche alors une barre par heure, par tranche de six heures, ou par jour. Chaque barre empile les messages sortants et les entrants, et la carte donne les totaux de la période. Survolez ou touchez une barre pour les heures exactes de la tranche.

Un message compte à sa création (sa mise en file pour un sortant, sa réception par le téléphone pour un entrant), quel que soit son statut depuis. Les comptes portent sur tous les messages de la période, pas sur un échantillon. Les tranches suivent le fuseau de la plateforme, changement d'heure compris. Le graphique se rafraîchit chaque minute.

Par l'API, GET /messages/stats?period=24h (ou 7d, 30d, 90d) renvoie les mêmes comptes. Il ne renvoie jamais le texte d'un message ni un numéro.

Options

Les réglages d'envoi se trouvent dans Paramètres > Envoi, sont réservés au Superadministrateur, et s'appliquent au message suivant sans aucun redémarrage.

Autres réglages qui changent ce que vous envoyez :

• le quota journalier, l'interrupteur en service et l'intervalle propre de chaque SIM, dans Appareils (voir Appareils) ;
• les règles de routage, qui choisissent la SIM selon le début du numéro (voir Routage).

Champs de l'API POST /messages

L'en-tête Idempotency-Key protège un envoi à un seul destinataire contre une double mise en file quand votre logiciel rejoue une requête après une erreur réseau.

La requête est vérifiée en entier avant toute mise en file : si un destinataire est invalide ou désinscrit, la requête est refusée et rien n'est envoyé, ce qui vous permet de toujours savoir quoi rejouer.

Dépannage