Vai al contenuto
Compatibile con Cloud API

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

  1. Crea una chiave

    Genera una chiave API nella dashboard. Viene presentata nella stessa forma di intestazione di un token Meta.

  2. Cambia l'URL di base

    Punta il client esistente all'host compatibile invece che a quello di Meta.

  3. Cambia il token

    Usa la tua chiave come token bearer. Non cambia nulla nel modo in cui costruisci le richieste.

  4. 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
Confronta piani e prezzi
FAQ

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.

Cambia senza reintegrare

Cambia host, cambia token, ed esegui i test che hai già.

Vedi i piani

Esplora altre funzionalità

Scopri altri strumenti che rendono WizMessage la piattaforma WhatsApp completa.