Whatsable
Base44 + WhatsableBase44-WhatsApp-Integration: Ihre eigene Nummer
Mit Whatsable verbinden Sie Ihre bestehende WhatsApp-Business-Nummer mit Ihrer Base44-App. Base44 gibt jedem In-App-Agenten eine neue zugewiesene WhatsApp-Nummer.
Behalten Sie Ihre Nummer. Behalten Sie die WhatsApp Business App. Schreiben Sie Kunden mit freigegebenen Vorlagen zuerst an.
Offizieller Meta Tech Provider · WhatsApp Business App behalten
Was Base44 heute bietet und was Whatsable ergänzt
Der integrierte WhatsApp-Kanal von Base44 und Ihre eigene Nummer können parallel laufen. Der integrierte Kanal gibt Ihnen pro Agent eine neue Nummer. Whatsable ergänzt die Nummer, die Ihre Kunden schon gespeichert haben.
Base44 heute: eine zugewiesene Nummer
Jeder In-App-Agent in Base44 bekommt seine eigene neue WhatsApp-Nummer zugewiesen.
- Über alle Ihre Apps hinweg lassen sich insgesamt 3 In-App-Agenten mit WhatsApp verbinden. Superagents haben ein eigenes, separates Kontingent.
- Die erste Nachricht muss vom Nutzer kommen. Base44 hat diese Regel eingeführt, um Spam zu verhindern.
- Jede gesendete oder empfangene Nachricht verbraucht 1 Integration Credit, dazu weitere Credits für Agent-Aktionen wie LLM-Aufrufe. Die Funktion ist in allen Base44-Tarifen kostenlos.
“Verbinden Sie Ihre eigenen WhatsApp-Business-Nummern.”
Whatsable: die Nummer, die Sie bereits haben
Whatsable verbindet Ihre bestehende WhatsApp-Business-Nummer über die offizielle WhatsApp Business Platform von Meta mit Ihrer Base44-App. Die zugewiesene Base44-Nummer läuft parallel weiter.
- Nutzen Sie Ihre eigene WhatsApp-Business-Nummer oder die US-Telefonnummer, die in jedem Tarif enthalten ist. Die WhatsApp Business App können Sie auf Ihrer Nummer weiter nutzen.
- Die WhatsApp Business App löschen Sie nicht. Mit Coexistence antwortet Ihr Team weiter vom Telefon aus auf derselben Nummer.
- Um einen Kunden zuerst anzuschreiben oder mehr als 24 Stunden nach seiner letzten Nachricht, senden Sie eine freigegebene Vorlage. Meta stellt Marketing-Vorlagen nicht an WhatsApp-Nutzer in den USA zu; Utility- und Authentifizierungsvorlagen kommen weiterhin an.
- Eine Base44-Backend-Funktion liest Ihren Whatsable-API-Schlüssel aus Base44 Secrets. Das richten Sie selbst ein, Base44 schaltet es nicht per Knopfdruck frei.
Base44-Backend-Funktion → Whatsable → Ihre eigene WhatsApp-Business-Nummer
Die Einrichtung umfasst vier Schritte. Es ist ein dokumentierter Weg, kein nativer Connector und kein Ein-Klick-Schalter.
- 1Nummer verbinden — Verbinden Sie Ihre WhatsApp-Business-Nummer in Whatsable über den Anmeldeprozess von Meta. Die WhatsApp Business App löschen Sie nicht. Mit Coexistence antwortet Ihr Team weiter vom Telefon aus auf derselben Nummer.
- 2API-Schlüssel erstellen — Öffnen Sie in Whatsable Einstellungen → API-Schlüssel und klicken Sie auf API-Schlüssel erstellen. Kopieren Sie den Schlüssel. Die Whatsable API und Webhooks gibt es in Pro und Agency, nicht in Bulk Message.
- 3Schlüssel in Base44 Secrets speichern — Öffnen Sie in Base44 Dashboard → Secrets → Add Secret und speichern Sie den Schlüssel als WHATSABLE_API_KEY. Oder führen Sie base44 secrets set WHATSABLE_API_KEY=your_key aus. Backend-Funktionen erfordern mindestens den Base44-Tarif Builder. Halten Sie den Schlüssel aus Chats und Frontend-Code heraus.
- 4Senden und empfangen — Fügen Sie die Backend-Funktionen unten hinzu. Sie lesen den Schlüssel mit secrets.get() im Handler und rufen die Whatsable API auf. Deployen Sie die Funktion und kopieren Sie dann ihre URL: https://<your-app-domain>/functions/whatsappWebhook. Öffnen Sie in Whatsable Einstellungen → Webhooks, klicken Sie auf Endpoint hinzufügen und fügen Sie die URL ein. Wählen Sie unter Senden an für eingehende Nachrichten Ihr eigener Server. Um auch von Ihnen gesendete Nachrichten zu erhalten, wählen Sie Make, Zapier oder n8n.
Drei Base44-Funktionen, eine pro Aufgabe
Base44-Backend-Funktionen laufen auf Deno. Jede hat ihren eigenen HTTPS-Endpoint, sodass dasselbe Projekt Nachrichten senden und empfangen kann.
Nachricht senden
Diese Funktion liest Ihren Whatsable-API-Schlüssel mit secrets.get() im Handler und sendet eine Nachricht mit freiem Text. Nutzen Sie sie innerhalb des Kundenservicefensters.
import { secrets } from "base44:runtime";
export default async function (req: Request): Promise<Response> {
const { phone, text, idempotencyKey } = await req.json();
const apiKey = secrets.get("WHATSABLE_API_KEY");
const res = await fetch(
"https://api.whatsable.app/v1/messages",
{
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
// Optional. Reuse a key only to retry a send that got no answer.
"Idempotency-Key": idempotencyKey ?? crypto.randomUUID(),
},
body: JSON.stringify({
to: phone, // E.164, e.g. "+15551234567"
type: "text",
text: { body: text },
}),
},
);
const data = await res.json();
// Refused before sending (key, scope, closed 24-hour window...): HTTP error with data.error.
if (!res.ok) {
return Response.json({ ok: false, error: data.error }, { status: 502 });
}
// 201 means recorded, not sent. A WhatsApp refusal is status "failed" with data.error.
if (data.status === "failed") {
return Response.json({ ok: false, error: data.error }, { status: 502 });
}
return Response.json({ ok: true, messageId: data.id, status: data.status });
}Kunden mit einer Vorlage zuerst anschreiben
Mit einer von Meta freigegebenen Vorlage startet Ihre App die Konversation. Nutzen Sie sie für die erste Nachricht oder wenn das Kundenservicefenster geschlossen ist.
import { secrets } from "base44:runtime";
export default async function (req: Request): Promise<Response> {
const { phone, templateName, language, variables, idempotencyKey } = await req.json();
const apiKey = secrets.get("WHATSABLE_API_KEY");
const res = await fetch(
"https://api.whatsable.app/v1/messages",
{
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
// Optional. Reuse a key only to retry a send that got no answer.
"Idempotency-Key": idempotencyKey ?? crypto.randomUUID(),
},
body: JSON.stringify({
to: phone, // E.164, e.g. "+15551234567"
type: "template",
template: {
name: templateName,
language: language, // e.g. "en_US"
// Keyed by the template's variables[].key, e.g. { "1": "Ana", "2": "#1042" }
variables: variables ?? {},
},
}),
},
);
const data = await res.json();
// Refused before sending (key, scope, unapproved template...): HTTP error with data.error.
if (!res.ok) {
return Response.json({ ok: false, error: data.error }, { status: 502 });
}
// 201 means recorded, not sent. A WhatsApp refusal is status "failed" with data.error.
if (data.status === "failed") {
return Response.json({ ok: false, error: data.error }, { status: 502 });
}
return Response.json({ ok: true, messageId: data.id, status: data.status });
}Eingehende Nachrichten empfangen
Whatsable sendet per POST ein JSON-Payload an den Endpoint dieser Funktion. Direkte HTTP-Aufrufe haben keinen angemeldeten Nutzer, verwenden Sie also asServiceRole für Base44-Ressourcen, die das erfordern.
export default async function (req: Request): Promise<Response> {
const payload = await req.json();
// Messages you send arrive with incoming_message set to false. Skip them here.
if (payload.incoming_message === false) {
return Response.json({ ok: true });
}
const phone = String(payload.phone_number);
const name = payload.recipient_name ?? "";
const text = payload.last_message_of_user ?? "";
// Save or act on the message here. Answer quickly with a 2xx.
return Response.json({ ok: true, phone, name, text });
}Zwei Wege, wie Base44-Builder ihre eigene Nummer nutzen
Bestellupdates von Ihrer eigenen Nummer
Ihre Base44-App verfolgt Bestellungen von Kunden, die Ihrer geschäftlichen WhatsApp-Nummer bereits schreiben.
Ergebnis: Eine Backend-Funktion sendet von dieser Nummer eine freigegebene Vorlage. Antwortet der Kunde, funktioniert innerhalb des Kundenservicefensters auch freier Text.
Vom Prototyp zur Produktion
Ihr Base44-Agent hat die Idee mit einer zugewiesenen Nummer bewiesen, und jetzt müssen Kunden Sie unter der Nummer erreichen, die sie kennen.
Ergebnis: Fügen Sie demselben Base44-Projekt eine Backend-Funktion und einen Webhook hinzu. Die zugewiesene Nummer läuft parallel weiter.
Base44 und WhatsApp: die Antworten
Ja. Jeder In-App-Agent von Base44 bekommt seine eigene WhatsApp-Nummer zugewiesen. Über alle Ihre Apps hinweg lassen sich insgesamt 3 In-App-Agenten verbinden, und die erste Nachricht muss vom Nutzer kommen.
Ja, über Whatsable. Base44 führt Custom Numbers in der eigenen Doku noch als Coming Soon, es ist also ein dokumentierter Weg: Eine Backend-Funktion in Ihrer App ruft die Whatsable API auf.
Ja. Die WhatsApp Business App löschen Sie nicht. Mit Coexistence antwortet Ihr Team weiter vom Telefon aus auf derselben Nummer. In der App getippte Antworten erreichen auch Ihren Webhook, sobald ausgehende Ereignisse aktiviert sind.
Ja. Um einen Kunden zuerst anzuschreiben oder mehr als 24 Stunden nach seiner letzten Nachricht, senden Sie eine freigegebene Vorlage. Meta stellt Marketing-Vorlagen nicht an WhatsApp-Nutzer in den USA zu; Utility- und Authentifizierungsvorlagen kommen weiterhin an. Beim Agenten-Kanal von Base44 muss der Nutzer zuerst schreiben.
Nein. Whatsable verbindet Ihre eigene Nummer über den Anmeldeprozess von Meta und sendet und empfängt über die offizielle WhatsApp Cloud API von Meta. QR-Code-Kopplung oder WhatsApp-Web-Bibliotheken wie Baileys kommen nicht zum Einsatz.
Über einen Webhook, der auf eine Backend-Funktion zeigt. Jede Base44-Funktion hat ihren eigenen HTTPS-Endpoint. Deployen Sie die Funktion und kopieren Sie dann ihre URL: https://<your-app-domain>/functions/whatsappWebhook. Öffnen Sie in Whatsable Einstellungen → Webhooks, klicken Sie auf Endpoint hinzufügen und fügen Sie die URL ein. Wählen Sie unter Senden an für eingehende Nachrichten Ihr eigener Server. Um auch von Ihnen gesendete Nachrichten zu erhalten, wählen Sie Make, Zapier oder n8n.
Nein. Es ist ein dokumentierter Weg, kein nativer Connector: Speichern Sie Ihren Whatsable-API-Schlüssel in Base44 Secrets und rufen Sie die Whatsable API aus einer Base44-Backend-Funktion auf.
Nein. Es sind getrennte Kanäle. Die zugewiesene Base44-Nummer läuft für die Agenten weiter, die sie nutzen, und Ihre eigene Nummer läuft parallel dazu.
Die Whatsable API und Webhooks gibt es in Pro und Agency, nicht in Bulk Message. Base44-Backend-Funktionen erfordern außerdem mindestens den Base44-Tarif Builder.
Weitere Integrationen im Detail
Ihre eigene Nummer, in derselben Base44-App
Behalten Sie die WhatsApp Business App, schreiben Sie Kunden mit Vorlagen zuerst an und lassen Sie die zugewiesene Base44-Nummer weiterlaufen.