LinkedIn
Instagram
Telegramma
Gmail
Prospettiva
Calendario di Google
Partecipare alla comunità Slack Indice dei contenuti
Il Link
Crea un link
Oltre il Link
Link WhatsApp Click-to-Chat
API Link di WhatsApp: Come fare wa.me e api.whatsapp.com I link funzionano davvero
Un link di WhatsApp è un URL, non un'API. Questa guida ti fornisce l'esatto wa.me e api.whatsapp.com/send formati, il text parametro, un generatore gratuito e il punto in cui il collegamento si interrompe e deve iniziare un'integrazione effettiva.
Prova gratuita di 7 giorni, nessuna carta di credito richiesta
Solo un URL
Nessuna autenticazione, nessun codice
Ciao! Ho una domanda sul vostro prodotto.
Apre la chat. Un umano deve comunque premere invio.
Definizione
Che cos'è un'API per i link di WhatsApp?
Non esiste alcuna API per i link di WhatsApp.
https://wa.me/<number> e https://api.whatsapp.com/send?phone=<number> sono URL "clicca per chattare": cliccando su uno di essi si apre una conversazione in WhatsApp. Essi richiedono nessuna autenticazione, nessun account sviluppatore e nessun codice. Le API di WhatsApp sono un livello separato e iniziano esattamente dove finisce il link.Criterio
Un link di WhatsApp
Un'API di WhatsApp
Formato
CollegamentoUn URL che puoi incollare ovunque
APIUn endpoint HTTP autenticato
Impostazione
CollegamentoNessuno. Funziona all'istante
APICollegamento dell'account, una chiave API, una libreria client
Cosa succede al clic / alla chiamata
CollegamentoApre una chat e può precompilare un campo di testo
APIInvia, riceve ed elenca i messaggi a livello di programmazione
Chi recita
CollegamentoUn essere umano preme invia
APIIl tuo software agisce per conto dell'account collegato
Formato
Qual è il formato esatto del link wa.me?
Il formato documentato è
https://wa.me/<number>, dove <number> è un numero di telefono completo in formato internazionale. Il Centro assistenza di WhatsApp afferma che è necessario omettere zeri, parentesi o trattini.Usa: https://wa.me/1XXXXXXXXXX
Non usare: https://wa.me/+001-(XXX)XXXXXXX Cosa conservare
Prefisso internazionale più numero dell'abbonato, solo cifre. Nessun prefisso
+. Cosa rimuovere
Zeri iniziali, spazi, trattini, parentesi. Nessuno di essi appartiene al percorso.
Confronto
Qual è la differenza tra wa.me e api.whatsapp.com/send?
Entrambi aprono la stessa conversazione.
wa.me/ la forma breve è documentata nel Centro assistenza di WhatsApp, con il numero nel percorso. api.whatsapp.com/send?phone= è la forma estesa, ancora ampiamente utilizzata, che trasporta il numero come parametro di query.Anatomia di un URL, segmento per segmento
https://wa.me/1XXXXXXXXXXCiao
https://api.whatsapp.com/invia?telefono=1XXXXXXXXXXCiao
Presentatore
Percorso fisso
Il numero
Il messaggio
Criterio
wa.me
api.whatsapp.com/send
Dove vive il numero
wa.meNel percorso dell'URL
api.whatsapp.comNel
telefono parametro di queryDocumentato nel Centro assistenza di WhatsApp
wa.meSì, questo formato esatto
api.whatsapp.comNon siamo riusciti a trovare [questo/quest'informazione] nella pagina di aiuto corrente
Comportamento osservato
wa.meApre la chat
api.whatsapp.comApre la stessa chat
Una lacuna di documentazione, non una deprecazione. Non siamo riusciti a trovare una pagina WhatsApp o Meta attuale e ufficiale che documenti
api.whatsapp.com/send. Ciò non significa che abbia smesso di funzionare: oggi entrambi i formati reindirizzano alla stessa conversazione. Significa che il Centro assistenza di WhatsApp copre solo wa.me. Crea nuovi collegamenti nel formato documentato.Il parametro di testo
Come si aggiunge un messaggio precompilato a un link di WhatsApp?
Aggiungi
?text= seguito dal messaggio codificato in URL: https://wa.me/<number>?text=<urlencodedtext>. Il testo finisce nel campo di input della chat, precompilato e modificabile.https://wa.me/1XXXXXXXXXX?text=Sonointeressatoallatuaautoinvendita// nessun numero: apre invece un selettore di contattihttps://wa.me/?text=I'minquiringabouttheapartmentlisting Senza un numero, WhatsApp apre l'elenco dei contatti del mittente anziché una chat specifica.
La codifica, le determinate mappature text si precompila ancora una volta selezionato un contatto. Personaggio
Spazio
Nuova linea
&
#
Codificato come
%20
%0A
%26
%23
Vale anche la pena sapere:
Crea il link nel codice + codifica in %2B. Per tutto il resto, emoji incluse, non creare la tabella da solo: chiama encodeURIComponent() in JavaScript o urllib.parse.quote() in Python. // JavaScriptconst number = "1XXXXXXXXXX";
const text = "Hi! I have a question.";
const link = `https://wa.me/${number}?text=${encodeURIComponent(text)}`;# Pythonfrom urllib.parse import quote
number, text = "1XXXXXXXXXX", "Ciao! Ho una domanda."
link = f"https://wa.me/{number}?text={quote(text)}"Strumento gratuito
Genera il tuo link di WhatsApp
Inserisci un numero e un messaggio. Ottieni il wa.me il link api.whatsapp.com equivalente, il testo codificato, uno snippet HTML e il pulsante ufficiale, tutti insieme.
Funziona interamente nel tuo browser. Nessun numero viene mai inviato a un server.
Numero internazionale completo. Nessun +, nessun 0, nessuno spazio o trattino.
Facoltativo. Viene inserito nel campo di testo della chat, rimanendo modificabile dal mittente.
link wa.me
https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product.
equivalente di api.whatsapp.com
https://api.whatsapp.com/send?phone=15550123456&text=Hi!%20I%20have%20a%20question%20about%20your%20product.
parametro di testo, codificato
Ciao!Ihounadomandasultuoprodotto.
Frammento HTML, pronto da incollare
<a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener" aria-label="Chatta su WhatsApp">Chatta su WhatsApp</a>
Pulsante ufficiale "Chatta su WhatsApp"
Chatta su WhatsApp <a href="https://wa.me/15550123456?text=Hi!%20I%20have%20a%20question%20about%20your%20product." target="_blank" rel="noopener"><img src="whatsapp-icon.svg" alt=""> Chatta su WhatsApp</a>
Questo link apre una chat. Non invia il messaggio e il vostro prodotto non vedrà la risposta.
Un link di WhatsApp invia il messaggio?
No. Un link click-to-chat apre la conversazione e pre-compila il campo di testo. Nulla viene inviato finché la persona che tiene il telefono non preme invia.
La parte onesta
Cosa non può fare un link di WhatsApp?
Un link click-to-chat è senza stato. Il tuo prodotto non viene mai a sapere se il link è stato cliccato, se il messaggio è stato inviato o se il destinatario ha risposto.
Dove si interrompe il collegamento
Link cliccato
La chat si apre
Messaggio precompilato
Invio manuale
Collegamentofermatequi
Risposta ricevuta
Cronologia della conversazione
Evento webhook
Attribuzione per utente
Nessuna conferma di recapito o lettura
Nessuna risposta è stata reindirizzata alla tua applicazione
Nessuna cronologia delle conversazioni
Nessun allegato
Nessun trigger lato server. Ci vogliono un essere umano e un clic
Nessuna attribuzione per utente in un prodotto multi-tenant
Errore silente se il numero non ha un account WhatsApp attivo
Comportamento diverso tra desktop, WhatsApp Web e cellulare
Nessuna creazione o gestione di gruppi. Un link apre solo una chat individuale, vedi il API per gruppi WhatsApp limiti per qualsiasi cosa relativa ai gruppi
Un link non può registrare clic, risposte o cronologia. Un'API sì. Costruisci una vera integrazione con WhatsApp
Incolla il link
Come fai a ricevere la risposta nella tua app?
Hai bisogno di un'API che mantenga una sessione di WhatsApp. Esistono due rotte: API Cloud di Meta, che richiede un account aziendale verificato, o un API di account connesso come Unipile, in cui l'utente finale collega il proprio account WhatsApp per conto dell'utente autenticato, tramite codice QR o codice di associazione.
API Meta CloudAttività verificata
Richiede un account WhatsApp Business verificato
Fatturato per messaggio dal 1° luglio 2025, vedi il Prezzi API di WhatsApp Business guasto
La finestra di assistenza clienti di 24 ore esiste ancora, determina cosa è gratuito, non cosa viene fatturato
Progettato per notifiche basate su modelli su larga scala
Account connesso, UnipileNessuna verifica
Ciascun utente finale collega il proprio account WhatsApp, per conto dell'utente autenticato
Tramite codice QR o codice di associazione, nessuna verifica Meta Business
Legge e invia dalla casella di posta collegata effettiva, risposte incluse
Stesso pattern di connessione, invio, elenco e ascolto di LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP
// 1. Collega l'account, per conto dell'utente autenticato
const {qrCodeString}= await client.account.CollegaWhatsapp();// 2. Inviare un messaggio una volta collegato
POST /api/v1/chats/{chat_id}/messages{ "testo": "Ciao! Il tuo ordine è stato spedito." }// 3. Ricevere risposte tramite un webhook, nessun polling{ "evento": "messaggio ricevuto", "chat_id": "chat_182...", "messaggio": "È ancora disponibile?"{Per la guida completa sull'invio, i payload e la gestione dei webhook, consultare come inviare messaggi WhatsApp tramite API. Riferimento all'endpoint: developer.unipile.com/docs/whatsapp.
Decisione
Link, Cloud API o account connesso: quale ti serve?
Usa un link quando un utente avvia la conversazione da una pagina sotto il tuo controllo. Usa l'API Cloud quando un'azienda verificata invia notifiche basate su modelli su larga scala. Usa un'API per account connessi quando il tuo prodotto deve leggere e inviare messaggi dalla casella di WhatsApp dell'utente stesso.
Criterio
Collegamento
API Meta Cloud
Account collegato
Chi dà inizio
CollegamentoUn essere umano, da una pagina che controlli
API del cloudLa tua azienda invia per prima, precompilati
Account collegatoEntrambi i lati, dalla casella di posta collegata
Autorizzazione richiesta
CollegamentoNessuno
API del cloudAccount aziendale Meta verificato
Account collegatoCodice QR o codice di associazione, nessuna verifica aziendale
Costo
CollegamentoGratuito
API del cloudPer messaggio, a partire dal 1° luglio 2025
Account collegatoPrezzi dei piani Unipile, non fatturati per messaggio
Riceve risposte
CollegamentoNo
API del cloudSì, tramite webhook
Account collegatoSì, tramite webhook
Cronologia della conversazione
CollegamentoNo
API del cloudSì
Account collegatoSì
Prodotti multi-tenant
CollegamentoInterruzioni, un numero cablato
API del cloudÈ necessario un routing personalizzato per ogni numero aziendale
Account collegatoNativo, un account collegato per utente finale
Tempo di configurazione
CollegamentoVerbale
API del cloudDa giorni a settimane, Verifica aziendale
Account collegatoDa minuti a ore
Ho solo bisogno di un link
Utilizzare il generatore sopra. Nessun account, nessuna configurazione.
Invio di notifiche con modelli
Vedi il Integrazione WhatsApp Cloud API guida.
Lettura e invio per utente
Inizia con il Guida completa all'API di WhatsApp.
La maggior parte dei prodotti supera il link nel giro di una settimana. Inizia da dove andrai a finire. Iniziare a costruire
Implementazione
Come si incorpora un link di WhatsApp in un prodotto?
Genera il link lato server, per utente, e non cablare mai un numero di telefono in un prodotto multi-tenant. Il link è solo un ancoraggio, quindi appartiene al livello del template, non al livello dell'API.
<a href="https://wa.me/{{ user.whatsapp_number }}?text={{ prefilled_text | url_encode }}"
bersaglio="_blank" relativo="noopener"
aria-label="Chatta su WhatsApp"Chatta su WhatsAppa>Pulsante ufficiale
WhatsApp pubblica un badge "Chatta su WhatsApp" pronto all'uso, verde e bianco, in alcune dimensioni fisse, pensato per essere utilizzato senza modifiche.
Chatta su WhatsApp Codice QR
Qualsiasi generatore di codici QR che accetta un URL trasforma un
wa.me collega a un codice scansionabile per stampa, packaging o segnaletica in presenza. Mobile Apre direttamente l'applicazione WhatsApp, con la chat e il testo precompilato pronti.
Desktop, app installata Apre l'app desktop di WhatsApp anziché il browser.
Computer, niente app Apre WhatsApp Web nel browser e richiede l'accesso tramite codice QR se la sessione non è già attiva.
Perché il link si interrompe nei prodotti multi-tenant: un singolo numero cablato non può distinguere i vostri clienti. Generate il link dal record specifico dell'utente o dello spazio di lavoro ogni volta, in modo che contenga il numero effettivamente posseduto da quell'utente, e non un numero incollato una volta sola in un modello.
Risoluzione dei problemi
Perché il mio link di WhatsApp non funziona?
Le due cause più comuni sono un numero di telefono che non è nel formato internazionale standard e un
text parametro che non è stato codificato per l'URL.CausaNumero di telefono non in formato internazionale semplice
RisolviUsa il numero internazionale completo, solo cifre: no
+, senza prefisso 0, senza spazi, trattini o parentesi.CausaIl parametro text non era codificato per URL
RisolviInoltra il messaggio
encodeURIComponent() in JavaScript o urllib.parse.quote() in Python prima di aggiungerlo.CausaIl numero non ha un account WhatsApp attivo
RisolviIl link si apre ancora, ma la chat fallisce silenziosamente. Verifica prima che il numero sia effettivamente registrato su WhatsApp.
CausaAperto all'interno del browser in-app di un'app di terze parti
RisolviI browser in-app dei social o delle piattaforme pubblicitarie a volte bloccano o gestiscono male il reindirizzamento. Aprire invece il link nel browser di sistema.
CausaUn crawler di anteprima dei link ha riscritto l'URL
RisolviAlcune piattaforme includono i link in uscita nel proprio reindirizzamento, il che può rimuovere la stringa di query. Testa il grezzo
wa.me URL direttamente.API Link di WhatsApp - FAQ
Tutto ciò che gli sviluppatori chiedono su wa.me, api.whatsapp.com, sul parametro text e su dove si ferma il link.
Non esiste una singola API per i link di WhatsApp. wa.me e api.whatsapp.com/send sono URL click-to-chat: aprirne uno avvia una conversazione su WhatsApp, senza che siano richiesti autenticazione, account sviluppatore o codice. Le API proprietarie di WhatsApp sono un livello separato che inizia esattamente dove finisce il link, nel momento in cui una persona deve rispondere.
Il formato documentato è https://wa.me/<number>, dove <number> è il numero di telefono completo in formato internazionale. Il Centro assistenza di WhatsApp consiglia di omettere eventuali zeri iniziali, parentesi, spazi o trattini, ad esempio https://wa.me/1XXXXXXXXXX.
Entrambi aprono la stessa conversazione. wa.me/ la forma abbreviata è documentata nel Centro assistenza di WhatsApp, con il numero nel percorso dell'URL. api.whatsapp.com/send?phone= è la forma estesa, ancora ampiamente utilizzata, che invece trasporta il numero come parametro di query.
No. Un link click-to-chat apre la conversazione e può precompilare il campo di testo, ma non viene inviato nulla finché la persona che tiene in mano il telefono non preme invio.
Sì. Aggiungi ?text= seguito da un messaggio codificato in URL, ad esempio https://wa.me/1XXXXXXXXXX?text=Hi%2C%20I%20have%20a%20question. Il testo arriva nel campo di input della chat, precompilato e ancora modificabile prima dell'invio. Provalo nel generatore sopra.
Le due cause più comuni sono un numero di telefono che non è nel formato internazionale standard e un text parametro che non era codificato per URL. Controlla anche che il numero abbia un account WhatsApp attivo e che il link non sia stato aperto all'interno del browser in-app di un'applicazione di terze parti.
No. A wa.me o api.whatsapp.com/send Il link non richiede alcun account Business, nessuna verifica e nessun accesso API. La Piattaforma WhatsApp Business, o Cloud API, è un prodotto verificato separato per le aziende che devono inviare notifiche basate su modelli su larga scala o ricevere risposte in modo programmatico. Vedi il Guida completa all'API di WhatsApp.
Un link in sé non può inviare risposte alla tua applicazione, è stateless. Per leggere e inviare messaggi da una casella di posta reale, hai bisogno di un'API che mantenga una sessione di WhatsApp: o la Cloud API di Meta con un account Business verificato, o un'API per account connessi come Unipile, in cui ogni utente finale collega il proprio account WhatsApp per conto dell'utente autenticato, tramite codice QR o codice di associazione. Vedi come inviare messaggi WhatsApp tramite API.
Non sei ancora sicuro di aver bisogno di un link o di un'API? Il nostro team può aiutarti a decidere.
IT 
EN 
FR 
ES 
DE 
BR 
NL 
PL 
TR