Invia aggiornamenti WhatsApp, codici di verifica e risposte interattive da un'unica API.
Recapita conferme d'ordine, codici di verifica monouso, contenuti multimediali e pulsanti interattivi o menu a elenco direttamente nelle chat WhatsApp dei tuoi clienti. Bird convalida i parametri dei template e verifica la finestra di assistenza clienti di 24 ore prima dell'invio, evitando chiamate non riuscite e addebiti imprevisti, e trasmette alla tua app le conferme di consegna e di lettura.
// Install the SDK
// npm install @messagebird/sdk
const msg = await bird.whatsapp.send({
to: "+15551234567",
template: {
slug: "bird_otp",
components: [{ type: "body", parameters: [{ type: "text", text: "123456" }] }],
},
});
console.log(msg.id, msg.status);Invia il primo messaggio in pochi minuti con i nostri SDK per TypeScript, Python, Go o PHP, la CLI di Bird o richieste HTTP dirette. Inizia subito con i template preapprovati di Bird mentre il tuo numero WhatsApp Business è in fase di verifica.
Template e finestra di 24 ore
Invia il formato giusto dentro o fuori la finestra di 24 ore.
WhatsApp distingue i contatti avviati dall'azienda dalle conversazioni attive con i clienti. Raggiungi i clienti fuori da una chat attiva con template di utilità, autenticazione o marketing approvati da Meta, poi passa a testo libero, contenuti multimediali e menu interattivi per 24 ore dopo che ti hanno scritto o chiamato.
Intercetta in anticipo finestre chiuse e variabili non corrispondenti
Bird traccia la finestra di assistenza clienti di 24 ore per ogni destinatario e numero aziendale. Se la tua app prova a inviare un messaggio libero dopo la chiusura della finestra, o passa variabili di template che non corrispondono ai segnaposto, l'API rifiuta la chiamata prima che venga creato o addebitato qualcosa.
Contenuti multimediali, pulsanti interattivi e menu a elenco
Quando una conversazione è aperta, invia immagini, PDF, clip audio, video, posizioni o schede contatto da un unico endpoint. Aggiungi pulsanti di risposta rapida, menu a elenco con più opzioni, caroselli di prodotti o richieste di posizione e contatto, così i clienti toccano invece di digitare.
Tracciamento delle consegne in tempo reale
Traccia i messaggi dall'accettazione dell'API alla conferma di lettura.
L'invio su WhatsApp è asincrono. Quando Bird accetta la tua richiesta, gli eventi webhook e la cronologia di ogni messaggio mostrano quando il messaggio viene passato a WhatsApp, consegnato al telefono del cliente e aperto in chat.
Diagnostica i rifiuti con i dettagli degli errori Meta
Se un messaggio non va a buon fine dopo l'accettazione, ad esempio perché la finestra di servizio scade durante l'invio o Meta blocca la consegna, Bird registra la descrizione dell'errore e il codice di errore Meta nel record del messaggio, così il tuo team sa se riprovare o cambiare canale.
Evita invii duplicati nei nuovi tentativi di rete
Includi una chiave di idempotenza nella richiesta di invio: così un timeout o un nuovo tentativo del worker entro il periodo di conservazione restituisce la risposta originale invece di inviare un messaggio duplicato.
order_ready
Eventi
Accettata
Bird accetta la richiesta e restituisce l'identità del messaggio.
Inviato
Il messaggio attraversa il flusso di invio.
Consegnata
Quando disponibili, le osservazioni del provider aggiornano il record del messaggio.
Lettura
Gestisci rifiuti, errori e osservazioni mancanti all'interno della stessa integrazione.
Harbor
Account business
order_ready
Harbor
Account business
Eventi
Accettata
Bird accetta la richiesta e restituisce l'identità del messaggio.
Inviato
Il messaggio attraversa il flusso di invio.
Consegnata
Quando disponibili, le osservazioni del provider aggiornano il record del messaggio.
Lettura
Gestisci rifiuti, errori e osservazioni mancanti all'interno della stessa integrazione.
Contesto per i flussi bidirezionali
Collega le risposte dei clienti all'ordine o al ticket giusto.
Cita un messaggio precedente così il cliente vede direttamente in chat a quale domanda o ordine stai rispondendo. Quando un cliente tocca un pulsante di risposta rapida, sceglie un'opzione dell'elenco o risponde a un messaggio recente, Bird restituisce l'azione selezionata e il riferimento al messaggio citato, così la tua app può instradare subito la risposta.
Aggiungi tag e metadati ai messaggi in uscita
Aggiungi a un messaggio in uscita fino a 20 tag filtrabili e 2 KB di metadati JSON personalizzati. Filtra i log dei messaggi per campagna o flusso e mantieni gli ID interni di ordini o ticket associati al record in uscita, sia nelle letture tramite API sia nei webhook di consegna.
Opera dal tuo codice, dal terminale o dal tuo agente AI
Invia messaggi di prova, esamina la cronologia delle consegne e filtra lo storico recente dalla CLI di Bird, oppure collega il tuo assistente di programmazione tramite il server MCP di Bird, nel rispetto dei permessi di ruolo e mittente del tuo spazio di lavoro.
Domande sull'invio con WhatsApp
Una richiesta accettata significa che il messaggio è stato consegnato?
Posso inviare messaggi in formato libero in qualsiasi momento?
Esiste un endpoint batch per WhatsApp?
Come associo una risposta interattiva alla mia applicazione?
Collega l'intero percorso
Scala senza perdere il controllo.
Separate production and sandbox traffic into dedicated workspaces, scope API keys to the exact channels each service or agent needs, and track permission changes in the audit log.