SMS

Wat zijn SMS quiet hours?

SMS quiet hours zijn perioden waarin een wet, carrierregel of platformbeleid het versturen van bepaalde berichten beperkt, vaak promotionele teksten.

Een campagne die 's ochtends wordt vrijgegeven in de ene tijdzone kan een ander publiek midden in de nacht bereiken. Je planningsbeslissing heeft de relevante lokale tijd van de ontvanger en de regels voor dat bericht nodig.

Wie stelt de beperkte uren in?

Wetten, carriervereisten en providerbeleid kunnen elk beperken wanneer je gedekte berichten verstuurt.

De regel bepaalt de berichttypen, tijdzone en uitzonderingen. Een landelijke samenvatting vangt mogelijk niet elke lokale beperking op die op je ontvangers van toepassing is.

Bijvoorbeeld, 47 CFR 64.1200(c)(1) beperkt gedekte telefonische verkoop in de VS vóór 8.00 uur of na 21.00 uur. Het gebruikt de lokale tijd van de gebelde partij. Paragraaf (e) breidt de relevante bepalingen uit naar draadloze telemarketingberichten.

Onder die beperking is een gedekt bericht om 7.00 uur lokale tijd van de ontvanger te vroeg, ook als je server 12.00 uur aangeeft. De TCPA-uitleg behandelt de reikwijdte van de regel.

Behandel niet elke quiet-hoursregel als een garantie voor de aankomsttijd. Controleer of de toepasselijke formulering het verzenden, het initiëren van contact of de bezorging regelt voordat je het schema ontwerpt.

Houdt Bird mijn bericht vast totdat verzenden is toegestaan?

Het SMS-endpoint van Bird stelt berichten niet uit op basis van quiet hours.

Het leidt de tijdzone van een ontvanger niet af uit het telefoonnummer. Het kiest ook geen verzendvenster op basis van de categorie van het bericht. Een verzoek doorloopt het gewone validatie- en bezorgproces ongeacht het tijdstip. Acceptatie garandeert nog steeds geen bezorging.

Het requestveld scheduled_at is ook niet beschikbaar: als je het meestuurt, retourneert het HTTP 422 SMSUnsupportedFeature. Plan de API-aanroep in je eigen applicatie. Het meesturen van het veld plaatst het bericht niet in een wachtrij.

Hoe vind ik de regel van een bestemming in Bird?

Je kunt het landbeleid en de bestemmingspagina van SMS bekijken voordat je je scheduler configureert.

Vraag GET /v1/country-policies/US/messaging-context?platform=sms op voor het VS-beleid. Vervang US door de tweeletterige landcode van de bestemming om een andere markt te controleren.

De platforms-array van het antwoord bevat het SMS-beleid, waaronder:

  • has_quiet_hours, een boolean of null, die aangeeft of beperkingen zijn geregistreerd.
  • quiet_hours_is_regulatory, een boolean of null, die onderscheid maakt tussen regulering en platformbeleid.
  • exempt_message_categories, een array met categorieën die zijn uitgesloten van quiet-hourbeperkingen.

Een ontbrekende waarde betekent niet dat onbeperkt verzenden is toegestaan. Raadpleeg de gepubliceerde richtlijnen en geldende regels van de bestemming wanneer het record het detail mist dat je nodig hebt.

Deze velden beschrijven beleid. Ze activeren geen scheduler in het SMS-verzendendpoint van Bird.

Hoe moet mijn applicatie het bericht plannen?

Houd gedekte berichten vast tot het volgende toegestane tijdstip voor die ontvanger. Controleer ze opnieuw voordat je ze verstuurt.

Sla een betrouwbare tijdzone op in het contactprofiel. Alleen de landcode van een telefoonnummer kan iemand die verhuisd is of op reis is niet lokaliseren. Kies een expliciet beleid voor onbekende tijdzones in plaats van aan te nemen dat de klok van je server geldt.

Controleer bij het vrijgeven opnieuw de toestemming. Bevestig dat het bericht nog steeds nuttig is. Een aanbieding kan verlopen zijn tijdens het wachten. Bewaar de identiteit van het uitgestelde bericht zodat een hergestarte scheduler het niet twee keer verstuurt.

Controleer bij urgente verificatiecodes de toepasselijke categorieregels voordat je een promotieberichtvenster toepast. Een aangevraagde code uitstellen tot de ochtend kan deze onbruikbaar maken.

Zijn antwoorden en transactionele berichten vrijgesteld?

Vrijstellingen hangen af van de geldende regel en het daadwerkelijke doel van het bericht.

Ga er niet van uit dat elke bezorgupdate, herinnering of verificatiecode overal dezelfde vrijstelling heeft. Controleer exempt_message_categories en de onderliggende regel van de bestemming voordat je een categorie uitsluit van je schema.

De ingebouwde trefwoordbevestigingen van Bird volgen hun trefwoordverwerking zonder een quiet-hoursscheduler. Hun vrijstelling van een SMS-onderdrukking maakt het mogelijk een opt-outbevestiging te versturen. Dat is een ander mechanisme dan een wettelijke vrijstelling op basis van tijdstip. STOP-trefwoorden legt dat gedrag uit.

Een aanbieding toevoegen aan een servicebericht kan het doel ervan veranderen. Toestemmingsmodellen van SMS behandelt de gerelateerde toestemmingsbeslissing.

Kort gezegd

  1. Gebruik de klok die de regel voorschrijft.

    Een beperking op basis van de lokale tijd van de ontvanger geldt waar de ontvanger zich bevindt, dus de lokale tijd van je server is ontoereikend.

  2. Bird plant niet rondom quiet hours.

    Het SMS-endpoint stelt een verzending niet uit op basis van het tijdstip. Het weigert scheduled_at.

  3. Landbeleidsvelden beschrijven de regel.

    Lees has_quiet_hours, quiet_hours_is_regulatory en exempt_message_categories naast de gepubliceerde richtlijnen van de bestemming.

  4. Controleer het doel van elk bericht.

    Een promotiecampagne en een aangevraagde verificatiecode vereisen een verschillende behandeling wanneer de toepasselijke regel ze onderscheidt.

Breng het in de praktijk.

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Probeer de oefening en ontvang een implementatieoverzicht

Bouw op hetzelfde netwerk.

Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra u een betaalmethode toevoegt en een afzender verifieert.

Jouw volgende idee.
Klaar om te verbinden.