Guida Completa ai Link Click-to-Chat di WhatsApp e agli Schemi URL

Guida Completa ai Link Click-to-Chat di WhatsApp e agli Schemi URL

La funzione «Click-to-Chat» di WhatsApp permette di avviare una conversazione con qualsiasi utente o attività commerciale senza dover prima memorizzare il relativo numero nella rubrica del telefono. Quando il numero è valido e dispone di un account WhatsApp attivo, un link URL diretto consente di aprire immediatamente la chat.

Sebbene il meccanismo sia semplice, piccoli errori di formattazione — come il segno più (+), gli zeri iniziali (0), parentesi o un'errata codifica dei ritorni a capo — generano quotidianamente milioni di collegamenti interrotti.

In questa guida tecnica esaminiamo gli schemi URL ufficiali, le regole di formattazione standard E.164 e le migliori pratiche per desktop, iPhone e Android.

---

1. I Formati URL Ufficiali di WhatsApp

WhatsApp supporta ufficialmente due strutture URL per le chat dirette:

Lo Standard Moderno: https://wa.me/<numero>

Il formato consigliato da Meta/WhatsApp si basa sul dominio breve wa.me:

https://wa.me/393401234567

Con messaggio precompilato:

https://wa.me/393401234567?text=Buongiorno%20vorrei%20informazioni

Il Formato API Precedente: https://api.whatsapp.com/send

Struttura meno recente ma ancora supportata:

https://api.whatsapp.com/send?phone=393401234567&text=Buongiorno

Suggerimento: Usa sempre wa.me. I link sono più puliti, performanti e gestiscono i deeplink mobili in modo più affidabile.

---

2. Formattazione Telefonica Internazionale E.164

Affinché il link funzioni ovunque nel mondo, il numero deve rispettare lo standard internazionale E.164:

• Solo cifre numeriche: Rimuovi +, spazi, trattini e parentesi.
• Includi il prefisso del Paese: Senza il doppio zero iniziale (00).
• Rimuovi lo zero iniziale nazionale: Nei numeri mobili italiani (0...), assicurati che non vi siano prefissi di teleselezione errati (es. un cellulare 340 1234567 con prefisso Italia diventa 393401234567).

Esempi Pratici

Numero Originale	Formato E.164 Valido	URL Corretto
Italia: 340 123 4567	393401234567	https://wa.me/393401234567
Svizzera: +41 79 123 45 67	41791234567	https://wa.me/41791234567
Spagna: 0600 123 456	34600123456	https://wa.me/34600123456

---

3. Codifica URL dei Parametri di Testo

Per inserire un messaggio di apertura nella chat, il parametro ?text= deve essere codificato secondo le specifiche RFC 3986:

• Gli spazi devono diventare %20.
• I ritorni a capo (a capo riga) richiedono %0A.
• I caratteri speciali (&, #, ?) devono essere codificati (%26, %23, %3F).

In JavaScript / Node.js:

const phone = "393401234567";
const message = "Ciao!\nVorrei ricevere assistenza per il mio ordine.";
const url = `https://wa.me/${phone}?text=${encodeURIComponent(message)}`;

---

4. Codici QR per Supporti Cartacei e Offline

Puoi trasformare i tuoi link in codici QR da stampare su cataloghi, packaging, biglietti da visita o scontrini. I clienti inquadrano il codice e avviano la chat senza dover digitare alcuna cifra.

Crea i tuoi link e QR code in pochi secondi con il nostro Generatore di Link WhatsApp o scopri la Guida all'Integrazione Shopify.