WhatsAppApi
Aggiungi la messaggistica WhatsApp alla tua app.
Invia aggiornamenti utili, ricevi le risposte dei clienti e segui ogni messaggio lungo il suo ciclo di vita. Usa le API e gli SDK pubblicati di Bird per collegare WhatsApp alle applicazioni e ai flussi di lavoro su cui i tuoi clienti già contano.
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);Scegli il tuo SDK o usa HTTP direttamente. Questi esempi sono generati dall'operazione pubblicata di Bird.
Una richiesta chiara
Scegli il messaggio giusto per il momento.
Usa un template approvato per un messaggio idoneo avviato dal business, oppure una risposta in formato libero supportata all'interno della finestra di servizio clienti. Mantieni mittente, destinatario, lingua e contenuto espliciti.
Usa gli esempi pubblicati
Parti dall'esempio SDK o HTTP generato sopra. Segui la struttura effettiva del contenuto e la validazione dell'operazione invece di indovinare un metodo da un'illustrazione di marketing.
Regola il carico di lavoro
Usa la risposta di limitazione delle richieste e una coda limitata. Quando un'applicazione distribuisce messaggi in fanout, mantieni un record durevole di ogni destinatario previsto e di ogni richiesta.
Un ciclo di vita comprensibile
Segui l'accettazione fino alla risposta del cliente.
Una richiesta API accettata avvia l'elaborazione. L'accettazione da parte di Meta, la consegna e gli aggiornamenti di lettura descrivono fasi successive; non garantiscono che il cliente abbia completato l'attività di business.
Riconcilia con le letture dei messaggi
Consuma i webhook pertinenti e recupera i record dei messaggi quando indaghi su un'anomalia. Mantieni i tentativi incerti distinti dai fallimenti confermati.
Mantieni precise le decisioni di riprovare
Usa le protezioni documentate sulle richieste e la classificazione degli errori. Non dare per scontato che un tentativo incerto del provider possa essere ripetuto all'infinito in sicurezza.
Bird accetta la richiesta e restituisce l'identità del messaggio.
Il messaggio attraversa il flusso di invio.
Le osservazioni del provider aggiornano il record del messaggio quando disponibili.
Gestisci rifiuto, errore e osservazioni mancanti come parte della stessa integrazione.
Una conversazione, non solo un endpoint
Porta il contesto utile nella risposta.
Usa identificatori espliciti di pulsante o lista nelle risposte e lo stato della conversazione nella tua applicazione. Una risposta può citare un messaggio precedente, ma quel riferimento è opzionale e potrebbe non essere disponibile.
Mantieni i metadati al loro posto
I metadati in uscita appartengono al record in uscita. Non dare per scontato che vengano copiati sul messaggio in entrata del cliente.
Collega gli strumenti con gli stessi permessi
CLI e MCP possono aiutare gli sviluppatori a gestire il canale. Restano soggetti agli stessi accessi allo spazio di lavoro, alla proprietà del mittente e alle regole di invio.
Domande su WhatsApp API
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
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Rendi la prima richiesta parte di un'integrazione funzionante.
Configura il tuo spazio di lavoro, usa un esempio pubblicato e ispeziona la risposta. Collega risposte ed eventi di consegna prima di aumentare il traffico.