La WhatsApp Business API, senza il labirinto dei BSP.
Provider ufficiale di soluzioni Meta Business da quando l'API esiste. Approvazione dei template, finestre di sessione, media, messaggi interattivi: tutto gestito. Oltre due miliardi di utenti WhatsApp attivi ogni mese, raggiungibili da un singolo endpoint che funziona come qualsiasi altro canale Bird.
5 minutes from npm install to first send
Invia un messaggio WhatsApp dal linguaggio che già utilizzi.
SDK per ogni runtime principale. Il primo invio va a un destinatario di test autorizzato (+15005550009) con un template pre-approvato, così puoi integrare un check CI prima ancora di sottoporre il tuo primo template per l'approvazione.
Dieci cose che il filtro del BSP ti nasconde. Noi no.
WhatsApp è controllato da Meta. La scelta del BSP si riduce a questo: i vincoli compaiono nel codice o vengono nascosti in una dashboard. Noi abbiamo scelto il codice.
- 01
Meta Business Solution Provider (BSP) ufficiale
Rapporto diretto con Meta da quando esiste l'API. Nessun transito rivenduto, nessun passaggio tramite terzi.
- 02
Gestione dei template
Invia, monitora lo stato di approvazione e ricevi un webhook non appena Meta approva o rifiuta.
- 03
Gestione della finestra di sessione
L'SDK ti indica se è consentito il formato libero o il template prima dell'invio.
- 04
Messaggi interattivi
Pulsanti, liste, schede prodotto e WhatsApp Flows, dichiarati nello stesso payload.
- 05
Media e contenuti rich
Immagini, video, documenti, posizione, contatti, anteprime link, reazioni e risposte.
- 06
WhatsApp Flows
Form in-app a più passaggi con validazione backend, definiti in JSON, eseguiti da Meta.
- 07
Click-to-WhatsApp Ads
Integrazione con Meta Ads Manager: i clic sugli annunci aprono una conversazione a cui puoi rispondere.
- 08
Fallback cross-channel
Aggiungete fallback: "sms" a qualsiasi invio. La scadenza della sessione viene instradata automaticamente tramite SMS.
- 09
Webhook per messaggi in entrata
Eventi firmati HMAC per messaggi in entrata, conferme di lettura, reazioni e stato dei template.
- 10
2B+ utenti su un unico endpoint
Oltre due miliardi di utenti WhatsApp al mese raggiungibili con una singola chiamata bird.whatsapp.send.
Perché sviluppiamo WhatsApp
Siamo stati tra i primi BSP di WhatsApp. Siamo ancora tra i pochi che scrivono codice insieme a te.
WhatsApp è regolamentato. Serve un template approvato; serve una finestra di sessione con opt-in; serve una verifica aziendale Meta. Questo non cambia, e non cambierà. Quello che cambia è se il vostro BSP rende questi requisiti più facili o più difficili da gestire: esponendoli nel codice, nei webhook a cui potete iscrivervi, negli errori che dicono esattamente cosa non va. Noi abbiamo scelto la prima via.
Ogni cambio di stato è un webhook.
Payload firmati con HMAC, protetti da replay, idempotenti. Lo stesso formato su ogni canale Bird: imparatene uno e li avrete imparati tutti.
Programma di retry: 5s, 30s, 5m, 30m, 2h, 6h, 12h. Dead-letter dopo l'ultimo tentativo; ogni evento dead-letter è riproducibile dalla dashboard o dall'API.
whatsapp.queuedAccettato dall'API e in coda per l'invio a Meta.whatsapp.sentConsegnato alla Cloud API di Meta.whatsapp.deliveredMeta conferma che il messaggio è arrivato sul dispositivo del destinatario.whatsapp.readIl destinatario ha aperto il messaggio (se le conferme di lettura sono attive).whatsapp.failedErrore permanente: codice motivo nel payload.whatsapp.receivedMessaggio in entrata da un utente all'interno della finestra di sessione di 24 ore.whatsapp.template.approvedMeta ha approvato un template che hai inviato.whatsapp.template.rejectedMeta ha rifiutato un template: motivo del rifiuto nel payload.
Il fallback su SMS è un attributo, non una seconda integrazione.
Se WhatsApp non riesce a consegnare — sessione scaduta, destinatario senza opt-in, template non ancora approvato — Bird instrada lo stesso messaggio via SMS nella stessa richiesta. Stessa autenticazione, stesso contratto di idempotenza, stesso formato webhook dall'altra parte.
WhatsApp con fallback.
Un solo payload, un'unica autenticazione. Scadenza della sessione, mancanza di opt-in, template non approvato: tutto viene instradato automaticamente tramite SMS.
SMS diretto.
Gli stessi canali, indirizzati direttamente. Usalo quando vuoi il percorso SMS in modo esplicito.