Twilio Guida alla configurazione

💡 Cos'è la configurazione Twilio?

Cosa configurerai: la configurazione Twilio collega TapAlert al servizio SMS cloud di Twilio, consentendo all'app di inviare messaggi SMS anche quando il servizio cellulare del tuo telefono non è disponibile (ma non hai Wi-Fi).

Perché è importante: configurando le credenziali Twilio nell'app, abiliti un metodo fallback affidabile per l'invio di avvisi. Ciò è particolarmente importante durante i viaggi internazionali, in edifici con scarsa ricezione cellulare ocome aopzione obbligatoria per gli utenti iPhone che non possono inviare SMS direttamente dalle app.

Perché Twilio?
TapAlert utilizza Twilio perché è il servizio SMS più utilizzato al mondo, scelto da aziende come Uber e Airbnb. Non sono previsti canoni mensili: paghi solo pochi centesimi per ogni messaggio effettivamente inviato. Per un'app di emergenza che invia avvisi raramente, ciò significa un costo quasi zero. La configurazione richiede la copia di soli tre valori nell'app e se hai bisogno di aiuto esistono migliaia di tutorial online.

Cosa ti serve: un Twilio account con credenziali di autenticazione (SID account e token di autenticazione) e un ID mittente alfanumerico o un numero di telefono Twilio acquistato.

• ✅ La prova account invia veri SMS: un membro della famiglia può testare l'intera configurazione con la prova gratuita di Twilio (invia a verificato numeri) prima di spendere soldi.

📖 Informazioni sul servizio

L'opzione fornita in TapAlert di utilizzare il meccanismo Twilio (cloud)come aper inviare SMS offre la massima affidabilità, in particolare nei viaggi internazionali dove gli SMS in roaming spesso falliscono. Twilio può inviare SMS verso oltre 180 paesi. Tuttavia, il metodo che puoi utilizzare varia in base al Paese. Alcuni paesi supportano Twilio numeri di telefono, altri supportano solo ID mittente alfanumerici e alcuni richiedono il rispetto di normative locali specifiche.

Perché utilizzare Twilio su Androide? (Ridondanza intelligente)

Anche se disponi di una scheda SIM, la configurazione di Twilio è altamente consigliata per la Ridondanza:

• Scenario: ti trovi in ​​un edificio con Wi-Fi ma nessun segnale cellulare.
• Risultato: SMS diretti non riesce.
• Soluzione: TapAlert passerà automaticamente a Twilio e invierà l'avviso tramite Wi-Fi.

Tieni presente che per utilizzare questa funzione, obbligatoria per gli utenti iPhone, dovrai disporre di un ID Twilio account. Il costo dell'invio dei messaggi sarà lo stesso che se lo inviassi manualmente da Twilio. Nessun costo aggiuntivo verrà aggiunto dall'app.

Twilio Opzioni mittente

Puoi scegliere tra 2 opzioni per inviare SMS con Twilio:

OPZIONE A: utilizza l'ID mittente alfanumerico (consigliato per l'Europa)

• ✅ Vantaggio: Non è necessario acquistare un numero di telefono (risparmia sui costi mensili! A seconda del numero di messaggi inviati).
• ✅ Vantaggio: i destinatari vedono un nome (ad esempio, "TapAlert" o il tuo nome) invece di un numero casuale.
• ⚠️ Nota: solo unidirezionale (nessuna risposta) e non supportato in alcuni paesi (come gli Stati Uniti).
• ℹ️ Ulteriori informazioni sull'ID mittente alfanumerico

OPZIONE B: acquista un Twilio numero di telefono

• ✅ Vantaggio: Funziona in tutto il mondo (inclusi gli Stati Uniti).
• ⚠️ Costo: richiede l'acquisto di un numero (circa $ 1 al mese).

💰 Potenziali costi nascosti e fattori Prezzi

Sebbene Twilio offra generalmente messaggi a basso costo, il prezzo finale per SMS può essere superiore alla tariffa base a causa di diversi fattori. È importante esaminarli per evitare addebiti imprevisti.

1. Paese di destinazione Prezzi

Il prezzo Twilio varia in modo significativo a seconda del paese di destinazione del messaggio.

• Le tariffe più basse pubblicizzate (ad esempio, circa $ 0,0075) spesso si applicano ai messaggi inviati negli USA.
• L'invio ad altri paesi (ad esempio in Europa o in Asia) può essere notevolmente più costoso.
• Azione: controlla sempre i prezzi specifici per il Paese a cui intendi inviare avvisi.

2. Commissioni del vettore e delle normative

Oltre al prezzo base di Twilio, molti paesi e operatori locali impongono supplementi o "commissioni di passaggio".

• Si tratta di tariffe inevitabili aggiunte dai fornitori di telecomunicazioni, non Twilio.
• Essi a volte può raddoppiare il costo effettivo per messaggio in alcune regioni.

3. Segmentazione dei messaggi (messaggi lunghi)

La fatturazione degli SMS è basata su "segmenti".

• Un segmento SMS standard è di 160 caratteri.
• Se il tuo messaggio supera questo limite, viene suddiviso in più parti e ti viene addebitato un costo per ciascun segmento. I messaggi SMS TapAlert con Posizione informazioni superano questo limite. Per ridurre al minimo i costi di Twilio, evita di abilitare le Posizione Impostazioni (o semplicemente disabilita l'opzione Includi indirizzo nelle impostazioni). Puoi controllare la lunghezza effettiva di ciascun messaggio inviato nella schermata Cronologia avvisi.
• Importante: l'utilizzo di emoji o caratteri speciali non latini (Unicode) riduce il limite del segmento a soli 70 caratteri, triplicando potenzialmente il costo di un singolo avviso.

4. Tariffe per l'affitto del numero di telefono

Se scegli di acquistare un numero di telefono (Opzione B sopra):

• Paghi una tariffa di noleggio mensile per il numero stesso (in genere $ 1,00 - $ 4,00 USD/mese a seconda del Paese).
• Si tratta di un costo fisso ricorrente, indipendentemente dal fatto che tu invii messaggi.
• Alcuni numeri specifici (come i numeri di cellulare spagnoli in grado di inviare SMS) sono "Esclusivi" e richiedono un processo di richiesta manuale e tariffe più elevate.

5. Conversione valutaria e tasse

La fattura finale potrebbe includere tasse locali (come l'IVA).

Se la tua carta è in una valuta diversa da quella della tua Twilio account, la tua banca o Twilio potrebbero applicare commissioni di conversione della valuta.

⚙️ Passaggi di configurazione

Per configurare Twilio nell'app, segui questi passaggi:

1️⃣ Passaggio 1: ottieni le tue Twilio credenziali

1. Crea un account su Twilio.com.
2. Vai alla Twilio Console per trovare il tuo SID account e il Token di autenticazione.
3. Scegli il metodo del mittente (Opzione A o B sopra).

2️⃣ Passaggio 2: inserisci le credenziali nell'app

1. Apri il Impostazioni dell'app.
2. Abilita l'interruttore "Utilizza Twilio".
3. Inserisci il tuo SID account e il token di autenticazione.
4. Configura il mittente:
   • Se utilizzi l'Opzione A (Nome): attiva "Utilizza ID mittente alfanumerico", quindi digita il nome desiderato (massimo 11 caratteri) nel campo Nome mittente.
   • Se utilizzi l'opzione B (numero): lascia "Utilizza ID mittente alfanumerico" OFF e inserisci il numero Twilio acquistato nel campo Twilio Numero di telefono.

3️⃣ Passaggio 3: riepilogo dell'ID mittente alfanumerico

• Che cos'è? Ti consente di utilizzare un nome (come "MyHomeAlert") anziché un numero.
• Fiducia: i destinatari vedono immediatamente il tuo nome, il che garantisce che il tuo avviso venga risaltato.
• Nessuna risposta: tieni presente che i destinatari non possono rispondere a un nome.