Présentation de SMS
Bird SMS envoie des messages texte via la même plateforme et les mêmes clés API que Bird Email. Appelez Bird avec une clé bk_{region}_… sur votre hôte régional (https://us1.platform.bird.com ou https://eu1.platform.bird.com). Bird choisit une route vers l'opérateur du destinataire, découpe votre texte en segments facturables et signale chaque message via son accusé de réception. Les endpoints SMS commencent par /v1/sms/.
Vous pouvez envoyer du texte libre avec un expéditeur et une catégorie de votre choix, ou utiliser l'un des modèles intégrés de Bird, qui fournit le corps, la catégorie et l'expéditeur. Bird reçoit aussi les réponses à vos numéros. Il stocke chaque message entrant aux côtés de vos envois et émet des sms.received. Lorsqu'une réponse correspond à un mot-clé de désinscription pris en charge tel que STOP, Bird enregistre également une suppression expéditeur-et-abonné. Consultez Désinscriptions et mots-clés pour la couverture et la configuration.
Fonctionnement de l'envoi
Envoyez un SMS avec POST /v1/sms/messages : un destinataire et un message, contenant soit votre propre text avec un expéditeur et une catégorie, soit une référence template avec ses valeurs de variables. Bird valide la requête et la destination, résout l'expéditeur, et renvoie 202 Accepted avec un identifiant de message. La livraison se fait ensuite de manière asynchrone. Suivez le résultat via les événements et webhooks ou les endpoints de lecture de message. Pour envoyer plusieurs messages indépendants en un seul appel, utilisez l'endpoint batch.
Trois principes structurent l'ensemble de API :
- L'envoi et la livraison sont des étapes distinctes. Un 202 signifie que Bird a accepté le message. L'opérateur le traite après l'acceptation et peut renvoyer un accusé de réception plus tard. Un accusé d'échec est aussi un résultat final ; vérifiez le statut signalé avant de considérer l'envoi comme livré.
- Le texte est facturé en segments. Un message plus long qu'un segment est découpé et facturé par segment, et la capacité par segment dépend des caractères utilisés. Limites de caractères contient les règles d'encodage, le jeu de caractères complet et comment maintenir les messages à un seul segment.
- La raison de votre envoi compte. Chaque message porte une catégorie : transactional, marketing, authentication ou service. Bird et les opérateurs l'utilisent pour comprendre l'objet du message. Lors d'un envoi par modèle, la catégorie provient du modèle.
Avant votre premier envoi, activez les pays de destination que vous desservez sous SMS > Destinations. La liste d'autorisation par défaut (tout refusé) ne contient que le pays d'origine de votre organisation. Bird rejette un envoi vers tout autre pays. Envoi SMS couvre ce prérequis.
Pour les codes de vérification à usage unique, envisagez Bird Verify plutôt que de composer le message vous-même. Verify génère et transmet le code par SMS ou e-mail, vérifie la réponse, et applique l'expiration, les limites de tentatives et les délais de renvoi.
L'application SMS dans le tableau de bord
Dans le tableau de bord, SMS est l'un des produits dans la barre latérale. Ses pages, et où se trouve le guide de chacune :
| Page | À quoi elle sert |
|---|---|
| Messages | Chaque message envoyé, avec sa chronologie d'événements et le détail de livraison. Guide : Journal SMS |
| Templates | Les modèles intégrés que vous pouvez envoyer : nom, catégorie, langues et variables. Guide : Modèles SMS |
| Metrics | Taux de livraison, taux d'échec et volume accepté dans le temps. Guide : Métriques SMS |
| Senders | Les identifiants d'expéditeur et numéros depuis lesquels vous pouvez envoyer, et où chacun est enregistré. Guide : Identifiants d'expéditeur SMS |
| Destinations | Les pays vers lesquels votre espace de travail peut envoyer ; activez une destination avant d'y envoyer. Guide : Envoi SMS |
Visibilité
Utilisez les enregistrements de messages et la chronologie d'événements disponible pour examiner l'acceptation, le transfert à l'opérateur et les résultats de livraison. Les détails du message incluent les segments et les éventuels composants de coût tarifés. Les lectures publiques de messages couvrent la fenêtre de rétention décrite dans le Journal SMS.
- Journal SMS : la vue par message dans le tableau de bord. Chaque envoi, sa chronologie d'événements, ses segments, son coût et le détail de l'opérateur.
- Métriques SMS : le taux de livraison agrégé, le taux d'échec, le volume accepté et la latence de livraison sur l'ensemble de vos envois.
- Événements : le vocabulaire d'événements SMS, le cycle de vie du message et la livraison par webhook vers vos propres endpoints.
Étapes suivantes
Explorez la plateforme SMS pour les campagnes, les messages applicatifs et les réponses, ou utilisez la bibliothèque de ressources SMS pour choisir un workflow.
| Page | Ce qu'elle couvre |
|---|---|
| Envoi SMS | L'envoi API : destinations, expéditeurs, corps, segments, catégories, tags |
| Limites de caractères | Encodage GSM-7 et UCS-2, limites par segment et plafond de 12 segments |
| Modèles SMS | Le catalogue de modèles intégrés et l'envoi par référence de modèle |
| Identifiants d'expéditeur SMS | Choisir un type d'expéditeur et l'enregistrer par pays de destination |
| Enregistrement 10DLC | Enregistrer une marque, une campagne et un numéro pour l'envoi A2P aux États-Unis |
| Journal SMS | Chaque message, sa chronologie d'événements, ses segments et son coût |
| Métriques SMS | Taux de livraison, taux d'échec et latence |
| Événements | Les types d'événements SMS et la livraison par webhook |
| Webhooks et événements | Configuration des endpoints, vérification de signature, réessais et rejeu |
| Présentation de Verify | Codes de vérification à usage unique par SMS et e-mail, envoyés et vérifiés par Bird |
| Contrôler les destinations d'envoi de votre compte | Une vidéo : montre ce que renvoie un envoi vers une destination désactivée |
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Regarder le guideSMS pumping explainedComprendre le conceptWhat is SMS pumping, and how do I stop it?Explorer la fonctionnalitéSMS destinationsSuivre le parcours d'apprentissageBuild your first integration
Obtenir un guide d'implémentation