FAQ API SMS

Installez le SDK et envoyez au destinataire de test autorisé +15005550006 en environ cinq minutes. Vous pouvez expédier une vérification CI avant même de provisionner un numéro.

Un point de terminaison d'envoi, la réception bidirectionnelle, le provisionnement de numéros (numéros longs, numéros courts, numéros gratuits et identifiants d'expéditeur alphanumériques), la conformité A2P 10DLC et la gestion du désabonnement, le routage direct opérateur et l'analytique de livraison — le tout sur une seule API.

Bird couvre plus de 150 pays via plus de 240 connexions directes aux opérateurs, avec une resélection de route de qualité opérateur lorsqu'un chemin se dégrade.

Pour envoyer du trafic application-vers-personne vers des numéros américains, oui. L'enregistrement de marque et de campagne se gère dans le tableau de bord, et le statut est consultable via l'API.

Au message, à un tarif qui dépend du pays de destination et du type d'expéditeur utilisé : un code long américain et un identifiant alphanumérique britannique sont donc facturés différemment. Les tarifs sont publiés par pays sur la page de tarification SMS.

Oui, la facturation se fait par segment et non par message. Un segment contient 160 caractères GSM-7, ou 70 dès qu'un seul emoji ou caractère non latin force l'ensemble du message en Unicode. Les textes plus longs sont découpés et chaque segment est facturé, si bien qu'un seul caractère inattendu peut doubler le coût d'une campagne volumineuse.

Des frais opérateurs s'appliquent par message et varient selon la destination et l'opérateur. Aux États-Unis, le 10DLC implique également des frais d'enregistrement de marque et de campagne. Les deux sont détaillés sur la page des frais opérateurs SMS.

Le journal SMS affiche le nombre de segments et le coût de chaque message une fois celui-ci tarifé ; les métriques SMS agrègent le volume accepté, les segments et les dépenses dans le temps.

Un message GSM-7 contient 160 caractères par segment ; le passage en Unicode (UCS-2) pour les emojis ou les alphabets non latins réduit ce nombre à 70. Les messages plus longs sont concaténés sur plusieurs segments, et le SDK indique le nombre de segments avant l'envoi.

Douze segments, soit environ 1 836 caractères GSM-7 ou 804 caractères Unicode. Bird ne tronque jamais : un corps dépassant la limite renvoie une erreur 422. La limite porte sur les segments plutôt que sur les caractères, précisément parce que les deux encodages contiennent des quantités différentes.

Jusqu'à 100 dans un appel par lot, chacun avec son propre destinataire et texte. Un message individuel est envoyé à exactement un destinataire, le lot est donc le moyen de diffuser à plusieurs.

Une clé du forfait gratuit permet 10 envois unitaires et 5 appels par lot par minute, et les forfaits payants augmentent les deux. Chaque réponse inclut un en-tête IETF RateLimit indiquant ce qu'il reste et quand la fenêtre se réinitialise — calibrez-vous sur celui-ci plutôt que sur un nombre codé en dur.

C'est défini par les opérateurs, pas par Bird. Un numéro long 10DLC enregistré obtient un débit basé sur le score de confiance de la marque et le type de campagne : plus qu'un numéro non enregistré, moins qu'un numéro court. Les numéros courts obtiennent le débit le plus élevé et le plus prévisible.

Pour le trafic applicatif aux États-Unis, un code long 10DLC couvre la plupart des cas d'usage bidirectionnels et OTP. Les programmes à haut volume de type un-vers-plusieurs passent à un code court ; le numéro sans frais est une option pour les États-Unis et le Canada sans 10DLC.

Un code long ou un numéro sans frais est disponible immédiatement et commence à envoyer dès que son enregistrement ou sa vérification est validé. Les codes courts sont vérifiés par les opérateurs et prennent généralement plusieurs semaines.

Oui. Les codes longs, les codes courts et les numéros sans frais sont bidirectionnels : dirigez le trafic entrant d'un numéro vers un webhook et les réponses arrivent sous forme d'événements signés. Les identifiants d'expéditeur alphanumériques sont unidirectionnels uniquement.

Cela dépend du type d'expéditeur et du pays. Le trafic applicatif aux États-Unis nécessite l'A2P 10DLC, les numéros sans frais nécessitent une vérification, et de nombreux pays exigent un pré-enregistrement de l'identifiant d'expéditeur — le tout se gère depuis le tableau de bord.

C'est une courte chaîne de texte, généralement le nom de votre marque, qui s'affiche dans le champ « de » du destinataire à la place d'un numéro de téléphone. C'est un libellé sur le message, pas un numéro que vous possédez.

Restez concis : généralement jusqu'à 11 caractères sur les réseaux GSM. La contrainte exacte dépend du pays de destination et de l'opérateur, ainsi que de ce que chacun accepte.

Un numéro gratuit est un numéro 8xx (800, 888, 877 et les autres préfixes toll-free) qui envoie et reçoit des SMS aux États-Unis et au Canada. Il transporte du trafic applicatif sans A2P 10DLC, une fois la vérification toll-free validée.

Non. Les numéros toll-free ne font pas partie du système A2P 10DLC. Ils passent par une vérification toll-free, au cours de laquelle les opérateurs examinent le cas d'usage et le contenu des messages avant que le numéro ne soit autorisé à envoyer à plein volume.

Un numéro long à 10 chiffres (10DLC) est un numéro de téléphone local standard autorisé pour les SMS application-vers-personne aux États-Unis une fois sa marque et sa campagne enregistrées auprès des opérateurs.

Les numéros longs 10DLC enregistrés bénéficient d'un débit vérifié qui dépend du score de confiance de la marque et du type de campagne : plus qu'un numéro non enregistré, moins qu'un numéro court.

Un numéro court est un numéro de 5 à 6 chiffres approuvé par les opérateurs pour les SMS à haut volume de type un-vers-plusieurs : campagnes marketing, alertes et OTP à débit élevé. C'est le type d'expéditeur offrant le débit le plus élevé, et il passe par une vérification de l'opérateur avant de pouvoir envoyer.

Comptez en semaines, pas en minutes. Les opérateurs vérifient chaque programme de numéro court avant sa mise en service, ce qui implique un délai de mise en place réel, contrairement à un numéro long que vous pouvez acheter et utiliser dès que l'enregistrement est validé.

Un numéro court dédié vous appartient exclusivement, donc sa réputation d'envoi est entièrement la vôtre. Un numéro court partagé répartit un numéro entre plusieurs expéditeurs via des mots-clés : moins cher, plus rapide à démarrer, mais vous héritez de la réputation de tous les autres utilisateurs du numéro.

C'est vous, pour un envoi en texte libre : transmettez un numéro appartenant à votre espace de travail, un numéro court ou un identifiant d'expéditeur alphanumérique si le pays de destination l'autorise. Si vous l'omettez, l'envoi est rejeté plutôt que deviné. L'envoi par modèle fait exception, car il sélectionne son propre expéditeur.

Elle indique à Bird et aux opérateurs la raison de votre envoi, et les règles de conformité par pays, telles que la politique de désinscription et les heures de silence, en dépendent. Elle est obligatoire pour un envoi en texte libre ; un envoi par modèle hérite de la classification du modèle.

Transmettez une clé d'idempotence et une requête relancée renverra le résultat original au lieu d'envoyer le message deux fois. Sans clé, une relance est traitée comme un nouveau message.

Chaque changement d'état déclenche un webhook signé HMAC (mis en file d'attente, envoyé, livré ou échoué), contenant l'accusé de réception de l'opérateur et le nombre de segments.

Chaque message envoyé à votre numéro provisionné arrive sous forme d'un webhook sms.received signé HMAC. Vous vérifiez une signature, lisez les champs from, to et text, et routez le tout dans votre propre logique — la même enveloppe que vous gérez déjà pour les accusés de réception.

Oui. Répondez en envoyant depuis le même numéro sur lequel le message est arrivé. Définissez from sur votre numéro et to sur l'expéditeur d'origine, et le fil de conversation reste sur un seul numéro de bout en bout.

Bird adds the sender to your suppression list and fires sms_suppression.created, and blocks later sends from that sender to that number automatically. HELP returns a help reply and START opts them back in, all handled before they reach your code, so you stay compliant without writing the keyword logic yourself.

Vous avez besoin d'un numéro compatible bidirectionnel. Les numéros longs, les numéros courts et les numéros gratuits prennent en charge les messages entrants ; les identifiants d'expéditeur alphanumériques sont réservés à l'envoi et ne peuvent pas recevoir de réponses.

Votre message est transmis directement à l'opérateur mobile via l'une de nos 240 connexions directes, sans passer par une chaîne de revendeurs. Moins de sauts signifie moins d'endroits où un message peut se bloquer ou un accusé de réception peut se perdre.

Bird resélectionne la route en temps réel. Si un chemin commence à perdre des accusés de réception ou à ralentir, le message suivant emprunte une connexion plus saine vers le même opérateur, et l'envoi que vous avez codé ne change jamais.

Chaque message retourne un accusé de réception opérateur sous forme de webhook sms.delivered ou sms.failed, contenant le mcc_mnc, le country et le latency_ms. Il s'agit de la confirmation propre de l'opérateur, pas d'une déduction de notre part.

Oui. Nous effectuons une recherche MNP à chaque envoi pour identifier l'opérateur actuel du destinataire, afin qu'un numéro porté soit acheminé vers l'opérateur qui le détient réellement. Pour l'intelligence numérique autonome, consultez Lookup.

Le routage équilibre coût et qualité de livraison par destination. Le trafic transactionnel comme les codes à usage unique privilégie le chemin de meilleure qualité ; le trafic en masse peut tendre vers le coût le plus bas. La sélection s'effectue par message, derrière le même appel API.

De l'accusé de réception opérateur (DLR) pour chaque envoi. Bird enregistre l'accusé en regard du message, puis agrège ces accusés en indicateurs de livraison, d'échec et de latence. Un compteur « livré » est une confirmation de l'opérateur, pas une estimation de Bird.

Yes, from its own endpoint. The stats API has one breakdown per dimension (carrier, country, originator, category, status, error code, tag) plus daily and hourly series, and each row carries the one dimension you asked for. Crossing two of them, such as a carrier inside a country, means two calls and joining the rows yourself. A failure rate that looks fine nationally often turns out to be one carrier rejecting one sender ID.

Les deux. Chaque état de livraison arrive déjà sous forme de webhook, vous pouvez donc construire votre propre stockage à partir du flux d'événements. L'API de statistiques est là quand vous voulez que Bird fasse l'agrégation au lieu de maintenir un compteur vous-même.

Transmettez l'identifiant du message au point de terminaison des événements et vous obtenez sa chronologie complète : mis en file d'attente, envoyé, livré ou échoué, chacun avec un horodatage et, en cas d'échec, le code de raison de l'opérateur. C'est le rapport dont vous avez réellement besoin quand un client dit qu'un SMS n'est jamais arrivé.

Oui. La désinscription est réversible. Un destinataire qui envoie START est retiré de la liste de suppression et peut à nouveau recevoir des messages. Le choix reste celui du destinataire.

La liste de suppression est une ressource API interrogeable. Vérifiez un numéro avant de constituer une audience afin qu'un destinataire désinscrit ne réintègre jamais un envoi.

Cela dépend de la destination et du contenu de vos envois. Le trafic applicatif aux États-Unis nécessite l'enregistrement de marque et de campagne A2P 10DLC. De nombreux pays exigent un pré-enregistrement de l'identifiant d'expéditeur pour les expéditeurs alphanumériques. La gestion du désabonnement s'applique partout et ne nécessite aucune configuration.

Bird soumet chaque enregistrement auprès des opérateurs ou des registres et signale son statut via l'API. Votre code peut interroger l'état de l'enregistrement et attendre l'approbation plutôt que d'envoyer dans une campagne qui n'est pas encore active.

Non. Elle utilise le même client et les mêmes clés que l'envoi, les numéros et la communication bidirectionnelle. Le statut d'enregistrement et la liste de suppression sont des ressources API aux côtés de l'appel d'envoi, de sorte qu'une seule intégration couvre à la fois l'envoi et les règles qui l'encadrent.

Pour lutter contre l'usurpation d'identité, de nombreux pays ne délivrent les identifiants d'expéditeur alphanumériques que s'ils ont été préenregistrés auprès des opérateurs locaux ou du régulateur. Lorsque cette règle s'applique, un expéditeur non enregistré est rejeté ou réécrit.

Bird s'en charge. Vous soumettez l'identifiant d'expéditeur et la destination depuis le tableau de bord, Bird le transmet au registre local, et l'API vous indique son statut afin que vous sachiez quand l'expéditeur est actif.

L'approbation passe par des opérateurs et registres externes et varie selon le pays, généralement de quelques jours à quelques semaines. Interrogez le statut de l'enregistrement via l'API et attendez la confirmation avant d'envoyer depuis cet identifiant d'expéditeur.

A2P 10DLC est le cadre des opérateurs américains pour les SMS application-vers-personne envoyés via des numéros longs standard à 10 chiffres. Une entreprise enregistre la marque associée à son trafic et une campagne décrivant les messages, et les opérateurs vérifient les deux avant d'accorder le débit.

La marque est l'entité juridique qui envoie le trafic. Une campagne décrit un cas d'usage de messagerie spécifique sous cette marque. Une marque peut avoir plusieurs campagnes, et vous associez des numéros à une campagne plutôt qu'à la marque.

La vérification de la marque et de la campagne passe par les opérateurs et le registre et prend généralement de quelques jours à quelques semaines. Interrogez le statut de la campagne via l'API afin que votre code attende l'approbation avant d'envoyer.

Non. Le 10DLC est un cadre américain. D'autres pays ont leurs propres règles, beaucoup exigeant un préenregistrement de l'identifiant d'expéditeur, et la gestion des mots-clés de désinscription s'applique partout où vous envoyez.

Votre appel vers Bird l'est, via HTTPS, tout comme le webhook entrant que nous vous envoyons. Le dernier saut ne nous appartient pas : le SMS est un protocole opérateur sans chiffrement de bout en bout, et le message est lisible sur le terminal et par l'opérateur. C'est pourquoi il vaut mieux ne pas inclure d'informations sensibles dans le corps du message et préférer WhatsApp ou l'e-mail pour tout contenu confidentiel.

Chaque événement est signé par HMAC. Vérifiez la signature avec le secret de votre endpoint avant d'agir sur le payload, et effectuez la rotation de ce secret depuis le tableau de bord dès que nécessaire.

Dans la région où votre organisation est hébergée, soit us1, soit eu1. Votre clé API porte cette information dans son préfixe (bk_us1_…, bk_eu1_…), ce qui permet aux SDK et au CLI de sélectionner automatiquement le bon endpoint sans configuration de votre part.

Uniquement ce à quoi vous la limitez. Une clé comporte une liste de scopes, chacun en lecture ou écriture : une clé qui envoie des SMS ne peut ni gérer vos numéros ni lire un autre canal. Les actions de contrôle comme la gestion des membres et l'émission de clés sont réservées au tableau de bord et aucune clé ne peut y accéder.

Les deux. Une clé accepte une liste blanche de plages CIDR et rejette les requêtes provenant de toute autre source. La rotation d'une clé laisse l'ancienne active pendant une période de grâce (24 heures par défaut, ou zéro pour la couper immédiatement), évitant ainsi toute interruption de service.

Oui. Le journal d'audit est un enregistrement en lecture seule, à l'échelle de l'organisation, de chaque action de gestion, avec l'auteur, le workspace, l'heure et le résultat, et il s'exporte en OCSF pour votre propre SIEM.

Les certifications et la documentation de sécurité se trouvent dans le Trust Center sur trust.bird.com. L'accord de traitement des données, la déclaration de confidentialité et la politique d'utilisation acceptable sont publiés sur bird.com/legal. Pour un questionnaire fournisseur, votre équipe de compte Bird s'en charge.