HarborOrganizationWorkspacesProductionSandbox
Delivery agent
API key · Customer operations teamALAlex Lee AdminPermissions updated
Le parcours de
l'envoi au téléphone.
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.
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.
- 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.
- 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.
- 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.
- 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.
- 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.
Le reste de la plateforme SMS
Une seule API, un seul jeu de clés. Explorez les autres capacités.
EnvoiL'API d'envoi : segments, sécurité Unicode, lots et idempotence.NumérosLong codes, short codes, toll-free et sender IDs alphanumériques.BidirectionnelSMS entrants et réponses conversationnelles sous forme de webhooks signés HMAC.ConformitéEnregistrement A2P 10DLC, mots-clés de désinscription et règles d'identifiant d'expéditeur.AnalyseRésultats de livraison, raisons d'échec et latence à partir des accusés de réception opérateur.Aperçu de l'API SMSL'API SMS complète : envoi, numéros, bidirectionnel, conformité, routage et analyse.Bibliothèque de ressources SMSTrouvez des guides, des réponses détaillées et des outils pour votre prochaine étape.
Évoluez sans
perdre le contrôle.
Organisez vos équipes en espaces de travail, contrôlez l'accès à l'API et tracez les modifications via les journaux d'audit.
HarborOrganizationActive
Audit log
Production- Workspace
- Production
- Resource
- Delivery agent
- ReadRead & write
Team Customer operationsActor role AdminOutcome SucceededTime 22 Sep, 09:42:18 UTC
Succeeded