DMA
La nostra soluzione è costruita in linea con il Legge sui mercati digitali (DMA). I profili degli utenti non vengono mai memorizzati o scrapati e la nostra API si concentra esclusivamente sull'interoperabilità della messaggistica. I clienti sono tenuti a rispettare le condizioni di ciascun fornitore.
La connessione di WhatsApp al vostro software deve essere veloce e senza interruzioni. L'API WhatsApp Link semplifica il modo in cui gli utenti collegano i loro account personali o aziendali alla vostra piattaforma CRM, ATS o di outreach. Invece di lunghi flussi di onboarding o di approvazioni Meta, un singolo link di autenticazione QR consente ai vostri utenti di iniziare a inviare e ricevere messaggi istantaneamente, il tutto gestito attraverso l'API unificata di Unipile. In questo articolo spiegheremo cos'è l'API WhatsApp Link, come funziona e come Unipile consente un'esperienza di integrazione semplice, sicura e conforme.
Che cos'è l'API WhatsApp Link?
L'API WhatsApp Link si riferisce al processo di connessione che consente a un utente di collegare il proprio account WhatsApp (classico o aziendale) direttamente a una piattaforma di terze parti attraverso una chiamata API.
Gestisce il livello di autenticazione, generando un codice QR o un link unico e limitato nel tempo che l'utente scansiona dall'app WhatsApp per garantire l'accesso in modo sicuro.
Perché il collegamento è importante per gli editor di software
Per gli strumenti CRM, ATS o di automazione delle vendite, la fase di collegamento dell'account è fondamentale. Senza di essa, l'applicazione non può scambiare messaggi o sincronizzare la cronologia delle chat. Il Collegamento API WhatsApp risolve questo problema fornendo un metodo sicuro e scalabile per autenticare più account, ideale per i team che gestiscono decine di profili utente.
I casi d'uso più comuni includono:
-
I reclutatori collegano il loro WhatsApp personale per comunicare con i candidati direttamente nell'ATS.
-
I rappresentanti di vendita collegano più numeri WhatsApp per gestire i contatti.
-
Piattaforme di supporto che incorporano una casella di posta elettronica unificata tra i canali.
L'API unificata di Unipile supporta sia App WhatsApp e App WhatsApp Businesseliminando le limitazioni tipiche delle Business API di Meta.
Capire le diverse versioni di WhatsApp
Prima di esplorare l'API WhatsApp Link, è essenziale capire che non tutte le versioni di WhatsApp offrono le stesse possibilità di integrazione.
WhatsApp offre diversi prodotti, ciascuno progettato per casi d'uso diversi, dall'uso personale all'automazione a livello aziendale.
Ecco come si differenziano:
1. App WhatsApp (classica)
È la versione utilizzata da oltre due miliardi di persone in tutto il mondo. È progettata per la comunicazione personale e offre messaggi individuali e di gruppo attraverso l'applicazione per dispositivi mobili o desktop.
Tuttavia, non fornisce alcuna API ufficiale per gli sviluppatori.
Ciò significa che se il vostro software deve inviare o ricevere messaggi dall'account WhatsApp di un utente, non potete farlo attraverso gli strumenti nativi di Meta.
Soluzioni come l'API unificata di Unipile colmano questa lacuna consentendo agli utenti di collegare i loro account WhatsApp personali in modo sicuro attraverso un codice QR. Una volta collegati, i messaggi, i contatti e i gruppi possono essere sincronizzati in tempo reale all'interno della vostra applicazione, ideale per CRM, ATS o strumenti di outreach.
Esempi di casi d'uso:
-
I reclutatori possono chattare direttamente con i candidati dall'interno di un ATS.
-
Liberi professionisti che gestiscono le richieste dei clienti attraverso il loro CRM
-
Piccoli team che centralizzano tutti i messaggi WhatsApp in un'unica dashboard
2. App WhatsApp Business
Destinata alle piccole imprese, questa versione offre strumenti di base quali:
-
Risposte rapide e messaggi di saluto
-
Creazione di un profilo aziendale
-
Etichettatura semplice per organizzare le chat
Come l'app classica, non include un'API pubblica, il che significa che gli sviluppatori non possono integrarla direttamente nei loro prodotti. La Business App è più uno strumento di gestione per i piccoli commercianti che una piattaforma programmabile.
Con Unipile, anche questi account possono essere collegati in modo programmatico, consentendo l'automazione, il recupero della cronologia dei messaggi e la sincronizzazione direttamente nell'interfaccia della vostra app.
3. API di WhatsApp Business
Questa è la prima API ufficiale fornita da Meta. È pensata per le grandi aziende che hanno bisogno di automatizzare la comunicazione su scala, ad esempio banche, compagnie aeree o piattaforme di e-commerce che inviano aggiornamenti sulle transazioni.
Tuttavia, la sua configurazione e il suo utilizzo sono complessi:
-
Richiede l'approvazione di Meta e la verifica dell'azienda
-
Comporta l'auto-ospitalità dei server o l'utilizzo di un BSP (Business Solution Provider).
-
Utilizza modelli di messaggi che devono essere approvati da Meta
-
Segue una finestra di conversazione di 24 ore per interazione con l'utente
Sebbene sia potente, è anche rigido e richiede molte risorse. Per gli editori SaaS che costruiscono funzioni di messaggistica flessibile all'interno di CRM o ATS, questo modello spesso aggiunge attrito.
4. API WhatsApp Cloud
Per semplificare l'accesso, Meta ha introdotto l'API Cloud, ospitata sull'infrastruttura di Meta.
Elimina la necessità di mantenere i server self-hosted, pur mantenendo le stesse funzionalità della Business API:
-
Inviare e ricevere messaggi in modo programmatico
-
Gestire modelli e flussi automatizzati
-
Ottenere rapporti sullo stato di consegna e di lettura
Tuttavia, i suoi limiti rimangono:
-
Solo gli account aziendali verificati possono utilizzarlo
-
Ogni modello richiede ancora l'approvazione
-
La tariffazione segue un modello di fatturazione basato sulle conversazioni
Questo lo rende più adatto ai sistemi di assistenza clienti su scala aziendale piuttosto che alle piattaforme per sviluppatori o alle integrazioni SaaS B2B.
Capire le diverse versioni di WhatsApp
App WhatsApp (classica)
- Messaggistica personale per singoli e piccoli team.
- Nessuna API ufficiale da Meta.
- Si abbina bene con un Collegamento QR per connettersi e sincronizzarsi all'interno del prodotto.
App WhatsApp Business
- Costruito per le piccole imprese: risposte rapide, etichette, profilo.
- Nessuna API pubblica per l'accesso al programma.
- Utilizzare un link QR ospitato per collegare e gestire le chat nella vostra applicazione.
WhatsApp Business API (On-premise)
- API ufficiale per l'automazione aziendale su scala.
- Richiede la verifica dell'azienda, l'hosting e l'approvazione del modello.
- Finestre di conversazione e conformità da gestire.
WhatsApp Cloud API
- Variante metainstallata della Business API.
- Non ci sono server da mantenere, ma i modelli sono ancora necessari.
- Ideale per marchi verificati, chatbot e flussi di assistenza.
| Versione | Utenti target | Accesso API | Hosting | Limitazioni | Il migliore per |
|---|---|---|---|---|---|
| App WhatsApp (classica) | Individui | ❌ Nessuno | Mobile / Desktop | Nessun accesso API | Uso personale, liberi professionisti |
| App WhatsApp Business | Piccole imprese | ❌ Nessuno | Mobile | Solo automazione di base | Commercianti locali |
| API aziendale (in sede) | Imprese | ✅ Sì | In hosting autonomo | Approvazione dei meta, limiti dei modelli | Automazione su larga scala |
| API del cloud | Imprese | ✅ Sì | Meta ospitato | Modelli, account verificati | Chatbot aziendali |
| API unificata Unipile | Editori di software | ✅ Sì | Gestito da Unipile | Nessuna approvazione, nessun hosting | CRM, ATS, strumenti di sensibilizzazione |
Come funziona il flusso di collegamenti WhatsApp con Unipile
Con Unipile, la generazione di un link WhatsApp richiede una sola richiesta.
- Generare il link (o il codice QR) tramite l'endpoint /accounts.
- Display all'utente nella vostra interfaccia.
- Scansione e confermare dall'app mobile di WhatsApp.
- Inizio sincronizzare istantaneamente messaggi, chat e allegati.
Una volta che la connessione è attiva, lo stato dell'account e i messaggi appaiono in tempo reale all'interno della vostra piattaforma. Il processo è completamente white-label e può essere incorporato direttamente nel vostro flusso di onboarding.
POST https://api.unipile.com/api/v1/accounts
La risposta comprende:
{
"account_id": "unique_id",
"link": "https://connect.unipile.com/qr/abc123",
"status": "waiting_for_scan"
}
Questo approccio consente agli sviluppatori di gestire l'onboarding di più account in pochi secondi, senza gestire sessioni o socket manualmente.
Invio di messaggi tramite account collegati
Una volta collegati gli utenti, è possibile inviare messaggi, allegati o note vocali tramite semplici chiamate REST.
Esempio:
POST https://api.unipile.com/api/v1/messages
{
"account_id": "linked_whatsapp_account",
"to": "+14155550123",
"body": "Welcome aboard!"
}
Integrare le funzioni con l'API WhatsApp di Unipile
Collegare entrambi App WhatsApp e App WhatsApp Business direttamente nel vostro software. Con l'API unificata di Unipile, i vostri utenti si autenticano attraverso un semplice link QR e sincronizzano istantaneamente le loro chat, i loro contatti e i loro gruppi. Nessuna approvazione Meta, nessun self-hosting, tutto funziona in modo sicuro in base agli standard GDPR e SOC 2.
Scambio di media, file e allegati
Oltre al testo e alla voce, i vostri utenti possono anche scambiare media e file, immagini, documenti, PDF o note vocali, all'interno del vostro prodotto.
Unipile gestisce automaticamente il caricamento, la crittografia e la sincronizzazione.
Ogni file appare nel thread di conversazione con i suoi metadati (timestamp, mittente, stato di lettura), facilitando la creazione di funzioni come i "documenti condivisi" o gli "approfondimenti dei messaggi".
Gestire i messaggi di gruppo e la collaborazione di gruppo
L'API di Unipile vi permette di elencare, creare e gestire Gruppi WhatsApp direttamente dalla vostra piattaforma. I messaggi, i media e le reazioni rimangono sincronizzati tra tutti gli account collegati, consentendo ai team di collaborare senza lasciare l'app.
I reclutatori possono gestire gruppi di candidati, i team di vendita possono coordinarsi con i clienti e gli agenti di supporto possono rispondere collettivamente, il tutto da un'unica interfaccia.
Funzionalità principali dell'API WhatsApp di Unipile
Caratteristiche di WhatApp
Inserire WhatsApp nei vostri prodotti è più facile che mai. Sia che stiate costruendo un CRM, un ATS o una soluzione di outreach, i vostri utenti possono collegare i loro account WhatsApp personali in pochi secondi, senza bisogno di verifiche Meta o di configurazioni API aziendali. Provate la sincronizzazione istantanea e in tempo reale di messaggi, gruppi e contatti direttamente all'interno della vostra applicazione.
Connessione del conto
Hosted Auth: White label per connettere i vostri utenti finali
Autenticazione personalizzata: connettere l'utente con le credenziali, i cookie, la vostra estensione chrome
Messaggi
Inviare e rispondere ai messaggi
Elenco di messaggi, chat e partecipanti
Storia della sincronizzazione
Elenco Reazioni
Leggere le ricevute
Allegati
Invio di file allegati
Ricezione di file allegati
Ganci web
Stato del conto
Nuovo messaggio
Nuova reazione / lettura / evento
Integrare WhatsApp nella propria app senza alcuno sforzo
Collegare WhatsApp con Unipile richiede solo pochi minuti.
Nessuna configurazione complessa, nessuna approvazione di Meta, solo un flusso diretto e sicuro progettato per gli sviluppatori.
Iniziate creando il vostro account API e accedendo alla dashboard. Da qui, potrete collegare immediatamente gli account WhatsApp App o WhatsApp Business App dei vostri utenti.
Gli utenti devono semplicemente scansionare un codice QR per autenticarsi, esattamente come farebbero con il loro telefono. Una volta connessi, tutti i messaggi, le note vocali e le chat di gruppo vengono sincronizzati in tempo reale all'interno del prodotto.
Con Unipile, WhatsApp diventa una funzione nativa del vostro CRM, ATS o strumento di outreach, offrendo ai vostri utenti un'esperienza di messaggistica unificata, affidabile e conforme a ogni conversazione.
Iscriviti a Unipile
Accesso al cruscotto
Accedere al proprio spazio di lavoro e gestire gli account collegati.
Integrazione rapida dell'API di WhatsApp con l'autenticazione tramite codice QR
Con Unipile, collegare un account WhatsApp richiede solo pochi minuti. Il flusso è semplice, sicuro ed evita il lungo processo di approvazione commerciale di Meta. Ecco come funziona:
1. Richiedere un codice QR
L'applicazione genera un codice QR univoco tramite l'API Unipile. Gli utenti devono semplicemente scansionarlo con WhatsApp per avviare l'autenticazione.
2. Visualizzare il codice QR
Il codice QR può essere visualizzato direttamente nella vostra applicazione utilizzando librerie standard (PHP o JS). Gli utenti lo scansionano con il loro telefono per collegare il loro account.
3. Confermare l'autenticazione
Una volta scansionato il codice, lo stato del conto cambia in collegato. È possibile ascoltare questo evento eseguendo il polling dello stato dell'account o impostando un webhook per la conferma in tempo reale.
4. Avviare la messaggistica
Non appena l'account è attivo, è possibile inviare e ricevere messaggi di testo, condividere immagini, video, documenti e note vocali. I webhook in tempo reale notificano anche i nuovi messaggi, le reazioni e le ricevute di lettura.
Scoprite di più con l'API di messaggistica unificata
Unipile va ben oltre WhatsApp. Con un'unica integrazione API, il software può collegarsi anche a LinkedIn, Gmail, Outlook, Instagram, Messenger, Telegram e X (Twitter).
Questo livello unificato riunisce tutti i messaggi, i commenti e le interazioni in un unico feed, offrendo ai vostri utenti una visione completa e in tempo reale delle loro comunicazioni su tutti i canali.
Sincronizzando istantaneamente ogni casella di posta, Unipile aiuta la vostra app a garantire un flusso di lavoro più fluido, ad aumentare il coinvolgimento degli utenti e ad assicurare un'esperienza coerente su ogni piattaforma connessa.
Supporto all'integrazione e risorse per il successo delle API di WhatsApp
Installazione rapida, senza problemi
L'integrazione di WhatsApp con Unipile è rapida e semplice.
La nostra API unificata gestisce automaticamente la connessione e la sincronizzazione, in modo che possiate essere operativi senza dover affrontare il lungo processo di approvazione di Meta.
Nessuna configurazione di hosting, nessuna convalida di modelli, solo un livello di messaggistica sicuro e completamente gestito, pronto per la produzione fin dal primo giorno.
Guida tecnica dall'integrazione al lancio
Il team di ingegneri di Unipile lavora direttamente con i vostri sviluppatori per rendere il processo di onboarding fluido e prevedibile.
Avrete accesso a SDK completi, documentazione e supporto personalizzato per ogni fase della vostra integrazione.
Dall'autenticazione alla sincronizzazione in tempo reale, i nostri esperti aiutano a garantire che la vostra implementazione sia affidabile, efficiente e completamente ottimizzata.
Sempre attuale e scalabile per design
Unipile si adatta automaticamente a ogni aggiornamento del provider, che si tratti di WhatsApp, LinkedIn o Gmail, mantenendo la vostra integrazione sempre stabile e conforme.
Il vostro software rimane aggiornato senza bisogno di manutenzione, riducendo i costi e scalando senza sforzo la vostra base di utenti.
La sicurezza e l'affidabilità sono integrate, in modo che il vostro team possa concentrarsi interamente sulla creazione di valore per i vostri utenti.
Iniziate a integrare in modo più intelligente, non più difficile, costruisci oggi la tua esperienza WhatsApp con Unipile.
FAQ - Integrazione API WhatsApp Link
Che cos'è l'API WhatsApp Link?
L'API WhatsApp Link è un modo sicuro per collegare gli account WhatsApp degli utenti a software esterni attraverso un link QR unico. Sostituisce il complesso onboarding di Meta con un semplice flusso di autenticazione.
Posso collegare entrambi gli account WhatsApp e WhatsApp Business?
Sì. L'API di Unipile supporta sia l'app WhatsApp classica che l'app WhatsApp Business, consentendo ai vostri utenti di collegare l'account che utilizzano per comunicare.
Quanto tempo richiede l'integrazione?
La maggior parte degli sviluppatori può collegarsi, testare e distribuire in meno di due giorni. Il cruscotto e gli SDK di Unipile rendono la configurazione rapida e prevedibile.
Il processo di connessione è sicuro?
Assolutamente sì. Unipile utilizza la crittografia end-to-end e opera secondo gli standard GDPR e SOC 2, garantendo la piena sicurezza dei dati e la conformità dei vostri utenti.
Che tipo di messaggi si possono inviare o ricevere?
È possibile inviare e ricevere messaggi di testo, note vocali e allegati. Sono supportati anche i messaggi di gruppo, che lo rendono ideale per i flussi di lavoro di gruppo.
Perché scegliere Unipile invece delle API Business o Cloud di Meta?
Le API di Meta richiedono una verifica aziendale, l'approvazione dei modelli di messaggio e la gestione dell'hosting. Unipile elimina tutti questi attriti, offrendo un'API unificata e facile da sviluppare, immediatamente pronta per la produzione.
Ti potrebbe interessare anche
L'API di ricerca di linkedin amplifica il valore degli utenti per i redattori
LinkedIn, la più grande piattaforma di networking professionale al mondo, offre diversi strumenti e servizi per aiutare gli utenti a connettersi, coinvolgere e far crescere le proprie reti. Tra questi c'è la funzione LinkedIn API Search, che consente di integrare perfettamente le funzionalità di ricerca di LinkedIn nelle applicazioni. Che cos'è...
Guida API LinkedIn 2025: Tutorial completo sull'integrazione e migliori pratiche
Sfruttate il potenziale dell'API per sviluppatori di LinkedIn con la nostra guida completa. Sia che stiate costruendo strumenti per le risorse umane, SaaS o piattaforme incentrate sugli sviluppatori, troverete approfondimenti e vantaggi pratici. Dalla comprensione dell'architettura di base dell'API di LinkedIn all'implementazione di usi reali...


