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 écrit comme on le compose sur place (0386231963) est accepté lui aussi, dès que vous avez renseigné le préfixe des numéros locaux dans Paramètres, Réception : la passerelle le complète en +261386231963 avant l'envoi. Sans ce préfixe il n'est pas reconnu, car deviner un pays rangerait le message sous le mauvais. La même règle vaut pour la fiche contact, pour le testeur d'automatisation et pour le champ to de l'API.

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. Sur un téléphone, le tableau défile latéralement et le menu de ligne reste collé au bord droit : il est donc toujours à portée.

Se déplacer dans les pages

Le bas de l'écran indique combien de messages tient une page, quels messages vous regardez, et les numéros de page. Changer un filtre ou la taille de page vous ramène à la première page. Une page déjà ouverte revient instantanément, sans rien redemander à la passerelle.

La file se lit page par page plutôt que d'être comptée d'abord, ce qui garde un long historique rapide à ouvrir : les numéros de page apparaissent à mesure que vous avancez, et la dernière page n'est pas connue d'avance. La flèche suivante demande une page de plus, et les points de suspension au bout des numéros signifient qu'il y en a d'autres après.

Cocher des messages sur une page puis passer à une autre conserve votre sélection : le nombre à côté de Relancer la sélection est ce que vous avez coché en tout, sur les pages visitées. Par page est retenu dans ce navigateur, pour votre compte.

Relancer maintenant est proposé sur un message en échec, ou retenu par le quota d'une SIM ou par une pause. Il est grisé sur les autres, en disant pourquoi : un message déjà confié à un téléphone ne doit pas partir deux fois.

Supprimer retire définitivement le message de cette passerelle : la file, sa conversation, l'historique, les recherches et les exports. Un message qui attendait encore est d'abord annulé, il ne partira donc pas ensuite. Un SMS déjà remis à votre opérateur ne peut pas être repris.

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). ».

Sous le Téléphone, un message qu'une SIM a refusé le dit : « La SIM 1 de Accueil a refusé ». Survolez la ligne pour lire pourquoi chaque SIM a refusé. Elle reste sur un message finalement parti, ce qui permet de voir quelle SIM l'a écarté et laquelle l'a porté. Voir Quand une SIM refuse le message.

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).

Quand une SIM refuse le message

Une SIM sans crédit paraît en parfait état vue de la passerelle : son téléphone est en ligne, son quota du jour est intact, et rien n'annonce que l'opérateur va écarter le message. On ne l'apprend qu'au moment où l'envoi échoue.

La passerelle retient donc quelle SIM a refusé ce message, et l'envoie aussitôt depuis la suivante, sans attendre le délai de reprise. Vos priorités de routage ne changent pas : un téléphone désigné dans l'envoi reste le seul utilisé, une réponse garde le numéro de la conversation, une règle par préfixe essaie toujours ses SIM dans votre ordre, et une règle réglée sur Attendre ces SIM ne part toujours jamais d'une autre SIM. Seule la SIM qui vient de refuser est écartée, pour ce message.

Essayer cinq SIM est une tentative, pas cinq. Sans cela, un parc de cinq SIM brûlerait tout le budget de reprise en une seconde. C'est vrai même si vous avez désactivé Réessayer les messages en échec, ou fixé Nombre de tentatives à 1 : une tentative est un tour de vos SIM, donc une SIM morte ne vous coûte jamais le message. Quand toutes les SIM qui pouvaient porter le message l'ont refusé, le message consomme une tentative, attend le délai habituel, puis oublie les refus : une SIM peut avoir été rechargée entre-temps, et elle retrouve son tour.

Une SIM qui refuse garde son quota du jour. Le compteur journalier est décompté au moment où le message est remis à la radio, mais une SIM qui l'a écarté n'a rien envoyé : la passerelle lui rend l'unité. Un SMS coûte une unité de quota sur la SIM qui l'a réellement porté, quel que soit le nombre de SIM essayées avant.

Certains échecs ne viennent pas de la SIM : un message mal formé, ou un destinataire que toutes les SIM refusent. Ceux-là ne balaient pas votre parc, parce que le même refus reviendrait de chaque SIM et masquerait la vraie cause. Ils attendent et réessaient comme avant.

Ce que vous voyez : la File d'attente affiche, sous le téléphone du message, quelle SIM a refusé et, au survol, pourquoi. Un message qui répète « La SIM x de y a refusé » avec GENERIC_FAILURE est en général une SIM à recharger. L'API renvoie la même liste dans le champ refusedSims du message.

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 :

RADIO_ERROR_<n> n'est volontairement pas traduit en phrase : le téléphone a renvoyé un code que l'application ne connaît pas, et afficher le numéro est plus honnête que d'inventer une cause. 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.

Choisir la SIM. Dans la File d'attente, le menu en bout de ligne propose aussi Relancer depuis une SIM choisie, qui liste toutes les SIM en service. En cochant plusieurs messages, vous avez le même choix pour toute la sélection, avec Depuis une SIM choisie à côté de Relancer la sélection. Vous en désignez une et la relance part de cette carte et d'aucune autre : utile quand vous savez pourquoi la précédente a échoué, une SIM sans crédit ou une carte que l'opérateur a bridée.

Désigner une SIM engage. Le routeur n'a plus aucune autre voie, donc si cette carte ne peut pas envoyer, le message attend dans la file au lieu de partir d'ailleurs. Relancer tout court, qui rejoue le routage sur toute votre flotte, reste l'action en un clic et le bon choix par défaut.

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