Désinscriptions et mots-clés

Quand quelqu'un envoie un SMS à l'un de vos numéros, Bird compare le message à un catalogue de mots-clés avant que vous ne le receviez. Un mot-clé stop reconnu bloque les envois futurs de cet expéditeur à cet abonné, un mot-clé start met fin à la suppression, et help répond avec des informations d'assistance. Les pays pris en charge ne nécessitent aucune configuration pour ce comportement.

Ce guide couvre ce que Bird fait par défaut, comment le consulter et comment le modifier.

Ce qui se passe par défaut

Un abonné envoie STOP à l'un de vos numéros. Bird :

Le reconnaît en le comparant au catalogue de mots-clés du pays de ce numéro.
Enregistre une suppression sur cette paire exacte expéditeur-abonné.
Le confirme en répondant avec le message de désinscription de ce pays.

Dès lors, un envoi de cet expéditeur vers cet abonné est refusé avec E12077 SMSRecipientSuppressed au lieu de partir. Un START met fin à la suppression et le confirme également, et HELP répond sans rien modifier.

Une suppression couvre un expéditeur et un abonné. Elle ne couvre pas l'ensemble de votre espace de travail. La portée technique de ce blocage n'établit pas l'autorisation d'utiliser un autre expéditeur. Appliquez la préférence déclarée du client aux messages et au programme qu'il a demandé d'arrêter. Pour arrêter tous les expéditeurs de l'espace de travail d'un coup, voir Désinscription de tous les expéditeurs ci-dessous.

La confirmation est exemptée de la suppression qu'elle enregistre. Bird peut répondre au message entrant même si la nouvelle suppression bloque les envois sortants ultérieurs.

La couverture est par pays

Le catalogue de Bird couvre un sous-ensemble de pays. Quand un pays est couvert, Bird gère par défaut les mots-clés de désinscription, de réinscription et d'aide. Quand il ne l'est pas, Bird ne reconnaît aucun mot-clé, n'envoie aucune réponse et n'enregistre aucune désinscription. Si vous envoyez vers un pays non couvert, vous devez honorer les désinscriptions vous-même.

Vérifiez ce qu'un pays propose avant de vous y fier :

Exemple de code

bird sms keyword-rules list --country NL

Un résultat vide signifie que le pays n'a aucune couverture. Vous pouvez y ajouter vos propres mots-clés custom, mais toute autre opération remplace quelque chose que Bird fournit, donc vous ne pouvez en créer une que pour un pays présent dans le catalogue de Bird.

Voir ce qui s'applique

GET /v1/sms/keyword-rules décrit comment les réponses à vos numéros sont gérées. Sans filtre, il renvoie l'intégralité du catalogue de Bird ainsi que toutes les règles que vous avez créées ; affinez avec country, number, operation ou scope :

scope=system renvoie uniquement le catalogue de Bird, y compris la valeur par défaut qu'une règle d'espace de travail a remplacée.
scope=workspace renvoie uniquement vos propres règles.
number=+18005551234 renvoie les règles qui s'appliquent à l'un de vos numéros, dans l'ordre où elles sont appliquées à un message entrant ; ajoutez from_country pour voir ce qu'obtient un expéditeur envoyant depuis un autre pays, ce qui peut différer.

Les règles sont renvoyées de la plus spécifique à la moins spécifique, et chacune porte effective_keywords : l'ensemble de Bird pour cette opération et ce pays, plus tout ce que vous avez ajouté.

La liste renvoie deux opérations au-delà de stop, start et help :

info répond avec les informations de votre programme et se comporte exactement comme help. Il est séparé pour qu'un pays dont la réponse INFO doit différer de sa réponse HELP puisse porter les deux ; quand Bird ne fournit aucune règle info pour un pays, INFO est l'un des mots-clés help de ce pays et répond avec la réponse help.
confirm marque une réponse de double opt-in, comme JOIN ou YES. Il n'envoie rien actuellement, donc traitez-le depuis votre propre gestionnaire. Bird détient ces mots-clés pour qu'une règle custom ne puisse pas les revendiquer.

Modifier la réponse

Les réponses par défaut de Bird sont correctes mais génériques. Pour répondre en votre propre nom, créez une règle pour ce pays et cette opération :

Exemple de code

bird sms keyword-rules create \
  --operation stop \
  --country NL \
  --reply "You are unsubscribed from MyBrand. Reply START to resume."

Votre règle remplace la réponse par défaut de Bird pour ce pays et conserve les mots-clés de Bird sauf si vous en ajoutez d'autres. Elle hérite aussi des mots-clés que Bird ajoutera ultérieurement. Vous ne pouvez pas changer l'opération assignée à un mot-clé de désinscription ou de réinscription ; Bird rejette une règle qui tente de lier STOP à une autre opération.

Quand Bird fournit les mots-clés d'un pays dans plusieurs langues, chaque langue a sa propre règle, donc une création doit nommer la langue qu'elle remplace. Le Canada est ce pays : ses règles stop, start et help existent en en et fr. language y est obligatoire et rejeté pour un pays que Bird ne fournit que dans une seule langue.

Exemple de code

bird sms keyword-rules create \
  --operation stop \
  --country CA \
  --language fr \
  --reply "Vous etes desabonne de MyBrand. Repondez DEBUT pour reprendre."

Lister les règles d'un pays montre si la séparation s'applique et quelles langues sont disponibles.

Pour limiter une règle à un seul numéro plutôt qu'à tous les numéros que vous détenez dans le pays, définissez number au lieu de vous fier au pays seul.

Si vous répondez à ces messages depuis votre propre système plutôt que via Bird, définissez reply à null conjointement avec confirmed_self_managed. Cela désactive la réponse automatique de Bird pour la règle tandis que la suppression elle-même continue de fonctionner.

Mots-clés de campagne

Les règles custom ne portent aucun comportement intégré. Elles correspondent aux mots-clés que vous choisissez et envoient la réponse que vous rédigez, ce qui prend en charge les mots-clés de campagne tels que PIZZA. Une règle custom n'hérite d'aucun mot-clé, elle a donc besoin d'au moins un mot-clé propre, et elle peut omettre country pour s'appliquer partout où vous envoyez.

Un mot-clé que Bird a lié à une opération de conformité ne peut pas être réutilisé comme mot-clé personnalisé.

Consulter et gérer les suppressions

GET /v1/sms/suppressions liste les paires pour lesquelles vos messages sont actuellement bloqués, les plus récentes en premier. Filtrez par destination pour vérifier un abonné avant de lui envoyer un message, par originator pour l'un de vos expéditeurs, ou par reason :

keyword_stop : l'abonné a envoyé un mot-clé stop.
carrier_opted_out : son opérateur a signalé la désinscription.
manual : ajouté via API ou le tableau de bord.

Les suppressions terminées ne sont pas listées, donc la réponse identifie les destinataires auxquels vous ne pouvez pas envoyer de message en ce moment.

Vous pouvez en ajouter une vous-même pour honorer une désinscription qu'un client vous a communiquée par téléphone :

Exemple de code

bird sms suppressions add --destination +15550001234 --originator +15557654321

Une suppression manuelle bloque toutes les catégories, y compris transactionnelles, et l'ajout est idempotent. La levée d'un blocage est strictement limitée : seule une suppression manual peut être levée de cette manière. Vous ne pouvez pas lever ainsi un blocage créé par le mot-clé stop d'un abonné ou par une désinscription signalée par son opérateur, car vous n'êtes pas autorisé à annuler ces désinscriptions.

Désinscription de tous les expéditeurs

Un mot-clé stop et les suppressions manuelles ci-dessus ne bloquent qu'un seul expéditeur. Certains abonnés veulent se désinscrire de tous les expéditeurs de l'espace de travail d'un coup, par exemple quelqu'un qui demande à votre équipe d'assistance d'arrêter tous les SMS plutôt que de répondre à chaque numéro individuellement.

Il s'agit d'une préférence déclarée plutôt que d'une suppression, elle se trouve donc dans l'onglet Preferences de SMS > Suppressions, et non dans la liste ci-dessus. Ouvrez l'onglet et enregistrez une désinscription avec Every sender in the workspace : le numéro cesse de recevoir des SMS de tous les expéditeurs de l'espace de travail, y compris ceux que vous ajouterez ultérieurement. Une désinscription enregistrée dans cet onglet couvre tous les messages, textes d'authentification compris ; pour n'en enregistrer une que pour le marketing, utilisez la page Contacts > Preferences à l'échelle de l'espace de travail, dont la boîte de dialogue propose le choix de couverture.

Bird vérifie d'abord les suppressions décrites dans ce guide, donc un simple mot-clé stop continue de rejeter avec E12077 comme avant. Un envoi vers un numéro ayant une désinscription à l'échelle de l'espace de travail est rejeté avec E25000 PreferenceRevoked. Pour reprendre les envois une fois que l'abonné vous le demande, supprimez l'entrée de l'onglet Preferences (vous l'avez enregistrée, donc vous pouvez la supprimer), ou enregistrez une réinscription sur la page Contacts > Preferences à l'échelle de l'espace de travail.

Étapes suivantes

Consultez le consentement de campagne et les contrôles d'envoi avant un envoi à une audience, ou explorez la gestion des désinscriptions SMS pour votre intégration.

Envoi de SMS : consultez les catégories, les expéditeurs et les conditions de rejet.
Events : gérez les événements sms.* pour les envois et les réponses.
Journal SMS : inspectez un message, y compris un envoi rejeté.

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Comprendre le conceptHow do I collect SMS opt-ins?Utiliser l'outilPreview message segments Explorer la fonctionnalitéSMS compliance Suivre le parcours d'apprentissageOperate messaging reliably

Obtenir un guide d'implémentation