SMS-afleverfouten
Een niet-afgeleverd SMS-bericht heeft een afleverstatus en een fout die het resultaat beschrijft. Gebruik deze referentie om de foutreden en numerieke providercode bij een bericht te interpreteren.
Requestfouten zoals een ongeldig verzendpayload gebruiken de API-foutcatalogus. De codes op deze pagina beschrijven berichten die zijn geaccepteerd en later zijn mislukt of zijn geweigerd.
De fout lezen
Open een bericht in het SMS-log en selecteer Details. Error toont de beschrijving en genormaliseerde foutreden. Carrier error code toont de numerieke providercode als er een is meegegeven.
Via de API, lees GET /v1/sms/messages/{message_id}. Het last_error bevat:
| Veld | Betekenis |
|---|---|
code | De genormaliseerde foutreden van Bird, zoals unreachable of unknown |
description | De gerapporteerde uitleg in woorden |
carrier_error_code | De ruwe code van de provider, indien meegegeven |
occurred_at | Wanneer de fout optrad |
Failure-webhookgebeurtenissen en berichttijdlijngebeurtenissen bevatten dezelfde velden in error.
De veldnaam carrier_error_code omvat ook codes van de verzendprovider van Bird, inclusief fraudebeschermingsblokkeringen. Een ontbrekende code betekent dat de provider er geen heeft meegegeven of dat het bericht vóór verzending is geweigerd.
Genormaliseerde foutredenen
Dit zijn de foutredenen die het bericht-API definieert. Providerontvangstbewijzen kunnen een specifiekere numerieke code bevatten dan de genormaliseerde reden weergeeft. Een bericht met code: unknown kan bijvoorbeeld alsnog een herkende carrier_error_code bevatten.
| Reden | Betekenis |
|---|---|
invalid_destination | Het nummer is niet toegewezen of ongeldig |
unreachable | Het toestel staat uit of is buiten bereik |
blocked_by_carrier | De ontvangende provider heeft het bericht gefilterd |
blocked_by_fraud_protection | Bird-fraudebescherming heeft vermoedelijke SMS-pumping geblokkeerd |
blocked_by_recipient | Het toestel van de ontvanger heeft de afzender geblokkeerd |
landline_unreachable | De vaste lijn accepteert geen SMS |
content_rejected | De carrier heeft de inhoud geweigerd |
sender_unregistered | De afzender mist een vereiste registratie |
recipient_opted_out | De ontvanger staat op een suppressielijst |
provider_unavailable | De provider of het netwerk was niet beschikbaar |
insufficient_balance | De werkruimte-wallet had onvoldoende saldo |
unknown | De fout kon niet worden geclassificeerd |
Dit is een open verzameling: accepteer onbekende waarden en bewaar de beschrijving en ruwe code voor onderzoek. Een tijdelijke oorzaak beëindigt deze berichtpoging; het garandeert geen automatische herindiening.
Foutcodes van de provider
Zoek de numerieke string op die wordt teruggegeven in carrier_error_code. Deze codes behoren tot de verzendprovider van Bird SMS; een andere provider kan dezelfde nummers een andere betekenis geven.
| Code | Betekenis |
|---|---|
0 | Geen fout |
1 | Onbekende abonnee |
2 | Onbekend basisstation |
3 | Onbekende mobiele schakelaar |
5 | Niet-geïdentificeerde abonnee |
7 | Toestel kan geen verbinding maken |
8 | Roaming niet toegestaan |
9 | Authenticatie van abonnee mislukt |
10 | SMS-bearer niet ingericht |
11 | SMS-dienst niet ingericht |
12 | Toestel op zwarte lijst |
13 | SMS-dienst geblokkeerd |
21 | SMS niet ondersteund |
26 | Netwerkoverdracht mislukt |
27 | Abonnee niet bereikbaar |
28 | Buiten bereik |
29 | Toestel uitgeschakeld |
30 | Storing in mobiele switch |
31 | Abonnee bezet |
32 | SMS-bezorgfout |
33 | Opslag voor wachtende berichten vol |
34 | Netwerksysteemfout |
35 | Vereiste gegevens ontbreken |
36 | Onverwachte berichtveldwaarde |
39 | Roaming-routeringsnummer niet beschikbaar |
40 | Netwerkgeheugen uitgeput |
71 | Niet-ondersteund alfabet |
72 | USSD bezet |
100 | Onvoldoende verzendsaldo |
101 | Onvoldoende abonneesaldo |
103 | Abonnee heeft zich afgemeld |
104 | Afzender niet geregistreerd |
105 | Inhoud niet geregistreerd |
106 | Campagnevolume overschreden |
107 | Campagnedoorvoer overschreden |
110 | Bericht gefilterd door operator |
130 | SurgeGuard heeft traffic pumping gedetecteerd |
131 | SurgeGuard heeft verdachte pumpingbestemming geblokkeerd |
Code 0 wordt weggelaten uit carrier_error_code bij het lezen van Bird-berichten en -events. Bewaar een onbekende code in je eigen administratie wanneer je contact opneemt met support.
Fraudebeschermingsblokkeringen
SurgeGuard is de SMS-fraudebescherming van Bird.
Berichten die door fraudebescherming zijn geblokkeerd, hebben de faalreden blocked_by_fraud_protection en de beschrijving "Blocked by fraud protection: suspected SMS pumping." De bezorgstatus blijft failed, rejected of expired, afhankelijk van het rapport van de provider. Dezelfde reden en beschrijving verschijnen in berichtdetails, tijdlijngebeurtenissen en faalwebhooks. De ruwe providercode blijft beschikbaar in carrier_error_code wanneer deze is meegegeven.
Filter in het SMS-log Failure reason op Blocked by fraud protection om deze berichten te vinden.
Oudere records kunnen nog unknown en generic_delivery_failure tonen. Deze labels alleen identificeren geen fraudebeschermingsblokkering. Zoek hun carrier_error_code op in Providerfoutcodes om de oorzaak te achterhalen. Als de code ontbreekt of onbekend is, neem dan contact op met support met de werkruimte-ID, bericht-ID, tijdstempel en providercode, indien meegegeven.
Wanneer je een geblokkeerd OTP onderzoekt, correleer dan de SMS met het account of verificatieverzoek dat de blokkering heeft veroorzaakt. Vermijd het automatisch opnieuw verzenden of wisselen van routes om de blokkering te omzeilen. Als je vermoedt dat een legitiem verzoek is geblokkeerd, neem dan contact op met support met de werkruimte-ID, bericht-ID, tijdstempel en providercode.
Volgende stappen
- SMS-log: bekijk een bericht en de bezorggeschiedenis.
- SMS-events: verwerk bezorg- en faalwebhooks.
- SMS-metrics: bekijk geaggregeerde faalresultaten.
- SMS API-fouten: interpreteer fouten die een API-verzoek retourneert.
Gerelateerde bronnen
Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.