SMS

Short code, long code, toll-free of alfanumeriek: welk SMS-afzendertype moet ik gebruiken?

Kies een afzendertype dat de bestemming ondersteunt en gebruik een nummer als ontvangers moeten kunnen antwoorden.

Een afzender die in de ene bestemming werkt, kan in een andere niet in aanmerking komen. Of antwoorden worden ondersteund hangt ook af van het individuele nummer en de route ervan.

Wat zijn de vier afzendertypen?

Bird ondersteunt long codes, short codes, toll-free nummers en alfanumerieke afzender-ID's. Hun API-waarden zijn long_code, short_code, toll_free en alphanumeric.

Het landenbeleid kan toll-free nummers toestaan en tegelijkertijd long codes weigeren. Registratievereisten kunnen ook verschillen:

The toll_free value is distinct from long_code. A country can permit one and refuse the other, and the two usually demand different registration.

  • Long code. Een gewoon telefoonnummer dat wordt gebruikt voor berichtenverkeer. Verzenden en ontvangen hangen af van de SMS-mogelijkheden en bestemmingsondersteuning.
  • Toll-free. Een SMS-geschikt nummer in een ondersteunde toll-free reeks, met eigen verificatie- en routeringsvereisten.
  • Short code. Een korte numerieke identiteit die wordt gebruikt voor berichtenprogramma's. Lengte, beschikbaarheid, verzendsnelheid en registratie variëren per markt.
  • Alfanumeriek. Een naam die als afzender wordt weergegeven, met een limiet van 11 tekens. Een langere merknaam vereist een kortere verzendidentiteit. Ontvangers kunnen er geen antwoord aan adresseren.

Welke afzendertypen kunnen een antwoord ontvangen?

In aanmerking komende long codes, toll-free nummers en short codes kunnen antwoorden ondersteunen. Controleer de SMS-mogelijkheden en bestemmingsroute van het nummer, want de vorm ervan bepaalt niet of antwoorden worden ondersteund.

Als je programma inkomende berichten nodig heeft, kies dan een nummer dat antwoorden ondersteunt, want ontvangers kunnen niet antwoorden op een alfanumerieke naam. Dit geldt ook wanneer een abonnee een stopwoord moet terugsturen naar de afzender.

Het landenbeleid rapporteert antwoordondersteuning als een direction van one_way of two_way per afzendertype. Met een ondersteund nummer en een ondersteunde route kunnen inkomende SMS je applicatie bereiken.

Hoe kies ik zonder de regels van elk land te kennen?

Gebruik het gepubliceerde afzendertypebeleid van de bestemming en controleer vervolgens de vereisten van de afzender die je wilt gebruiken. Een land publiceert beleidsvermeldingen voor de afzendertypen die het rapporteert. Een ontbrekend type wordt daar niet ondersteund. Een vermeld type heeft nog steeds een eigen beschikbaarheidsstatus.

Elke beleidsvermelding rapporteert de volgende velden:

  • status, een van available, restricted, coming_soon of unavailable.
  • registration_mode, een van none, optional of required, en de program die de registratie uitvoert wanneer er een van toepassing is.
  • sender_id_behavior: preserved behoudt de afzender-ID die je opgeeft, overwritten vervangt deze vóór aflevering en unknown betekent dat het gedrag niet bevestigd is. Dit staat los van de registratiemodus, dus een verplichte registratie kan de afzender-ID na goedkeuring alsnog overschrijven. Optionele registratie behoudt de goedgekeurde afzender-ID en overschrijft deze vóór goedkeuring.
  • registration_timeline_min en registration_timeline_max, in werkdagen, wanneer het land een schatting publiceert.
  • throughput_mps, het gepubliceerde maximale verzendtempo in berichten per seconde voor dat afzendertype en die bestemming. Een waarde van 30 betekent bijvoorbeeld een plafond van 30 berichten per seconde. Een null-waarde geeft geen gepubliceerd tempo. Controleer de beschikbare account-, afzender- en carriercapaciteit, want die kunnen je werkelijke verzendtempo verder beperken.
  • direction, eenrichtings- of tweerichtingsverkeer.
  • allowed_source_countries, de landen van waaruit de afzender mag verzenden. Een lege lijst legt geen bronlandbeperking op.

Je kunt gepubliceerd landenbeleid vergelijken in SMS-bestemmingen. Lees de vereisten van je afzender apart, want het landenbeleid bepaalt niet de registratiestatus van die afzender:

bird sms senders requirements <sender-id> --country-code NL

Een niet-lege allowed_source_countries-lijst beperkt de geschiktheid tot afzenders uit die landen. Een afzender uit een ander land heeft geen route onder dat beleid. Registratie kan die herkomst niet geschikt maken.

Wat bepaalt welke afzender Bird daadwerkelijk gebruikt?

Geef voor een vrije-tekst API-verzending de geschikte afzender op in from. De API kiest geen afzenderpool als je het weglaat. Een systeemtemplateverzending selecteert de afzender uit het template. De geretourneerde from-waarde identificeert de afzender die voor dat bericht is gebruikt.

De routeringsprioriteit van het landenbeleid selecteert niet de afzender voor een vrije-tekstaanvraag. Je applicatie levert die.

Registratie en bestemmingstoegang staan los van elkaar. Een geregistreerde afzender kan nog steeds worden geblokkeerd wanneer de werkruimte de bestemming niet heeft geactiveerd, met E12020.

Wat moet ik concreet doen?

  1. Kies een afzendertype dat door de bestemming wordt ondersteund, inclusief eventuele bronlandbeperkingen.
  2. Kies een ondersteund nummer wanneer antwoorden vereist zijn, inclusief inkomende stopwoorden.
  3. Houd rekening met verplichte registratie en eventuele optionele registratie die je kiest, en gebruik de gepubliceerde doorlooptijd om de release te plannen.
  4. Vergelijk het gepubliceerde verzendsnelheidsplafond met je piekverkeer en bevestig vervolgens de account-, afzender- en carriercapaciteit.
  5. Bevestig afzenderregistratie en bestemmingstoegang van de werkruimte voordat je gaat verzenden.

Kort gezegd

  1. Bird onderscheidt vier afzendertypen.

    De API somt long_code, short_code, alphanumeric en toll_free op. Een bestemming kan het ene type toestaan en het andere weigeren.

  2. Antwoorden vereisen een ondersteund nummer en een route.

    Een alfanumerieke afzender kan alleen verzenden. Een nummer heeft SMS-mogelijkheid en een ondersteunde inkomende route nodig om antwoorden te ontvangen.

  3. Het landenbeleid bepaalt welke afzendertypen in aanmerking komen.

    Het bestemmingsbeleid rapporteert de beschikbaarheid van afzendertypen en eventuele toegestane bronlanden. Registratie creëert geen ontbrekende route.

  4. Registratie en capaciteit hangen af van het afzendertype en de bestemming.

    Gepubliceerde registratietijden zijn schattingen. De maximale verzendsnelheid wordt uitgedrukt in berichten per seconde.

Breng het in de praktijk.

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

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.