Senden Sie SMS.
Senden Sie Bestellupdates und Erinnerungen, mit Schutz vor doppelten Nachrichten bei erneuten Versuchen.
Ihre Bestellung #4821 ist abholbereit.
Senden Sie Ihre erste Nachricht in wenigen Minuten.
Testen Sie sicher, bevor Sie echten Kunden schreiben.
Mit der Bird SMS API sendet ein einziger Aufruf aus Ihrem Backend eine Bestellbestätigung, ein Lieferupdate oder eine Terminbenachrichtigung. Bevor Sie echten Kunden schreiben, leiten Sie Testnachrichten von einem aktiven US-Absender an die US-Sandbox-Nummer +15005550006. So prüfen Sie Ihre Integration und Ihre Webhook-Verarbeitung, ohne eine Nachricht an ein echtes Mobiltelefon zuzustellen.
// Install the SDK
// npm install @messagebird/sdk
const msg = await bird.sms.send({
from: "+15557654321",
to: "+14155550100",
text: "Your verification code is 123456.",
category: "authentication",
});
console.log(msg.id, msg.status);Sie möchten einen Nutzer bei der Anmeldung oder an der Kasse verifizieren? Statt Einmal-Bestätigungscodes selbst zu erzeugen und zu speichern, nutzen Sie Bird Verify, um Verifizierungscodes automatisch auszustellen, ablaufen zu lassen und zu prüfen.
Halten Sie die SMS-Zustellung im Produktivbetrieb vorhersehbar.
Vermeiden Sie unerwartete Segmentkosten, doppelte Nachrichten bei erneuten Versuchen und unbemerkte Fehler beim Netzbetreiber.
01Sehen Sie die Segmentanzahl direkt in der Antwort.
Jeder angenommene Versand gibt die ermittelte Zeichenkodierung und Segmentanzahl zurück. Entwürfe können Sie vor dem Start einer neuen Vorlage im Segmentrechner prüfen.02Verarbeiten Sie GSM-7 und Unicode ohne Rätselraten.
Standardnachrichten in GSM-7 fassen 160 Zeichen in einem Segment. Nachrichten mit Emoji oder nicht-lateinischen Schriften wechseln automatisch zu Unicode mit 70 Einheiten. Längere Nachrichten werden sauber aufgeteilt und auf dem Telefon des Kunden wieder zu einer Nachricht zusammengesetzt.03Senden Sie bis zu 100 personalisierte Nachrichten in einem Aufruf.
Versenden Sie eine Warteschlange von Terminerinnerungen oder Schichtbenachrichtigungen in einer einzigen Batch-Anfrage. Bird validiert den Batch vorab, damit fehlerhafte Eingaben sofort scheitern, und verfolgt dann die Zustellung für jeden Empfänger einzeln.04Versuchen Sie abgelaufene Anfragen erneut, ohne doppelt zu senden.
Hängen Sie einen Idempotenzschlüssel an, wenn Ihr Worker eine Nachricht sendet. Löst ein Netzwerk-Timeout einen erneuten Versuch mit demselben Schlüssel und Payload aus, gibt Bird die ursprüngliche Antwort zurück, statt eine doppelte Nachricht einzureihen.05Erfahren Sie, wann der Netzbetreiber eine Nachricht zustellt oder ablehnt.
Empfangen Sie signierte Webhooks, während eine Nachricht von angenommen zu gesendet, zugestellt oder fehlgeschlagen wechselt. So kann Ihre App den Bestellstatus aktualisieren oder auf einen anderen Kanal ausweichen, wenn eine Nummer nicht erreichbar ist.
Migrieren Sie mit wenigen Codezeilen von Twilio.
Übertragen Sie Ihre bestehenden Absendernummern, Empfängerfelder und Webhook-Handler auf Bird, ohne Ihren Benachrichtigungsdienst neu aufzubauen. Synchronisieren Sie Ihre Opt-out-Liste und prüfen Sie die Zustellung mit der Sandbox-Nummer, bevor Sie Live-Traffic umstellen.
import twilio from "twilio";
const client = twilio(accountSid, authToken);
await client.messages.create({
from: "+14155550172",
to: "+15005550006",
body: "Your code is 123456.",
});import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });
await bird.sms.send({
from: "+14155550172",
to: "+15005550006",
text: "Your code is 123456.",
category: "authentication",
});Erkennen Sie mehrteilige Nachrichten, bevor sie Ihre Rechnung erhöhen.
Ein einziges typografisches Anführungszeichen, Emoji oder Akzentzeichen im Namen eines Kunden kann eine Nachricht von der GSM-7-Kodierung mit 160 Zeichen auf Unicode mit 70 Einheiten umstellen. Dann wird eine Nachricht in mehrere abrechenbare Segmente geteilt. Bird gibt Zeichenanzahl, Kodierung und Segmentanzahl in der Versandantwort zurück, damit Ihr Team teure Vorlagen früh erkennt.
const { data, error } = await bird.sms.send({
from: "Bird",
to: "+31612345678",
text: "Your code is 123456.",
category: "authentication",
}).safe();
if (error) throw error;
console.log(data.segments);
// → { characters: 20, count: 1, encoding: "GSM_7BIT" }
Versenden Sie bis zu 100 personalisierte Erinnerungen in einer einzigen Anfrage.
Wenn ein geplanter Job die Terminerinnerungen oder Lieferfenster-Updates für morgen sendet, bündeln Sie bis zu 100 Nachrichten in einem API-Aufruf, statt einzelne Anfragen in einer Schleife zu senden. Jeder Empfänger erhält seine eigene personalisierte Nachricht mit eigenem Zustellstatus. Die Vorabvalidierung fängt fehlerhafte Eingaben ab, bevor der Batch eingereiht wird.
const { data: batch, error } = await bird.sms
.sendBatch(
users.map((u) => ({
from: "Bird",
to: u.phone,
text: `Hi ${u.name}, your appointment is tomorrow at ${u.time}.`,
})),
)
.safe();
if (error) throw error;
console.log(`queued ${batch.data.length} messages`);Verfolgen Sie die Zustellung in Echtzeit und reagieren Sie auf fehlgeschlagene Nachrichten.
Die Übergabe an den Netzbetreiber erfolgt asynchron, nachdem Ihr Versandaufruf erfolgreich war. Deshalb sendet Bird signierte Webhook-Events, während die Nachricht fortschreitet. Aktualisieren Sie Ihre Datenbank, wenn eine Nachricht das Mobiltelefon erreicht, oder lösen Sie bei fehlgeschlagener Zustellung ein Fallback per E-Mail aus und markieren Sie ungültige Nummern.
Jedes Fehler-Event enthält den konkreten Fehlergrund, sodass Sie vorübergehende Probleme am Mobiltelefon von ungültigen Nummern unterscheiden können. Opt-out-Antworten wie STOP unterdrücken künftige Marketingnachrichten automatisch. Gewöhnliche Zustellfehler lassen den Opt-in-Status des Empfängers unverändert.
sms.accepted- Bird hat Ihre Anfrage angenommen und die Nachricht für das Routing zum Netzbetreiber eingereiht.
sms.sent- Bird hat die Nachricht an den Mobilfunkbetreiber des Empfängers übergeben.
sms.delivered- Der Netzbetreiber des Empfängers hat die Zustellung auf dessen Mobiltelefon bestätigt.
sms.failed- Die Nachricht konnte nicht zugestellt werden. Der Fehlergrund ist enthalten, damit Ihre App den Support benachrichtigen oder einen anderen Kanal versuchen kann.
import { bird } from "@/lib/bird";
export async function POST(req: Request) {
const event = bird.webhooks.unwrap(
await req.text(),
Object.fromEntries(req.headers),
);
switch (event.type) {
case "sms.delivered":
await markDelivered(event.data.sms_id);
break;
case "sms.failed":
await flag(event.data.to, event.data.error?.description);
break;
}
return new Response(null, { status: 204 });
}Mehr dazu in den Entwicklerleitfäden.
Prüfen Sie signierte Webhooks, schützen Sie Ihre Versand-Worker mit Idempotenzschlüsseln vor doppelten Nachrichten und nutzen Sie die Fehlerreferenz, um ungültige Nummern oder deaktivierte Ziele automatisch zu behandeln.
Fragen, bevor Sie loslegen
Wähle ich den Absender?
Wie vermeiden Wiederholungsversuche eine doppelte Nachricht?
Bedeutet „akzeptiert“ auch „zugestellt“?
Ist ein Batch dasselbe wie ein Broadcast?
Die übrige SMS-Plattform
Stellen Sie Absendernummern bereit, empfangen Sie Kundenantworten und überwachen Sie die Zustellung im selben Workspace.
- NummernSenden Sie von lokalen Langnummern, gebührenfreien Nummern, Kurzwahlnummern und Absenderkennungen mit Markennamen.
- BidirektionalEmpfangen Sie Kundenantworten auf Terminbestätigungen und Support-Anfragen über dieselbe Nummer.
- ComplianceVerwalten Sie die US-10DLC-Registrierung, länderspezifische Absenderregeln und automatische STOP-Opt-outs.
- RoutingSteuern Sie aktive Zielländer und prüfen Sie die Übergabe an Netzbetreiber sowie den Zustellstatus.
- AnalytikVerfolgen Sie Zustellraten, Fehlergründe der Netzbetreiber und Zustellzeiten über alle Länder hinweg.
- SMS-API-ÜbersichtSehen Sie, wie Versand, Nummern, Zwei-Wege-Antworten, Compliance und Analysen zusammenspielen.
- SMS-RessourcenbibliothekDurchsuchen Sie Implementierungsleitfäden, Länderregeln und interaktive SMS-Tools.
Skalieren, ohne die Kontrolle zu verlieren.
Trennen Sie Produktions- und Sandbox-Traffic in eigene Workspaces, beschränken Sie API-Schlüssel auf genau die Kanäle, die jeder Dienst oder Agent benötigt, und verfolgen Sie Berechtigungsänderungen im Audit-Log.