Een geaccepteerd SMS kan alsnog mislukken door een ongeldig nummer, een onbereikbaar toestel of een netwerkprobleem. Het berichtrecord, het aflever-event en de teruggegeven fout helpen die uitkomsten van filtering te onderscheiden.
Hoe onderzoek ik een vermoedelijk filter?
Je vergelijkt het berichtrecord met de bijbehorende SMS-gebeurtenissen. De gebeurtenis beschrijft het resultaat; de fout en de providergegevens helpen het te verklaren.
| Event | Wat het event je vertelt |
|---|---|
sms.rejected | Verwerking of een downstream provider heeft het geaccepteerde bericht geweigerd. |
sms.failed | Er is een permanente fout gemeld. |
sms.undelivered | Er is een herstelbare fout gemeld, zoals een onbereikbare abonnee of een netwerkprobleem. |
sms.expired | De provider heeft verlopen gemeld. |
Geen enkel event bewijst op zichzelf filtering. In de afleverrapportkoppeling van Bird wordt een providerreden van carrier_rejected omgezet naar content_rejected. Een niet-gekoppelde reden wordt unknown, wat onderzoek vereist en een ongerelateerde oorzaak kan hebben. De status van een rapport bepaalt het event los van de reden, dus een carrierweigering kan bij verschillende foutevents voorkomen.
De foutencatalogus definieert blocked_by_carrier en sender_unregistered. Hun afwezigheid sluit filtering niet uit: Bird zet carrier_rejected om naar content_rejected en niet-herkende oorzaken naar unknown. Controleer de daadwerkelijk teruggegeven code, bewaar onbekende waarden en behoud de providergegevens.
Welke details moet ik bewaren?
Bewaar het bericht-ID, de afzender, bestemming, indientijd, het eventtype, de genormaliseerde error.code, beschrijving en carrier_error_code. Groepeer fouten op bestemming, afzender en berichttype; één enkele fout levert minder bewijs op dan een verandering die een consistente groep verzendingen raakt.
De genormaliseerde code is het stabiele veld voor de afhandeling in je applicatie. De beschrijving is diagnostische tekst, dus ontleed die niet als een vast contract. carrier_error_code bevat de meer gedetailleerde code van de verzendprovider wanneer die wordt meegegeven; het is niet gegarandeerd de eigen code van een mobiele carrier. Het kan leeg zijn wanneer de provider er geen levert of wanneer een fout optreedt vóór de overdracht aan de provider.
content_rejected wijst je bijvoorbeeld naar de gemelde weigering, invalid_destination naar het ontvangstnummer en provider_unavailable naar het netwerk- of capaciteitsresultaat. unknown laat de oorzaak onopgelost. Deel het bericht-ID en de beschikbare providercode met support wanneer die details de fout niet verklaren.
Voorkomt het registreren van mijn afzender filtering?
Registratie voldoet aan het toepasselijke afzenderprogramma; het garandeert geen aflevering. De afzender moet ook geschikt zijn voor de bestemming, en het bericht en verkeer moeten aan de relevante vereisten voldoen.
Controleer voor Amerikaanse A2P-berichten met lokale nummers de volledige 10DLC-registratie: merk, campagne en nummerkoppeling. Een goedgekeurd merk of campagne koppelt niet automatisch elk nummer dat je bezit. Tolvrije nummers en shortcodeprogramma's hebben andere vereisten. Andere bestemmingen kunnen afzendernaamregistratie vereisen.
Gebruik SMS-bestemmingen om de afzenderkeuze te plannen en bevestig vervolgens de toepasselijke vereisten en de registratiestatus van je werkruimte vóór lancering. Een landengids is een referentiemomentopname, geen bewijs dat je afzender is goedgekeurd.
Wat moet ik doen bij een opt-outfout?
Respecteer de voorkeur. Een verzending naar een door Bird onderdrukt afzender-en-ontvangerpaar wordt geweigerd bij de API met E12077; die weigering creëert geen bericht of berichtevent. Een downstream rapport van recipient_opted_out is iets anders: het is een uitkomst voor een geaccepteerd bericht en zorgt ervoor dat Bird een suppressie voor het paar registreert.
Ondersteunde afmeldtrefwoorden kunnen blokkeringen voor afzender-ontvangerparen aanmaken. Blokkeringsgebeurtenissen op paarniveau omvatten niet elke werkruimtevoorkeur of elk verzoek dat via de klantenservice binnenkomt. Neem die bredere voorkeuren mee in je doelgroepselectie. Wissel niet van afzender om een afmelding te omzeilen.
Wat moet ik controleren voordat ik opnieuw probeer?
- Gereedheid van de afzender. Bevestig het afzendertype, de registratie en de bestemmingstoegang die voor dit verkeer vereist zijn.
- Toestemming en relevantie. Bevestig dat de persoon heeft ingestemd met dit doel en die toestemming niet heeft ingetrokken.
- Inhoud en links. Identificeer het bedrijf duidelijk, gebruik passende links en controleer de inhoudsvereisten van de bestemming. Alleen een link wijzigen kan geen aflevergeschiktheid vaststellen.
- Verkeer en timing. Vergelijk de mislukte verzendingen met je normale patroon, wachtrij en de limieten van de route. Herhaaldelijk dezelfde geweigerde inhoud indienen kan kosten toevoegen zonder de oorzaak te verhelpen.
- De gemelde fout. Onderzoek permanente weigeringen voordat je opnieuw verzendt. Hergebruik bij een onduidelijk API-antwoord de oorspronkelijke idempotency-key binnen het replayvenster; maak van onzekerheid niet automatisch een tweede verzoek.
SMS-routering past bestemmingscontroles toe vóór overdracht aan de mobiele provider. Een SMS-integratie volgt elk geaccepteerd verzoek via het berichtrecord en de aflevergebeurtenissen.
Kort gezegd
Een mislukte aflevering is een startpunt voor onderzoek.
De gebeurtenis, de genormaliseerde fout en de providergegevens beschrijven de mislukking. Een onbekende oorzaak bewijst geen filtering door de mobiele provider.
Registratie is één vereiste, geen aflevergarantie.
Controleer de afzender, bestemming, inhoud, toestemming en het verkeerspatroon voordat je besluit wat je wijzigt.
Een opt-out is een voorkeur om te respecteren.
Maak onderscheid tussen een API-weigering voor een onderdrukt paar en een downstream opt-outrapport, en respecteer de volledige reikwijdte van het verzoek van de persoon.
Bewaar het bewijs bij het bericht.
Sla het bericht-ID, de bestemming, afzender, tijd, het event en de foutdetails op zodat je een patroon kunt onderzoeken of een nuttige supportcase kunt openen.