WhatsAppApi
Voeg WhatsApp-berichten toe aan je app.
Verstuur nuttige updates, ontvang antwoorden van klanten en volg elk bericht door zijn levenscyclus. Gebruik de gepubliceerde APIs en SDKs van Bird om WhatsApp te verbinden met de applicaties en workflows waar je klanten al op vertrouwen.
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);Kies je SDK of gebruik HTTP rechtstreeks. Deze voorbeelden zijn gegenereerd op basis van de gepubliceerde operatie van Bird.
Eén helder verzoek
Kies het juiste bericht voor het moment.
Gebruik een goedgekeurd template voor een in aanmerking komend bedrijfsgeïnitieerd bericht, of een ondersteund vrij antwoord binnen het klantenservicevenster. Houd afzender, ontvanger, taal en inhoud expliciet.
Gebruik de gepubliceerde voorbeelden
Begin met het gegenereerde SDK- of HTTP-voorbeeld hierboven. Volg de daadwerkelijke inhoudsvorm en validatie van de operatie in plaats van een methode te raden op basis van een marketingillustratie.
Reguleer de werklast
Gebruik het rate-limit-antwoord en een begrensde wachtrij. Wanneer een applicatie berichten uitstuurt, bewaar dan een duurzaam record van elke beoogde ontvanger en elk verzoek.
Een levenscyclus die je kunt doorgronden
Volg acceptatie tot aan het antwoord van de klant.
Een geaccepteerd API-verzoek begint met verwerking. Acceptatie door Meta, aflevering en leesupdates beschrijven latere stadia; ze garanderen niet dat een klant je bedrijfstaak heeft afgerond.
Reconcilieer met leesbevestigingen
Consumeer de relevante webhooks en haal berichtrecords op bij het onderzoeken van een gat. Houd onzekere pogingen gescheiden van bevestigde fouten.
Houd retry-beslissingen precies
Gebruik de gedocumenteerde beschermingen voor verzoeken en foutclassificatie. Ga er niet van uit dat een onzekere poging van de provider veilig onbeperkt herhaald kan worden.
Bird accepteert het verzoek en retourneert de bericht-ID.
Het bericht doorloopt de verzendworkflow.
Waarnemingen van de provider werken het berichtrecord bij wanneer beschikbaar.
Verwerk afwijzing, falen en ontbrekende waarnemingen als onderdeel van dezelfde integratie.
Een gesprek, niet alleen een endpoint
Neem de nuttige context mee in het antwoord.
Gebruik expliciete knop- of lijstantwoord-identifiers en de gespreksstatus van je applicatie. Een antwoord kan een eerder bericht citeren, maar die verwijzing is optioneel en kan ontbreken.
Houd metadata op zijn plek
Uitgaande metadata hoort bij het uitgaande record. Ga er niet van uit dat het wordt gekopieerd naar het inkomende bericht van de klant.
Verbind tools met dezelfde rechten
CLI en MCP kunnen ontwikkelaars helpen het kanaal te beheren. Ze blijven onderworpen aan dezelfde werkruimte-toegang, afzendereigendom en verzendregels.
WhatsApp API-vragen
Betekent een geaccepteerd verzoek dat het bericht is bezorgd?
Kan ik op elk moment vrije berichten sturen?
Is er een WhatsApp batch-endpoint?
Hoe koppel ik een interactief antwoord aan mijn applicatie?
Verbind de volledige klantreis
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.
Maak het eerste verzoek onderdeel van een werkende integratie.
Richt je werkruimte in, gebruik een gepubliceerd voorbeeld en bekijk het antwoord. Verbind antwoorden en aflevergebeurtenissen voordat je het verkeer opschaalt.