Twilio Installatiehandleiding

💡 Wat is Twilio configuratie?

Wat je gaat instellen: Twilio configuratie verbindt TapAlert met de cloud-sms-service van Twilio, waardoor de app sms-berichten kan verzenden, zelfs als de mobiele service van je telefoon niet beschikbaar is (maar je hebt wifi).

Waarom het belangrijk is: door Twilio inloggegevens in de app te configureren, schakelt u een betrouwbare fallback-methode in voor het verzenden van waarschuwingen. Dit is vooral belangrijk tijdens internationale reizen, in gebouwen met een slechte mobiele ontvangst, of eenals eenverplichte optie voor iPhone-gebruikers die niet rechtstreeks vanuit apps een sms kunnen sturen.

Waarom Twilio?
TapAlert gebruikt Twilio omdat dit de meest gebruikte sms-service ter wereld is, waarop bedrijven als Uber en Airbnb vertrouwen. Er zijn geen maandelijkse kosten: u betaalt slechts een paar cent per daadwerkelijk verzonden bericht. Voor een noodapp die zelden waarschuwingen verzendt, betekent dit vrijwel geen kosten. Voor de installatie hoeft u slechts drie waarden naar de app te kopiëren, en er zijn duizenden online tutorials beschikbaar als u hulp nodig heeft.

Wat je nodig hebt: een Twilio rekening met authenticatiegegevens (Account SID en Auth Token), en een alfanumerieke afzender-ID of een gekocht Twilio telefoonnummer.

• ✅ Proefperiode rekening stuurt een echte sms: Een gezinslid kan de volledige installatie testen met de gratis proefperiode van Twilio (wordt verzonden naar geverifieerd nummers) voordat hij geld uitgeeft.

📖 Over de dienst

De optie die wordt geboden in TapAlert om het Twilio (cloud)als eenmechanisme te gebruiken om sms-berichten te verzenden, biedt ultieme betrouwbaarheid, vooral bij internationale reizen, waar roaming-sms'jes vaak mislukken. Twilio kan sms-berichten verzenden naar meer dan 180 landen. De methode die u kunt gebruiken, verschilt echter per land. Sommige landen ondersteunen telefoonnummers van Twilio, andere ondersteunen alleen alfanumerieke afzender-ID's en voor sommige landen moet aan specifieke lokale regelgeving worden voldaan.

Waarom Twilio gebruiken op Android? (Slimme redundantie)

Zelfs als je een simkaart hebt, wordt het instellen van Twilio ten zeerste aanbevolen voor Redundantie:

• Scenario: u bevindt zich in een gebouw met wifi, maar geen mobiel signaal.
• Resultaat: Directe sms mislukt.
• Oplossing: TapAlert schakelt automatisch over naar Twilio en verzendt de waarschuwing via wifi.

Houd er rekening mee dat om deze functie, die verplicht is voor iPhone-gebruikers, te gebruiken, je een Twilio rekening ID nodig hebt. De kosten voor het verzenden van berichten zijn hetzelfde als wanneer u dit handmatig zou doen vanuit Twilio. Er worden door de app geen extra kosten toegevoegd.

Twilio Afzenderopties

Je kunt kiezen uit 2 opties om sms'jes te versturen met Twilio:

OPTIE A: Gebruik alfanumerieke afzender-ID (aanbevolen voor Europa)

• ✅ Voordeel: U hoeft geen telefoonnummer te kopen (bespaar maandelijkse kosten! afhankelijk van het aantal berichten dat u verzendt).
• ✅ Voordeel: ontvangers zien een naam (bijvoorbeeld "TapAlert" of uw naam) in plaats van een willekeurig getal.
• ⚠️ Opmerking: Alleen eenrichtingsverkeer (geen antwoorden) en niet ondersteund in sommige landen (zoals de VS).
• ℹ️ Meer informatie over alfanumerieke afzender-ID

OPTIE B: Koop een Twilio telefoonnummer

• ✅ Voordeel: Werkt wereldwijd (inclusief de VS).
• ⚠️ Kosten: vereist aankoop van een nummer (ongeveer $ 1/maand).

💰 Potentiële verborgen kosten en factoren van Prijzen

Hoewel Twilio over het algemeen goedkope berichtendiensten aanbiedt, kan de uiteindelijke prijs per sms hoger zijn dan het basistarief vanwege verschillende factoren. Het is belangrijk om deze te controleren om onverwachte kosten te voorkomen.

1. Land van bestemming Prijzen

De prijzen voor Twilio variëren aanzienlijk, afhankelijk van het land van bestemming van het bericht.

• De laagste geadverteerde tarieven (bijvoorbeeld rond de $ 0,0075) zijn vaak van toepassing op berichten die naar de VS worden verzonden.
• Verzenden naar andere landen (bijvoorbeeld in Europa of Azië) kan aanzienlijk duurder zijn.
• Actie: controleer altijd de specifieke prijzen voor het land waarnaar u waarschuwingen wilt sturen.

2. Vergoedingen van vervoerders en toezichthouders

Naast de basisprijs van Twilio, leggen veel landen en lokale vervoerders toeslagen of 'pass-through-kosten' op.

• Dit zijn onvermijdelijke kosten die door de telecomproviders worden toegevoegd, en niet Twilio.
• Zij kan in bepaalde regio's soms de effectieve kosten per bericht verdubbelen.

3. Berichtsegmentatie (lange berichten)

SMS-facturering is gebaseerd op 'segmenten'.

• Een standaard sms-segment is 160 tekens.
• Als uw bericht deze limiet overschrijdt, wordt het in meerdere delen opgesplitst en worden er kosten in rekening gebracht voor elk segment. TapAlert SMS-berichten met Locatie info overschrijden deze limiet. Om de Twilio kosten te minimaliseren, vermijdt u het inschakelen van Locatie Instellingen (of schakelt u gewoon de optie Adres opnemen uit in de instellingen). U kunt de werkelijke berichtlengte van elk verzonden bericht controleren in het scherm Waarschuwingsgeschiedenis.
• Belangrijk: door emoji's of speciale niet-Latijnse tekens (Unicode) te gebruiken, wordt de segmentlimiet teruggebracht tot slechts 70 tekens, waardoor de kosten van een enkele melding mogelijk verdrievoudigen.

4. Telefoonnummerhuurkosten

Als u ervoor kiest een telefoonnummer te kopen (optie B hierboven):

• U betaalt een maandelijkse huurprijs voor het nummer zelf (doorgaans $ 1,00 - $ 4,00 USD/maand, afhankelijk van het land).
• Dit zijn terugkerende vaste kosten, ongeacht of u berichten verzendt.
• Sommige specifieke nummers (zoals Spaanse mobiele nummers die geschikt zijn voor sms) zijn "Exclusief" en vereisen een handmatig aanvraagproces en hogere kosten.

5. Valutaconversie en belastingen

Op uw eindafrekening kunnen lokale belastingen (zoals BTW) zijn opgenomen.

Als uw kaart in een andere valuta is dan uw Twilio rekening, kan uw bank of Twilio kosten voor valutaconversie in rekening brengen.

⚙️ Configuratiestappen

Volg deze stappen om Twilio in de app in te stellen:

1️⃣ Stap 1: Verkrijg uw Twilio-referenties

1. Maak een rekening op Twilio.com.
2. Ga naar de Twilio console om uw Account-SID en Auth Token te vinden.
3. Kies uw afzendermethode (Optie A of B hierboven).

2️⃣ Stap 2: Voer inloggegevens in de app in

1. Open de App-Instellingen.
2. Schakel de schakelaar "Gebruik Twilio" in.
3. Voer uw Account-SID en Auth Token in.
4. Configureer de afzender:
   • Als u Optie A (Naam) gebruikt: Schakel "Gebruik alfanumerieke afzender-ID" in en typ vervolgens de gewenste naam (max. 11 tekens) in het veld Naam afzender.
   • Als je Optie B (Nummer) gebruikt: Laat 'Gebruik alfanumerieke afzender-ID' UIT en voer je gekochte Twilio nummer in het veld Twilio Telefoonnummer in.

3️⃣ Stap 3: Samenvatting van alfanumerieke afzender-ID

• Wat is het? Je kunt er een naam (zoals "MyHomeAlert") mee gebruiken in plaats van een nummer.
• Vertrouwen: ontvangers zien uw naam onmiddellijk, waardoor uw melding opvalt.
• Geen antwoorden: houd er rekening mee dat ontvangers niet op een naam kunnen reageren.