Crea ora
IT
WhatsApp click-to-chat

API dei link WhatsApp: wa.me e api.whatsapp.com spiegati

Un link WhatsApp è un URL, non un'API. Ecco i formati esatti, il parametro text, un generatore gratuito e il punto in cui il link si ferma.

Inizia ora
Come funziona

API dei link WhatsApp: come funzionano davvero i link wa.me e api.whatsapp.com

Entrambi aprono una chat, poi subentra una persona.

  1. 1Qualcuno apre l'URL
  2. 2WhatsApp apre la chat
  3. 3Una persona preme invio
Definizione

Che cos'è un'API per i link WhatsApp?

Non esiste un'API per i link WhatsApp. https://wa.me/<numero> e https://api.whatsapp.com/send?phone=<numero> sono URL click-to-chat. Le API iniziano dove il link si ferma.

Un link WhatsApp
Configurazione
Nessuna
Al clic
Apre una chat, precompila il testo
Chi agisce
Una persona preme invio
Un'API WhatsApp
Configurazione
Collegamento dell'account e una chiave API
Alla chiamata
Invia, riceve ed elenca i messaggi
Chi agisce
Il software, per conto dell'account collegato
Formato

Qual è il formato esatto del link wa.me?

Il formato documentato è https://wa.me/<numero>, con il numero di telefono completo in formato internazionale.

Anatomia dell'URL
https://wa.me/1XXXXXXXXXX
Host. Sempre lo stesso.
Numero. Prima il prefisso internazionale, solo cifre.
Da usarehttps://wa.me/1XXXXXXXXXX
Da evitarehttps://wa.me/+001-(XXX)XXXXXXX
Da rimuovere prima+0 inizialeSpaziTrattiniParentesi

Fonte: Centro assistenza WhatsApp, «Come usare la funzione click to chat»

Confronto

Qual è la differenza tra wa.me e api.whatsapp.com/send?

Entrambi aprono la stessa conversazione. Cambia solo la posizione del numero.

wa.meDocumentato
https://wa.me/1XXXXXXXXXX?text=Ciao

Numero nel percorso. Documentato da WhatsApp.

api.whatsapp.com/sendAncora molto diffuso
https://api.whatsapp.com/send?phone=1XXXXXXXXXX&text=Ciao

Numero nel parametro phone. Assente dalla pagina di assistenza attuale che abbiamo consultato.

Una lacuna della documentazione, non una deprecazione. I nuovi link vanno creati su wa.me.

Il parametro text

Come aggiungere un messaggio precompilato a un link WhatsApp?

Basta aggiungere ?text= e il messaggio codificato per URL: https://wa.me/<numero>?text=<testocodificato>. Il testo resta modificabile.

Caratteri da codificare
Spazio%20
A capo%0A
&%26
#%23
+%2B

Emoji e tutto il resto: encodeURIComponent().

Nessun numero? https://wa.me/?text=... apre la scelta del contatto.

build-link.js
const number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}` +
  `?text=${encodeURIComponent(text)}`;
https://wa.me/1XXXXXXXXXX?text=Hi!%20I%20have%20a%20question.
Strumento gratuito

Generatore di link WhatsApp

Inserisca un numero e un messaggio, poi copi ciò che le serve.

Solo cifre, prima il prefisso internazionale.
Facoltativo, resta modificabile.

Funziona nel browser. Nessun numero viene inviato a un server.

Link wa.me
https://wa.me/15550123456?text=Ciao!%20Ho%20una%20domanda%20sul%20vostro%20prodotto.
Equivalente api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Ciao!%20Ho%20una%20domanda%20sul%20vostro%20prodotto.
Parametro text, codificato
Ciao!%20Ho%20una%20domanda%20sul%20vostro%20prodotto.
Snippet HTML
<a href="https://wa.me/15550123456?text=Ciao!%20Ho%20una%20domanda%20sul%20vostro%20prodotto." target="_blank" rel="noopener" aria-label="Chat on WhatsApp with 15550123456">Chat on WhatsApp</a>
Pulsante "Chat on WhatsApp"
<a href="https://wa.me/15550123456?text=Ciao!%20Ho%20una%20domanda%20sul%20vostro%20prodotto." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Chat on WhatsApp</a>

Un link apre una chat. Non invia nulla e il prodotto non vede mai la risposta.

Crea ciò che un link non può fare
Risposta breve

Un link WhatsApp invia il messaggio?

No. Non viene consegnato nulla finché la persona che ha in mano il telefono non preme invio.

Chat aperta
Testo precompilato
Consegnato solo dopo un tocco su invio
Dove si ferma il link

Cosa non può fare un link WhatsApp?

Un link click-to-chat è stateless: l'app non sa mai cosa succede dopo.

Cosa fa il link
  • Link cliccato
  • La chat si apre
  • Messaggio precompilato
  • Invio manuale
Il link si ferma qui
Cosa richiede un'API
  • Risposta ricevuta
  • Cronologia della conversazione
  • Evento webhook
  • Attribuzione per utente
Nessuno stato di consegna o di lettura
Nessun allegato
Nessun trigger lato server
Errore silenzioso su un numero senza WhatsApp
Comportamento diverso a seconda del dispositivo
Nessun gruppo: si vedano i limiti dell'API per gruppi WhatsApp
Crea una vera integrazione WhatsApp
Oltre il link

Come riportare la risposta nell'app?

Serve un'API che mantenga una sessione WhatsApp. Esistono due strade.

Meta Cloud APIAzienda verificata
  • Richiede un account WhatsApp Business verificato
  • Fatturata a messaggio dal 1° luglio 2025: si vedano i prezzi della WhatsApp Business API
  • Risposte nella finestra di 24 ore: 1.000 gratuite per numero ogni mese dal 1° ottobre 2026
Account collegato, UnipileNessuna verifica Business
  • Ogni utente finale collega il proprio account WhatsApp
  • L'app agisce per conto dell'utente autenticato
  • Legge e invia dalla inbox reale, risposte incluse
  • Stessa API di LinkedIn, Telegram, Gmail e altri
Con Unipile
  1. 1Collegamento dell'account tramite codice QR o codice di abbinamento
  2. 2Invio dall'app
  3. 3Ricezione delle risposte via webhook: message_received

Per approfondire: l'API WhatsApp di Unipile e come inviare messaggi WhatsApp via API. Riferimento: developer.unipile.com/v1.0/docs/whatsapp.

Realizzalo con Unipile
Decisione

Link, Cloud API o account collegato: quale serve?

Si sceglie in base a chi scrive per primo.

Un link

Una persona avvia la chat dalla pagina web.

Autenticazione
Nessuna
Costo
Gratuito
Risposte
Invisibili per l'app
Prova il generatore qui sopra
Meta Cloud API

Un'azienda verificata invia template.

Autenticazione
Account Meta Business verificato
Costo
A messaggio, dal 1° luglio 2025
Risposte
Sì, via webhook
Guida all'integrazione della WhatsApp Cloud API
Account collegato

Il prodotto lavora nella inbox di ciascun utente.

Autenticazione
Codice QR o codice di abbinamento
Costo
Piano Unipile, nessuna fatturazione a messaggio
Risposte
Sì, via webhook
Guida completa all'API WhatsApp
Inizia a costruire
Implementazione

Come integrare un link WhatsApp in un prodotto?

Va generato per ciascun utente nei template. Mai un unico numero scritto nel codice di un prodotto multi-tenant.

Template del link
https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}
Numero. Dal record dell'utente.
Testo. Codificato per URL al rendering.
Pulsante ufficiale

Il badge verde «Chat on WhatsApp» di WhatsApp, usato così com'è.

Codice QR

Qualsiasi generatore di QR trasforma un link wa.me in un codice stampabile.

Dove si apre
Smartphone
L'app WhatsApp
Desktop, app installata
L'app desktop
Desktop, senza app
WhatsApp Web
Risoluzione dei problemi

Perché il link WhatsApp non funziona?

Nella maggior parte dei casi: il formato del numero o un testo non codificato.

1 Il numero non è in formato internazionale semplice
https://wa.me/+001-(XXX)XXXXXXX
https://wa.me/1XXXXXXXXXX

Soluzione: solo cifre, prima il prefisso internazionale.

2 Il parametro text non è stato codificato per URL
?text=Ciao a tutti & benvenuti
?text=Ciao%20a%20tutti%20%26%20benvenuti

Soluzione: encodeURIComponent() o urllib.parse.quote().

3 Nessun account WhatsApp attivo

La chat fallisce senza alcun avviso.

4 Aperto in un browser in-app

Usare il browser di sistema.

5 Un'anteprima del link ha riscritto l'URL

La query string è andata persa. Testare l'URL grezzo.

Sviluppa su account collegati

API dei link WhatsApp - FAQ

Risposte rapide per sviluppatori.

No. wa.me e api.whatsapp.com/send sono URL click-to-chat: aprono una chat WhatsApp, senza autenticazione né codice. Le API di WhatsApp iniziano dove il link si ferma.

https://wa.me/<numero>, dove <numero> è il numero completo in formato internazionale, senza zeri iniziali, parentesi, spazi o trattini. Ad esempio: https://wa.me/1XXXXXXXXXX.

Entrambi aprono la stessa conversazione. wa.me/<numero> è la forma breve documentata nel Centro assistenza di WhatsApp, con il numero nel percorso. api.whatsapp.com/send?phone=<numero> è la forma lunga, con il numero come parametro di query.

No. Il link apre la conversazione e può precompilare il campo di testo. Non viene consegnato nulla finché la persona che ha in mano il telefono non preme invio.

Sì. Basta aggiungere ?text= e un messaggio codificato per URL, ad esempio https://wa.me/1XXXXXXXXXX?text=Ciao%2C%20ho%20una%20domanda. Il testo resta modificabile prima dell'invio. Provi il generatore qui sopra.

Di solito il numero non è in formato internazionale semplice, oppure il testo non è stato codificato per URL. Verifichi anche che il numero sia su WhatsApp ed eviti i browser in-app.

No. Un link wa.me o api.whatsapp.com/send non richiede né un account Business né l'accesso all'API. La Cloud API è un prodotto separato e soggetto a verifica. Si veda la guida completa all'API WhatsApp.

Non con un link: è stateless. Usi la Cloud API di Meta con un account Business verificato, oppure Unipile, dove ogni utente finale collega il proprio account tramite codice QR o codice di abbinamento e l'app agisce per conto dell'utente autenticato. Si veda come inviare messaggi WhatsApp via API.

Link o API? Il nostro team può aiutarvi a decidere.

Parla con un esperto