Een notificatieservice heeft zowel een manier nodig om berichten in te dienen als een route naar de telefoons van ontvangers. Een interface kiezen beantwoordt alleen het eerste deel van dat probleem.
Wat doet elk onderdeel?
Een API accepteert programmatische verzoeken. Een gateway overbrugt je applicatie en mobiele netwerken.
Je applicatie stuurt een ontvanger, afzender en bericht via de interface. De gateway geeft berichten door aan de netwerkdiensten die ze afleveren. Een provider kan beide onderdelen in één dienst aanbieden.
De SMPP-gatewayreferentie beschrijft gateways die applicaties verbinden met mobiele berichtencentrales. Het beschrijft ook gateways die meerdere interfaces bieden, waaronder HTTP en SMPP.
De interface bepaalt niet elke afleveringsmogelijkheid. Een handig verzoekformaat kan een niet-ondersteunde afzender niet geldig maken in een bestemming.
Welke interface moet ik kiezen?
Kies HTTP voor een nieuwe applicatie, tenzij een bestaande SMPP-integratie of een specifieke verbindingsvereiste het beheren van SMPP rechtvaardigt.
Met HTTP doet je applicatie verzoeken en verwerkt het antwoorden. Je hebt nog steeds opnieuw proberen, bescherming tegen dubbel verzenden en afhandeling van aflevergebeurtenissen nodig.
SMPP gebruikt een verbinding die open blijft. Je client authenticeert een sessie en handelt verbindingsverlies, bevestigingen en inkomende bewerkingen af. SMPP legt dat werk uit.
Een bestaand SMPP-systeem kan die interface een praktische keuze maken. Test de ondersteunde bewerkingen en limieten van de provider voordat je aanneemt dat een andere SMPP-verbinding zich identiek gedraagt.
Welke afleveringsmogelijkheden moet ik vergelijken?
Vergelijk bestemmingsdekking, toegestane afzenders, doorvoer en bruikbare foutrapportages met de behoeften van je applicatie.
- Bestemmingen: bevestig ondersteuning voor elk land dat je bedient, want één werkende route garandeert geen andere.
- Afzenders: controleer beschikbaarheid en registratie voordat je je vastlegt op de identiteit die ontvangers zien.
- Doorvoer: maak onderscheid tussen verzoeklimieten en de snelheid waarmee het afleverpad verkeer kan verwerken.
- Gebeurtenissen: controleer hoe inkomende berichten en afleverfouten je applicatie bereiken.
De bestemmingspagina's van Bird publiceren landspecifieke vereisten. Afzendertypen legt de identiteitskeuzes uit.
Waarom komt aflevering apart van acceptatie?
Het netwerk kan de aflevering voltooien nadat je verzendverzoek is afgerond.
Een berichtencentrale kan een bericht vasthouden zolang een telefoon onbereikbaar is. Berichtencentrales legt die wachtfase uit.
Houd indiening en aflevering als aparte resultaten in je applicatie. Anders kan een geaccepteerd verzoek succesvol lijken, zelfs als een later afleverrapport een fout registreert.
Hoe verstuur ik via de HTTP API van Bird?
Je dient een bericht in, slaat het identificatienummer op en verwerkt de aflevergebeurtenissen die volgen.
Gebruik POST /v1/sms/messages met to, from, text en category voor een vrije-tekstverzending. Stel category in op marketing, transactional, authentication of service. De verzendgids documenteert de ondersteunde velden.
Een 202-antwoord bevestigt acceptatie. Het bevestigt geen aflevering aan de telefoon. Volg het geretourneerde id via SMS-gebeurtenissen, zodat het uiteindelijke resultaat het juiste verzoek bijwerkt.
Welk pad past bij mijn applicatie?
Kies de interface die je applicatie betrouwbaar kan bedienen en verifieer de afleveringsmogelijkheden apart.
- Gebruik HTTP voor een nieuwe integratie zonder specifieke SMPP-vereiste.
- Gebruik SMPP wanneer een bestaand systeem of vereist verbindingsgedrag het sessiebeheer rechtvaardigt.
- Test de bestemmingen, afzenders en aflevergebeurtenissen voordat je verkeer naar een van beide paden stuurt.
Kort gezegd
De API en de gateway hebben verschillende taken.
De API accepteert je verzoek, terwijl de gateway het pad naar het mobiele netwerk levert.
HTTP voorkomt het beheren van een SMPP-sessie.
SMPP vereist verbindingsherstel en sessiebeheer naast je berichtenworkflow.
Acceptatie en aflevering blijven gescheiden.
Een succesvol verzendverzoek bevestigt niet dat de ontvanger het bericht heeft ontvangen.
Vergelijk het afleverpad én de interface.
Controleer bestemmingsondersteuning, afzendervereisten, doorvoer en foutrapportage voordat je een integratie kiest.