Ricevere i codici SMS di X (Twitter): una checklist per team di prodotto e QA

Per cosa X chiede un numero di telefono?

X usa i numeri di telefono in alcuni punti noti: come alternativa all'email in fase di registrazione, quando aggiungi un numero a un account esistente, nelle verifiche di accesso attivate da attività che sembrano insolite, per il ripristino della password e per l'autenticazione a due fattori tramite SMS. Nel corso degli anni X ha ristretto quali account possono usare l'SMS come secondo fattore e offre le app di autenticazione come opzione, quindi controlla le impostazioni attuali dell'account che stai testando. Ognuno di questi flussi invia un breve codice numerico, e ognuno merita di essere coperto se il tuo prodotto si integra con account X o li gestisce. Casi tipici sono uno strumento per i social media che fa l'onboarding di account di brand, un'agenzia che gestisce i profili dei clienti da un accesso di team condiviso e una suite QA che verifica come si comporta la tua app dopo che un utente collega un profilo X.

Checklist pre-volo per i test di verifica SMS di X (Twitter)

• Proprietà. L'account appartiene a te, alla tua azienda o a un cliente che ti ha chiesto di gestirlo. Un account per persona reale o azienda.
• Termini. Leggi le regole di X su numeri di telefono e automazione; si applicano in aggiunta alla nostra Acceptable Use Policy.
• Paese. Decidi quale mercato rappresenta l'account prima di ordinare.
• Id servizio. Su OTP Route l'id del servizio X è twitter.
• Infrastruttura. Una chiave Bearer (or_live_) e un ciclo di polling oppure un endpoint webhook.
• Durata. Questo account dovrà accedere di nuovo fra un mese? In tal caso leggi la sezione sulla linea dedicata prima di iniziare.

Da quale dei 198 paesi dovrebbe provenire il numero?

La rotta X copre 198 paesi, tra cui Stati Uniti, Canada, Regno Unito, Germania, Francia, India, Indonesia, Filippine, Giappone, Brasile, Messico, Turchia, Arabia Saudita, Kenya, Nigeria e Ghana. Abbina il numero al mercato che l'account serve o al caso di test che stai dimostrando: un account di brand regionale dovrebbe avere un numero della sua regione, e un test di localizzazione richiede la lingua e il formato del numero di quel paese. Una discordanza tra numero, posizione dell'IP e profilo è anche il tipo di segnale che può far scattare controlli aggiuntivi da parte di X.

Passaggi: ordinare un numero per X tramite l'API

URL di base: https://otproute.com/api/v1.

1. Cerca il prezzo per la tua coppia con GET /api/v1/prices?country=<id>&service=twitter, che conferma anche la disponibilità in tempo reale.
2. Crea l'ordine: POST /api/v1/activations con {"service": "twitter", "country": "<id>"}. Salva l'id di attivazione.
3. Inserisci il numero restituito nel campo telefono di X.
4. Recupera il codice dall'evento webhook, oppure interroga GET /api/v1/activations/{id} finché compare.
5. Se X rifiuta il numero, rilascialo con POST /api/v1/activations/{id}/cancel.

Gli id dei paesi vengono da GET /api/v1/countries; la documentazione API mostra le strutture di richiesta e risposta.

Come va costruito il ricevitore del webhook?

Iscriviti a activation.sms_received, activation.expired e activation.cancelled. Ogni consegna porta X-OTPRoute-Signature: t=<unix>,v1=<hex>; calcola l'HMAC-SHA256 su timestamp, un punto e corpo grezzo con il secret dell'endpoint, confronta in tempo costante e rifiuta i timestamp vecchi. Poiché le consegne possono ripetersi, memorizza gli id di attivazione già elaborati e ignora i duplicati. Il polling è un buon ripiego per le suite piccole, ben entro le 300 richieste al minuto. La guida all'HMAC contiene un esempio completo.

Preferisci cliccare? Nella dashboard apri l'OTP Gateway, scegli X e un paese, conferma il prezzo mostrato, incolla il numero in X e guarda il codice comparire accanto all'ordine.

Risoluzione dei problemi: X non ha inviato un codice

• Il numero è stato rifiutato. X può rifiutare i numeri virtuali, a volte con un messaggio che dice che il numero non può essere usato. Annulla, poi riprova più tardi o con un altro paese.
• Non è ancora arrivato nulla. Lascia aperta la finestra di 20 minuti invece di riordinare subito.
• X sta limitando le richieste. Richieste ripetute da un solo account possono far scattare i limiti di X; distanzia i tentativi.
• Il tuo gestore l'ha scartato. Controlla nei log gli errori e i fallimenti di firma.
• L'account è segnalato. Se X ha limitato l'account stesso, un nuovo numero non cambia la situazione; risolvila tramite i canali di supporto di X.

La regola del rimborso azzera il costo dell'insuccesso: paghi solo se il codice arriva, e le attivazioni scadute o annullate restituiscono l'intero importo al wallet.

Quando è più adatta una linea dedicata statunitense o canadese?

Un'attivazione monouso va bene per una singola verifica. Un account aziendale che deve superare verifiche di accesso o recuperare l'accesso mesi dopo ha bisogno di un numero che resti fisso. I Dedicated Number lo offrono negli Stati Uniti e in Canada, da $1.95/mese: SMS in entrata nella dashboard e sul tuo webhook tramite number.sms_received, SMS in uscita e chiamate dal browser. Confronta entrambi nella pagina dei numeri virtuali. OTP Route fattura tutto da un unico wallet prepagato, ricaricato con carta o USDT/USDC, con fatture PDF.

Domande frequenti

Qual è l'id del servizio X (Twitter) nell'API di OTP Route?

È twitter. Usalo nella richiesta dei prezzi e nel corpo dell'attivazione.

Posso ricevere un OTP di X senza una scheda SIM?

Sì, su un numero OTP Gateway in uno qualsiasi dei 198 paesi, mostrato nella dashboard o inviato al tuo webhook.

Perché X ha detto che il mio numero di telefono non può essere usato?

X può rifiutare alcuni numeri virtuali. Annulla l'attivazione per ottenere il rimborso e prova un altro paese o un altro momento.

Quanto costa un codice di verifica di X?

Da $0.20 a codice; il prezzo esatto dipende dal paese e viene mostrato prima di ordinare.

Posso riutilizzare lo stesso numero per accedere di nuovo a X?

Un'attivazione monouso riceve un solo codice. Per accessi ripetuti usa un numero dedicato statunitense o canadese.

Posso usare OTP Route per creare molti account X?

No. Serve a testare e gestire i tuoi account e prodotti legittimi nel rispetto dei termini di X.

Esiste una sandbox per costruire l'integrazione?

Sì. Su richiesta un account di sviluppo può passare alla sandbox e restituire numeri e codici simulati.

I nomi dei servizi sono marchi dei rispettivi proprietari. OTP Route non è affiliata a essi. Usa i numeri in modo lecito e rispetta i termini di ciascun servizio e la nostra Politica di Utilizzo Accettabile.