Hai già costruito su WhatsApp Cloud API? Cambia host e token.
Non è «anche noi abbiamo un'API». È la stessa API. I percorsi coincidono con quelli di Meta, i corpi di richiesta coincidono, le risposte coincidono e gli errori tornano nella busta di Meta — quindi la gestione degli errori che hai già scritto continua a funzionare. Punta il client a un host diverso, cambia il token, e fermati lì.
Incluso inWiz BotWiz CampaignWiz Pro
- Un host e un token. Il resto dell'integrazione resta intatto
- Due modifiche
- I fallimenti tornano nella busta di errore di Meta, quindi la tua gestione attuale vale ancora
- Gli stessi errori
- La versione fissata nel tuo URL continua a funzionare dopo che Meta l'ha ritirata
- A prova di versione
A chi serve
L'azienda o l'agenzia che ha già pagato uno sviluppatore per integrare la Cloud API di Meta e non pagherà una seconda volta per migrare.
Il dubbio che risolve
«Cambiare piattaforma vuol dire reintegrare.» Non quando endpoint, payload e forme degli errori sono identici.
Come funziona la migrazione
Crea una chiave
Genera una chiave API nella dashboard. Viene presentata nella stessa forma di intestazione di un token Meta.
Cambia l'URL di base
Punta il client esistente all'host compatibile invece che a quello di Meta.
Cambia il token
Usa la tua chiave come token bearer. Non cambia nulla nel modo in cui costruisci le richieste.
Esegui i test che hai già
Stessi percorsi, stessi corpi, stesse risposte, stessa busta di errore: la tua suite di test è il collaudo della migrazione.
Che cosa è rispecchiato
Gli endpoint che le integrazioni usano davvero, ai percorsi documentati da Meta.
- Invio dei messaggi sullo stesso endpoint che già chiami
- Segnare i messaggi come letti e inviare indicatori di digitazione, con lo stesso corpo di richiesta
- Caricamento media, che restituisce un id nella forma che già interpreti
- Elenco dei modelli di messaggio
- Metadati dei media, download ed eliminazione — i metadati restituiscono un URL funzionante che il tuo client scarica senza sapere di chi sia
- Un passaggio con lista di autorizzazione per gli altri percorsi documentati
- Errori nella busta di Meta, così la gestione degli errori che hai già continua a funzionare
Fissare la versione in modo che sopravviva ai ritiri di Meta
Il segmento di versione nell'URL viene accettato e poi ignorato. Sembra una scorciatoia ed è in realtà un vantaggio che vale la pena dire ad alta voce: un client fissato a una versione vecchia continua a funzionare dopo che Meta l'ha ritirata, e fissarne una più nuova non ti trascina in comportamenti non ancora rilasciati. La versione scritta nel tuo codice smette di essere manutenzione.
Una lista di autorizzazione, non un proxy cieco
Esistono solo i percorsi documentati, e ciascuno verifica che l'identificativo nel percorso appartenga alla chiave che sta chiamando. Così la superficie resta verificabile — puoi dire esattamente fin dove arriva questo endpoint — e significa che un errore nel tuo client riceve una risposta onesta invece di essere inoltrato in un posto inatteso. Ogni invio passa comunque dalla piattaforma, quindi valgono le stesse limitazioni di ritmo e protezioni dell'account di sempre.
Da sapere
Fin dove arriva questa funzione, detto chiaramente — così nulla qui ti sorprende dopo l'acquisto.
- Richiede un abbonamento attivo e passa gli stessi controlli di diritto e di limite di ritmo del resto dell'API.
- Questa è una lista di autorizzazione, non un proxy aperto. Esistono solo i percorsi documentati, e ciascuno verifica che l'identificativo nel percorso sia della tua chiave.
- Il segmento di versione viene riconosciuto e poi ignorato: le chiamate vanno sempre alla versione configurata della piattaforma. È voluto, ed è il motivo per cui una vecchia versione fissata continua a funzionare.
- Solo GET, POST e DELETE. Niente PUT o PATCH, perché rispondere con un errore credibile sarebbe meno onesto di un 404.
- Gli invii continuano a passare dal gateway della piattaforma invece di uscire direttamente, quindi limitazioni di ritmo e protezioni a livello di account restano valide.
Incluso in
Questa funzione fa parte dei piani qui sotto.
- Wiz Bot
- Wiz Campaign
- Wiz Pro
Domande Frequenti
Quanto del mio codice deve cambiare?
L'URL di base e il token. Percorsi, corpi di richiesta, risposte e forme degli errori sono gli stessi: è esattamente il senso di questa funzione.
È davvero la stessa API o solo simile?
Stessi percorsi, stessi corpi di richiesta, stesse risposte e stessa busta di errore. «Simile» ti costerebbe comunque una riscrittura; questo è pensato perché i tuoi test attuali passino senza modifiche.
E il numero di versione nei miei URL?
Viene accettato e ignorato, quindi un client fissato a una versione vecchia continua a funzionare dopo che Meta l'ha ritirata. Non devi rincorrere le dismissioni.
Quali metodi HTTP sono supportati?
GET, POST e DELETE. Niente PUT o PATCH: preferiamo restituire un 404 onesto piuttosto che un errore convincente per qualcosa che non esiste.
È disponibile tutto quello che offre Meta?
No. È una lista di autorizzazione voluta dei percorsi documentati, non un proxy cieco, così la superficie resta verificabile.
Ho ancora le funzioni proprie della piattaforma?
Sì. Gli invii passano dalla stessa piattaforma che usa la tua dashboard, quindi casella condivisa, analisi, protezioni dell'account e limitazioni di ritmo valgono ancora.
Esplora altre funzionalità
Scopri altri strumenti che rendono WizMessage la piattaforma WhatsApp completa.
- Gestione APIChiavi API che controlli e puoi revocare, un webhook con pulsante di prova e registro delle consegne, una sandbox e frammenti di codice generati.
- Message TemplatesCreate approved templates, track their status, and personalise them from your contact data — without learning Meta's Business Manager.
- Failure VisibilityA visible log of what went wrong on your account: a failed send, a rejected call, a broken integration. With a detail view per incident.
- WhatsApp CoexistenceConnect the WhatsApp Business number you already use, through Meta's own onboarding. Your phone keeps working; automation runs alongside it.
- Wiz CopilotAn in-app assistant that operates the dashboard by conversation — and stops at an approval you can read and edit before anything changes.
- Website Chat WidgetOne script tag puts the same chatbot on your site — with its own inbox and its own handoff queue.