--- title: "SMS-afleverfouten" description: "Zoek SMS-foutredenen en numerieke providercodes op, inclusief fraudebeschermingsblokkades, in berichtdetails, afleverbevestigingen en webhooks." canonical: "https://bird.com/nl-nl/documentatie/guides/sms/delivery-errors" --- # 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](/docs/api/errors). 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](/docs/guides/sms/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}`](/docs/api/reference/get-sms-message). 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](/docs/guides/sms/events#failure-events) en [berichttijdlijngebeurtenissen](/docs/api/reference/list-sms-message-events) 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](/docs/api/reference/get-sms-message) 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](#foutcodes-van-de-provider) 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](/docs/guides/sms/sms-log): bekijk een bericht en de bezorggeschiedenis. - [SMS-events](/docs/guides/sms/events): verwerk bezorg- en faalwebhooks. - [SMS-metrics](/docs/guides/sms/tracking-and-metrics): bekijk geaggregeerde faalresultaten. - [SMS API-fouten](/docs/api/errors/E12xxx): interpreteer fouten die een API-verzoek retourneert. ## Related resources - [Sending your first SMS](/learn/sms/sending-your-first-sms) (video) - [What does SMS mean?](/explained/sms/what-does-sms-mean) (answer) - [SMS](/sms-api) (product) - [Build your first integration](/learn/paths/integration) (course) [Get an implementation brief](/learn/workspace?topic=sms)