L’API di WhatsApp
che non cade.
Invia OTP, notifiche e automazioni via HTTP. Ridondanza tra numeri con failover, webhook firmati, SDK in vari linguaggi e playground. Parti in pochi minuti con il piano Free — senza carta.
Senza carta · piano Free per sempre · 2 numeri con ridondanza
# invia un messaggio in 1 request
curl https://api.bzapper.com.br/messages/text \
-H "Authorization: Bearer bz_live_…" \
-d '{
"to": "+5551999998888",
"body": "Il tuo codice è 318204"
}'
# risposta
{
"message_id": "9d41…bbbd",
"status": "queued",
"number": "+5551999198087"
}Dal primo numero al webhook in tre passi
Collega un numero, chiama l’API, ricevi gli eventi. Integrazione in minuti.
Collega un numero
Collega dal pannello. La ridondanza tra numeri si attiva da sola.
Chiama l’API
Un POST e il messaggio entra in coda, nei limiti di invio del numero.
Ricevi webhook
Consegnato, letto, risposto, numero caduto — tutto firmato e in tempo reale.
Tutto ciò che serve a un prodotto serio
Dalla ridondanza tra numeri all’OTP sicuro, dai webhook agli SDK — pensato per la produzione.
Ridondanza multi-numero
Più numeri per progetto, con failover automatico e monitoraggio della salute. Uno cade, il traffico prosegue.
OTP sicuro
Codice in un messaggio separato, mai persistito né mostrato — né nello storico, né in inbox.
Webhook firmati
Eventi in tempo reale con HMAC-SHA256, retry e dedup. Relay locale stile `stripe listen`.
SDK multi-linguaggio
Node, Python, PHP, .NET (C#), Java, Go e Ruby — allineati a OpenAPI e testati dalla stessa suite di conformità. Copia, incolla ed esegui.
Inbox unificata
Conversazioni unificate per contatto anche quando cambia il numero di uscita. Eco proprio e contesto di gruppo.
Media privati
File in bucket privato, scaricati via URL pre-firmato — il client scarica direttamente, senza passare dalla tua API.
Progetti e multi-utente
Isola gli ambienti per progetto, invita il team, controlla per chiave e scope.
Playground API
Prova qualsiasi endpoint e ispeziona i webhook in tempo reale, direttamente dal pannello.
La Cloud API ufficiale, senza la parte difficile
Ogni progetto sceglie come collegarsi: tramite la Cloud API ufficiale di Meta o tramite WhatsApp collegato nel pannello. API, SDK e webhook sono gli stessi — cambiare binario non riscrive la tua integrazione.
- 1
Collega l’account dalla schermata di Meta
La registrazione integrata di Meta si apre dentro bZapper: accedi, scegli l’account WhatsApp Business e il numero, e torni pronto. È l’unico passaggio fatto su Meta; il resto resta nel pannello.
- 2
Crea template che superano la revisione
Il modulo controlla le regole di Meta mentre scrivi e non invia ciò che verrebbe rifiutato. La decisione di Meta compare sullo schermo appena arriva, con un avviso.
- 3
Invia con lo stesso POST
Dentro la finestra di 24 ore parte testo libero; fuori, il template approvato. Stato, prezzo di Meta e origine dell’annuncio arrivano nel webhook.
Lo stesso invio su entrambi i binari
# template approvato da Meta, chiamato per nome
{
"to": "+5511999998888",
"template": "pedido_enviado",
"variables": ["Ana", "#4821"]
}
# → 202; stato e prezzo di Meta arrivano nel webhookNel Playground del pannello puoi conversare dal vivo tramite il numero ufficiale e vedere l’anteprima su telefono di ogni tipo di messaggio prima di integrare.
Il costo di Meta prima di inviare
La campagna mostra la stima di quanto Meta addebiterà prima dell’invio, e il pannello segue il costo per categoria e per numero.
Paghi Meta direttamente
bZapper addebita solo l’abbonamento. Il costo per messaggio è addebitato da Meta sul tuo account, senza nostri margini in mezzo.
Template completi
Pulsanti, media o posizione nell’intestazione, carosello, offerta a tempo limitato, copia codice e template pronti di Meta — con invio di prova e prestazioni per template.
Codice di verifica
La stessa rotta OTP usa il template di autenticazione con pulsante di copia. Dentro la finestra di 24 ore, il codice parte come testo.
Qualità e limite in vista
Qualità e limite giornaliero di ogni numero, con storico ed evento webhook a ogni cambiamento.
Consenso rispettato
Chi interrompe il marketing nello stesso WhatsApp esce da solo dalle campagne di marketing; disiscrizione e tracciamento del consenso valgono su entrambi i binari.
WhatsApp e Meta sono marchi di Meta Platforms, Inc., citati solo per descrivere l’integrazione.
Quello che bZapper fa diversamente
Non è un elenco di funzioni: ogni voce qui sotto è un endpoint in produzione, coperto da tutti e 7 gli SDK. Verificala nella referenza dell’API.
Failover senza cambiare mittente
Più numeri per progetto con failover automatico, monitoraggio della salute e affinità di conversazione: quando un numero diventa non disponibile, il contatto continua a parlare con lo stesso mittente.
Opt-out automatico e traccia di consenso
Chi risponde STOP viene soppresso subito, prima che il messaggio entri in coda. Ogni opt-in e opt-out entra in una traccia append-only, datata e verificabile.
Un widget da incorporare nel TUO prodotto
Una riga di HTML e i tuoi clienti collegano, scollegano e seguono i propri numeri senza uscire dal tuo prodotto. Tu non costruisci nessuna schermata.
Connect per i software partner
Il tuo cliente crea l’account, sottoscrive il Pro e collega WhatsApp senza uscire dalla tua schermata — e il tuo backend riceve la sua API key. Tu non tocchi la fatturazione.
Idempotency-Key vera
Hai ripetuto il POST per un timeout o un retry? Il messaggio parte una sola volta e ricevi la stessa risposta. Lo stesso standard reso celebre da Stripe.
Modifica e revoca dopo l’invio
Errore nel testo già consegnato? PATCH lo corregge. Inviato alla persona sbagliata? DELETE lo cancella per tutti — tutto via API, senza toccare il telefono.
Controlla la lista prima di spendere invii
Un POST ti dice quali numeri della tua lista hanno davvero WhatsApp. Pulisci la base prima della campagna invece di scoprirlo contatto per contatto.
Presenza e chiamate via API
“Sta scrivendo…” e “sta registrando…” veri, anche nei gruppi — il tuo bot smette di sembrare un robot. E una chiamata in arrivo sul numero? Rifiutata automaticamente via API.
Errori con codice stabile in 6 lingue
Ogni errore porta un codice neutro che non cambia mai (ci ragioni sopra) più un messaggio già tradotto da mostrare all’utente finale. Mai più parsing di stringhe di errore.
L’API avvisa la tua integrazione
Quando qualcosa cambia, bZapper invia un avviso segmentato per SDK, per versione e per le funzionalità che usi davvero — nel pannello e nell’API stessa. Non lo scopri rompendoti.
Pianificazione nativa, senza cron
Qualsiasi invio accetta scheduled_at: bZapper lo conserva e lo fa partire all’ora esatta. Nessun processo da tenere in piedi né cron sul tuo server.
Una sola identità su tutti i numeri
Definisci il messaggio “Info” e l’identità del progetto una volta e applicali a TUTTI i numeri collegati con un solo POST — la stessa presentazione su ogni numero, senza lavoro manuale.
7 SDK di bZapper, generati dalla stessa spec
Node, Python, PHP, .NET (C#), Java, Go e Ruby — tutti allineati allo stesso OpenAPI e approvati dalla stessa suite di conformità a ogni release.
Una sola API REST. Tutto WhatsApp.
Dall’OTP ai webhook firmati, dai gruppi all’inbox unificata — ogni capacità qui sotto è un endpoint reale, coperto da tutti e 7 gli SDK.
Messaggistica
- 13 tipi in una sola API REST
- Inoltra, rispondi (cita) e menziona
- Invio programmato con scheduled_at
- OTP in messaggio separato, mai persistito
Consenso e conformità
- Opt-out automatico per parola chiave
- Registro di consenso per contatto
- Blocco e soppressione via API
- Media privati con URL prefirmata
Contatti (CRM)
- Profilo ricco: documento e indirizzo
- Tag, gruppi e correlazione automatica
- Filtri avanzati + cronologia e note
- Opt-out, blocco e opt-in
Conversazioni e inbox
- Cronologia unificata per contatto
- Archivia, fissa, silenzia e segna come letto
- Etichette di conversazione
- Contesto di gruppo ed eco proprio
Gruppi WhatsApp
- Crea e amministra gruppi
- Partecipanti: aggiungi, promuovi, rimuovi
- Link d’invito e ingresso via codice
- Approva le richieste di ingresso
Numeri e istanze
- Collega via QR o codice
- Profilo white-label per numero
- Privacy per numero
- Failover con monitoraggio della salute
Webhook e tempo reale
- Webhook firmati con HMAC-SHA256
- Retry, dedup e consegne verificabili
- Stream SSE in tempo reale (/stream)
- Relay locale stile stripe listen
Widget integrabile
- Modalità flottante o embedded
- I tuoi clienti collegano i numeri
- Mini dashboard di utilizzo
- Chiave pubblica bloccata per origine
Piattaforma e dev
- SDK in 7 linguaggi + OpenAPI
- Playground API nel pannello
- Piani Free/Pro + add-on
- Utilizzo, metriche e 6 lingue
Ogni voce qui sopra corrisponde a un endpoint reale dell’API — niente vaporware. Provali tutti nel Playground.
Copia, incolla, esegui.
SDK di bZapper allineati a OpenAPI e testati dalla stessa suite di conformità in Node, Python, PHP, .NET (C#), Java, Go e Ruby. Webhook firmati con HMAC, retry e dedup. Relay locale stile stripe listen per testare sul tuo localhost.
$ npm install @bzapper/client $ pip install bzapper $ composer require bzapper/bzapper $ go get github.com/bernisoftware/bzapper-go $ br.com.bernisoftware:bzapper (Maven) $ dotnet add package Bzapper $ gem install bzapper Eventi webhook
# inviare un OTP
curl https://api.bzapper.com.br/messages/otp \
-H "Authorization: Bearer bz_live_…" \
-d '{"to":"+5551999998888","code":"318204"}'// npm install @bzapper/client
import { Bzapper } from '@bzapper/client';
const bz = new Bzapper({ apiKey: 'bz_live_…' });
await bz.sendOTP({ to: '+5551999998888', code: '318204' });# pip install bzapper
from bzapper import Client
bz = Client("bz_live_…")
bz.send_otp("+5551999998888", code="318204")// composer require bzapper/bzapper
$bz = new Client('bz_live_…');
$bz->sendOtp('+5551999998888', '318204');// go get github.com/bernisoftware/bzapper-go
import bzapper "github.com/bernisoftware/bzapper-go"
bz := bzapper.NewClient("bz_live_…")
bz.SendOTP("+5551999998888", "318204")// br.com.bernisoftware:bzapper
var bz = new BzapperClient("bz_live_…");
bz.sendOtp("+5551999998888", "318204");// dotnet add package Bzapper
using Bzapper;
using var bz = new BzapperClient("bz_live_…");
var msg = await bz.SendTextAsync(new SendText { To = "+5511999999999", Body = "Olá do bZapper!" });# gem install bzapper
require "bzapper"
client = Bzapper::Client.new("bz_live_…")
client.messages.send_text(to: "+5511999999999", body: "Olá do bZapper!")Porta la gestione dei numeri dentro al tuo prodotto
Un widget standalone che integri nel tuo sistema. I tuoi clienti collegano, scollegano e monitorano i numeri del progetto — senza che tu costruisca alcuna schermata. Una riga di codice.
Numeri del progetto
Carica automaticamente i numeri collegati del progetto associato alla chiave. Ognuno con stato in tempo reale.
Collega via QR
Il cliente scansiona il QR e collega un nuovo numero lì — aggiungi numero (se il piano lo consente) o scollega, tutto nel widget.
Mini dashboard
Uso e consumo del progetto a colpo d’occhio: messaggi, numeri e storage del periodo. La parte finanziaria resta nel pannello.
Sicuro per origine
La chiave wgt_ è pubblica, ma bloccata da una allowlist di origini (CORS). Non espone mai la tua API key reale.
Flottante (plug-and-play)
Una bolla nell’angolo dello schermo. Incolla solo lo <script> con la tua chiave — si apre con un clic.
Embedded (inline)
Renderizza <bzapper-widget> dove vuoi nella tua pagina, come un blocco nativo del tuo pannello.
Modalità flottante — una riga nel tuo HTML:
<!-- incolla prima di </body> -->
<script src="https://widget.bzapper.com.br/v1/widget.js"
data-key="wgt_sua_chave" async></script>La chiave wgt_ è pubblica (va nell’HTML) ed è bloccata da una allowlist di origini che configuri nel pannello. La tua API key reale non compare mai. La parte finanziaria (piani e fatture) resta nel pannello — il widget gestisce solo le connessioni.
Offri WhatsApp dentro il tuo software
Il tuo cliente si abbona a bZapper Pro e collega il numero senza uscire dal tuo prodotto. Ricevi la API key che ha autorizzato e inizi subito a inviare e ricevere messaggi.
- 1
Account in un clic
Il componente si apre con i dati che il tuo prodotto ha già. Niente password, captcha o conferma e-mail.
- 2
Abbonamento Pro
Carta o Pix, lì stesso. Il cliente paga direttamente bZapper — tu non gestisci la fatturazione.
- 3
WhatsApp collegato
QR code o codice di abbinamento, con stato in tempo reale. Alla fine, il tuo backend riceve la API key.
Una riga nel front-end
Modale o inline, in Shadow DOM: nessun conflitto con il CSS del tuo prodotto.
Un webhook per tutti
Messaggi e stato di tutti i tuoi clienti su un unico endpoint, con l’id cliente del tuo sistema.
Sospensione automatica
Se il Pro del cliente non è pagato, la key risponde 402 e riparte da sola al pagamento.
In tutti i 7 SDK
Node, Python, PHP, .NET (C#), Java, Go e Ruby includono già il client partner.
Cosa deve scrivere il tuo prodotto:
// 1. il tuo backend apre la sessione con il secret partner
const { session_token } = await api.post('/bzapper/session')
// 2. il cliente si abbona e collega senza uscire dalla tua schermata
BzapperConnect.open({
session: session_token,
onComplete: ({ code }) => api.post('/bzapper/exchange', { code }),
})
// 3. il tuo backend scambia il code con la API key del cliente
// → { api_key: "bz_live_…", status: "active" }Il secret partner e la API key restano sul tuo backend. Il browser riceve un ticket di 30 minuti valido solo sui tuoi domini. La key partner gestisce WhatsApp ma non tocca piano, utenti o fatturazione del cliente.
WhatsApp via API, senza interruzioni
La consegna è ingegneria. Ogni numero del progetto ha limiti di invio propri, monitoraggio continuo della salute e avvisi in tempo reale. Quando un numero diventa non disponibile, la conversazione prosegue su un altro — senza che tu faccia nulla.
- Failover automatico quando un numero diventa non disponibile
- Salute di ogni numero monitorata di continuo
- Conversazioni unificate per contatto, anche cambiando numero
- Avvisi in tempo reale quando un numero cade
Una rubrica contatti che lavora per te
Ogni numero che tocchi diventa un contatto ricco — con documento, indirizzo, tag e cronologia. Correlato da solo per progetto e numero, filtrabile in pochi secondi e sempre sotto il tuo registro dei consensi.
- Profilo ricco
Nome, telefono, email, documento (codice fiscale) e indirizzo completo — città, provincia, CAP e paese.
- Tag e gruppi
Organizza con tag e gruppi con dizionari propri. Un contatto può stare in più — tutto versionato.
- Correlazione automatica
Ogni contatto viene collegato da solo al progetto e al numero da cui ha parlato. Nessun inserimento manuale, nessun duplicato.
- Filtri avanzati
Cerca per stato, tag (tutti o qualsiasi), città, documento, attività e date — dall’API o dal pannello.
- Cronologia e note
Una timeline append-only di ogni evento del contatto, più note interne del team. Nulla va perso.
- Opt-out e blocco
Sopprimi o blocca con un POST. Lo stato diventa opted_out o blocked e ferma l’invio prima della coda.
- OTP consegnato e letto · 2 min fa
- Collegato al numero +55 51 99919-8087
- Tag “piano-pro” aggiunto da te
- Opt-in registrato nel registro dei consensi
Contatti, tag, gruppi e soppressioni vivono isolati per progetto — una chiave vede solo il proprio progetto.
Vedi nella documentazione →Programma l’invio per il momento giusto
Invia qualsiasi messaggio con data e ora future. bZapper lo conserva e lo invia all’istante esatto — niente cron sul tuo server, nessun processo da tenere attivo.
- Un solo campo
Aggiungi scheduled_at a qualsiasi invio — testo, media, qualunque cosa. Il resto è uguale a un invio normale.
- Numero scelto all’invio
Il numero sano viene scelto al momento dell’invio, non della programmazione — non finisce mai su un numero andato offline.
- Annulla quando vuoi
Elenca e annulla le programmazioni in sospeso in qualsiasi momento, via API o pannello.
// programma tra 2 ore
POST /messages/text
{
"to": "+5511999990000",
"body": "Bom dia! ☀️",
"scheduled_at": "2026-07-01T09:00:00Z"
}I tuoi contatti sono il tuo bene più prezioso
Un numero bannato e una lista bruciata costano cari. Per questo proteggere la tua base non è un extra — è il modo in cui bZapper è costruito, dall’isolamento per progetto al registro del consenso.
Li trattiamo come se fossero nostri: protetti, isolati e sotto il tuo controllo.
- Isolamento per progetto
Numeri, inbox, chiavi e soppressione vivono in progetti isolati. Una chiave vede solo il proprio progetto — nulla trapela tra clienti o ambienti.
- Media privati con presign
I file di conversazione stanno in un bucket privato e si aprono solo con una URL prefirmata a breve durata (24h di default). Niente di indicizzabile, niente allo scoperto.
- Opt-out e soppressione nativi
Chi risponde PARAR/SAIR/STOP viene soppresso automaticamente e non riceve più invii. La block list ferma l’invio prima di accodarlo.
- Registro del consenso
Ogni opt-in e opt-out entra in un registro append-only, datato e verificabile — la prova della base giuridica richiesta dalla LGPD.
- Webhook firmati
Ogni evento parte con firma HMAC-SHA256 e verifica timing-safe. Il segreto del webhook resta cifrato a riposo.
- Segreti cifrati
Sessioni WhatsApp cifrate a riposo e il codice OTP mai persistito né mostrato. Telefono ed email normalizzati nel database.
Contatto soppresso nel progetto all’istante e registrato nel registro del consenso. L’opt-out per parola chiave emette inoltre il webhook contact.opted_out.
bZapper è il responsabile del trattamento e si occupa del lavoro pesante di privacy; la base giuridica del consenso è una tua responsabilità. Lavoriamo insieme.
Leggi la guida Privacy & LGPD →Paghi per i numeri. Messaggi, illimitati.
Ciò che conta è non smettere di consegnare — e questo è ridondanza tra numeri. Scegli il piano, attiva la ricorrenza e dimentica la fattura.
Free
Prova la ridondanza, senza carta.
- 2 numeri (ridondanza attiva)
- 150 interazioni/mese (invio + ricezione)
- 1 progetto
- 100 MB di media
- 15 giorni di conservazione
- Failover · SDK · webhook
Come funziona la franchigia
- Conta 1 per messaggio inviato e 1 per messaggio ricevuto — i due lati della conversazione.
- Non contano: i messaggi inviati dal tuo telefono (replicati da WhatsApp) e gli eventi interni del protocollo.
- All'esaurimento, gli invii si fermano fino al ciclo successivo; la ricezione continua e non si perde nulla.
- Il conteggio riparte il 1º del mese. Avvisiamo via e-mail all'80% e all'esaurimento.
- Con Pro non c'è franchigia: messaggi illimitati.
Pro
Tutto illimitato. Per la produzione.
- 2 numeri (ridondanza)
- Messaggi ILLIMITATI
- 1 progetto
- 1 GB di media
- 30 giorni di conservazione
- Uptime + avvisi · priorità
Sei cresciuto? Aggiungi al volo — addebito proporzionale
Gli add-on sono una frazione dell’abbonamento Pro. Aggiunto a metà mese? Paghi solo il proporzionale fino alla fattura successiva.
Componi il tuo piano
Regola le risorse e guarda il totale — proprio come al momento dell’acquisto.
💳 Salva la carta e attiva il rinnovo automatico — accesso senza interruzioni, zero pensieri.
Prezzi in BRL (Brasile). Americhe in USD · altre regioni in EUR — definiti dalla tua regione.
Per cosa la gente usa bZapper
OTP / 2FA
Codici di verifica con testo variato e consegna tracciata.
Notifiche transazionali
Ordini, addebiti, promemoria — direttamente dal tuo backend.
Assistenza centralizzata
Più numeri, una sola inbox, N operatori.
Bot nei gruppi
Monitora menzioni e allegati, rispondi nel contesto giusto.
Automazioni e no-code
Integra con n8n, Make, Zapier via webhook e HTTP.
Avvisi e promemoria
Conferme, promemoria di appuntamenti e avvisi operativi dal tuo sistema.
Tutto ciò che vuoi sapere
È l’API ufficiale di WhatsApp?
Può esserlo — scegli per progetto. Con la <strong>Cloud API ufficiale di Meta</strong>, l’account si collega dalla schermata di Meta, i messaggi fuori dalla finestra di 24 ore usano template approvati e il costo per messaggio è addebitato da Meta direttamente sul tuo account. L’altra opzione è WhatsApp collegato dal pannello con codice QR. API, SDK e webhook sono gli stessi in entrambi i casi.
Come garantite la consegna?
Ogni numero ha limiti di invio propri e monitoraggio continuo della salute. Quando uno diventa non disponibile, gli altri subentrano e ricevi un avviso in tempo reale — e la conversazione resta unificata per contatto.
Quanto costa?
Due piani semplici. <strong>Free</strong> (gratis): 2 numeri con ridondanza, 150 interazioni/mese (ogni messaggio inviato e ricevuto ne conta una), 1 progetto, 100 MB e 15 giorni di conservazione — per provare la ridondanza senza carta. Esaurita la franchigia, l’invio resta sospeso fino al ciclo successivo e la ricezione continua a funzionare — il Pro toglie il limite. <strong>Pro</strong> (R$ 49,90/mese): 2 numeri, <strong>messaggi illimitati</strong>, 1 progetto, 1 GB e 30 giorni di conservazione. Ti serve di più? Gli add-on sono una frazione del canone — numero extra, progetto extra, +GB di media, +conservazione — e aggiungendoli a metà mese paghi solo il proporzionale fino alla fattura successiva. In BRL in Brasile; Americhe in USD, altre regioni in EUR. Consigliamo di salvare la carta e attivare il rinnovo automatico: accesso senza interruzioni.
In quanto tempo integro?
Minuti. Crea l’account, genera una API key e usa uno degli SDK (Node, Python, PHP, .NET, Java, Go, Ruby) o un POST puro. C’è il playground e documentazione completa.
Avete SDK e webhook?
Sì — SDK in 7 linguaggi, allineati a OpenAPI e testati dalla stessa suite di conformità, webhook firmati con HMAC, retry/dedup e un relay locale stile `stripe listen` per testare in localhost.
E la privacy dei dati?
I media delle conversazioni vanno in un bucket privato con URL pre-firmato; il codice OTP non viene mai persistito; i segreti sono cifrati. Retention configurabile per account.
Inizia a inviare su WhatsApp in pochi minuti
Crea il tuo account gratis, genera una API key e fai il primo invio oggi. Senza carta, senza burocrazia.