Routage

Le chemin de l'envoi au combiné.

Atteignez vos clients via une seule API d'envoi pendant que Bird gère la connectivité opérateur. Choisissez les destinations prises en charge et l'expéditeur approprié, puis suivez le résultat de livraison signalé. Examinez les échecs par pays ou par opérateur lorsqu'une route, un destinataire ou un enregistrement nécessite votre attention.

Le chemin emprunté par votre message

Flux d'envoi

01

Votre application

Choisissez le destinataire, l'expéditeur, la catégorie et le message.

02

Vérifications de destination et d'expéditeur

Utilisez un marché activé et l'enregistrement requis.

03

Transmission à l'opérateur

Bird soumet le message via ses connexions opérateur.

04

Un résultat signalé

Suivez l'accusé de réception dans les enregistrements de messages, les webhooks et les analyses.

Un flux conceptuel. L'acceptation, la transmission à l'opérateur et l'accusé de réception décrivent différentes étapes du cycle de vie du message.

Des équipes qui créent des logiciels de classe mondiale nous font confiance au quotidien

Découvrir plus de témoignages clients

La couche sur laquelle votre envoi circule.

Le routage se situe sous l<hub>Bird SMS API</hub>. Bird vérifie la destination et lexpéditeur avant l'acceptation, puis soumet le message préparé à son transport opérateur. Examinez l'opérateur signalé et le résultat pour décider s'il faut investiguer un problème d'expéditeur, de destination ou de destinataire.

Comprenez les décisions avant la transmission à l'opérateur.

L'éligibilité, la préparation du message et la soumission à l'opérateur ont des rôles distincts.

  1. 01

    Connectivité opérateur.

    Bird gère les connexions opérateur derrière votre envoi. Utilisez le catalogue de destinations pour vérifier les types d'expéditeur pris en charge et les exigences d'enregistrement pour les marchés que vous desservez.

  2. 02

    Un expéditeur et une destination préparés.

    Le type d'expéditeur, les règles de destination et l'enregistrement déterminent quel identifiant peut être utilisé. Une configuration valide est établie avant la mise en file d'attente du message pour le transport.

  3. 03

    Informations opérateur lorsqu'elles sont disponibles.

    Le traitement peut résoudre l'opérateur du destinataire pour la tarification. En cas de recherche manquante ou échouée, la tarification par pays s'applique par défaut. Les informations opérateur dans un accusé de réception peuvent aussi être absentes ; évitez de déduire un réseau à partir du préfixe téléphonique seul.

  4. 04

    Les accusés de réception comme preuve opérateur.

    Un accusé de réception opérateur peut signaler une livraison ou un résultat terminal de non-livraison. Certains messages restent en attente d'un accusé de réception, et les champs opérateur manquants sont inconnus. Lisez la chronologie des événements parallèlement au statut actuel.

  5. 05

    Discutez des exigences de route pour un déploiement.

    La requête publique SMS ne propose pas de sélecteur de route au moindre coût ou à la meilleure qualité. Discutez du mix de destinations, des exigences d'expéditeur et du débit avec un spécialiste SMS lors de la planification de trafics plus importants.

Un résultat de livraison que vous pouvez investiguer.

Un parcours SMS réussi dépend de la destination, de l'enregistrement de l'expéditeur, du contenu du message et du chemin opérateur. Bird rassemble ces décisions dans un seul flux d'envoi. Commencez par les exigences de la destination, puis utilisez les enregistrements de messages et les résultats opérateur pour identifier ce qui doit changer.

L'accusé de réception, directement de l'opérateur.

Une requête réussie renvoie 202 avant la livraison opérateur. Les événements suivants peuvent inclure l'opérateur signalé et le MCC/MNC. Traitez les champs absents comme inconnus et examinez la chronologie du message pour les preuves disponibles.

POST /webhooks/bird
signed
{
  "type": "sms.delivered",
  "timestamp": "2026-05-19T15:42:01.221Z",
  "data": {
    "sms_id":       "sms_4kT01Lq2m",
    "workspace_id": "ws_8KQ2",
    "to":           "+15005550006",
    "from":         "+12025550188",
    "tags":         null,
    "metadata":     null,
    "carrier":      "Verizon",
    "mcc_mnc":      "311480",
    "cost": {
      "amount":             "0.0079",
      "currency_code":      "USD",
      "transaction_amount": "0.0079",
      "passthrough_amount": null
    }
  }
}

Les champs opérateur et MCC/MNC sont signalés lorsqu'ils sont disponibles. Un écart par rapport aux attentes basées sur le préfixe est une raison d'investiguer ; cela ne prouve pas en soi la portabilité du numéro.

  • sms.deliveredL'opérateur a confirmé que le combiné a reçu le message (DLR).
  • sms.failedL'opérateur a rejeté le message ou n'a pas pu le livrer, avec la raison indiquée.

Le routage s'appuie sur l'intelligence de numéro.

Utilisez Lookup lorsque votre application a besoin de renseignements sur les numéros de téléphone pris en charge. Abonnez-vous aux webhooks pour les résultats SMS et utilisez la référence des erreurs et le guide de délivrabilité pour interpréter les échecs signalés. Un résultat de lookup n'établit pas l'éligibilité de l'expéditeur et ne garantit pas la livraison.

Questions avant de construire

Comment vérifier la couverture d'une destination ?
Ouvrez le catalogue de destinations et consultez les types d'expéditeurs et les exigences d'enregistrement pour chaque marché. Votre espace de travail doit également autoriser la destination avant qu'un envoi soit accepté.
Qu'établit un accusé de réception opérateur ?
Il signale le résultat de livraison transmis par l'opérateur. Les accusés peuvent arriver après l'acceptation, et l'enregistrement du message peut encore être en attente. La livraison ne mesure pas si quelqu'un a lu le texte ou a agi dessus.
Comment investiguer un échec de routage ?
Commencez par le statut du message et le motif d'échec. Comparez les données par opérateur, pays ou expéditeur, puis vérifiez l'enregistrement et la configuration de la destination. Un taux d'échec agrégé seul n'identifie pas la cause.
Puis-je inspecter un numéro de téléphone séparément ?
Utilisez Lookup lorsque votre application a besoin d'informations sur un numéro de téléphone avant l'envoi. Consultez les signaux et la disponibilité de cette recherche plutôt que de considérer un rapport de livraison SMS comme une vérification complète du numéro.

Facilitez l'investigation des résultats de routage.

Préparez les destinations et les expéditeurs via Bird, puis examinez les résultats des messages avec les preuves opérateur disponibles. Utilisez le guide de destination lors de la planification d'un nouveau marché.

Vos coordonnées

Tous les champs de contact sont obligatoires.

Pour que notre équipe puisse vous contacter au sujet de votre démo.

Produits d'intérêt

Facultatif

Nous vous contacterons pour organiser votre démo.
Politique de confidentialité

Commencez avec un seul canal.
Ajoutez les autres quand vous êtes prêt.

Une clé API de test est disponible immédiatement. L'accès production se débloque dès que vous ajoutez un moyen de paiement et vérifiez un expéditeur.

Vous utilisez Claude Code, Cursor ou Codex ? Copiez un prompt de configuration et votre agent installe la CLI Bird et les compétences pour vous. Choisissez le vôtre :

Cursor