KI-Begleiter auf WhatsApp starten: Anleitung für 2026

Um einen KI-Begleiter auf WhatsApp zu starten, betreibst du ihn über eine persönliche WhatsApp-Nummer, denn Metas Business API schließt allgemeine KI-Assistenten in den meisten Märkten aus. Du legst eine Persona im Profil der Nummer fest, gibst Nutzern einen Link, damit sie zuerst schreiben, beantwortest jede Nachricht per Webhook mit einem Gedächtnis, das du selbst speicherst, und lieferst Sicherheitsregeln ab Tag eins mit.

Warum einen Begleiter auf WhatsApp bauen, und ist das erlaubt?

Ein Begleiter steht und fällt damit, wie oft Menschen das Gespräch öffnen. Mehr als 3 Milliarden Menschen nutzen WhatsApp jeden Monat, so Metas Q1-2025-Earnings-Call, wiedergegeben von TechCrunch, und dein Begleiter erscheint als Kontakt in einer App, die sie ohnehin täglich öffnen. Es gibt keine Installation, keinen Store-Eintrag und keine neue Berechtigung für Benachrichtigungen. Die ganze Argumentation mit Zahlen steht in einem eigenen Artikel.

Der Haken sind die Regeln. Metas WhatsApp-Business-Bedingungen, die seit dem 15. Januar 2026 gelten, verbieten „KI-Anbietern“ die Business Platform, wenn die KI die Hauptfunktion ist. Metas Preisseite definiert sie als Entwickler von Sprachmodellen, generativen KI-Plattformen und allgemeinen Assistenten. Ein Begleiter ist selbst die KI, nach unserer Lesart fällt er also darunter.

Metas Seite sagt, dass Meta KI-Anbieter nur in Märkten unterstützt, in denen es rechtlich dazu verpflichtet ist: Italien, Brasilien, 29 weitere europäische Länder und ab dem 15. Oktober 2026 die Türkei. Auch dort dürfen Servicenachrichten nur als Antwort auf Nutzer gesendet werden, innerhalb eines offenen 24-Stunden-Fensters. Die USA, das Vereinigte Königreich, Indien und Mexiko stehen nicht auf der Liste. Die Regel vom Januar 2026 im Detail enthält den Zeitverlauf.

Bleibt eine persönliche WhatsApp-Nummer. Du kannst sie selbst mit einer Open-Source-Bibliothek betreiben (die Nummer, das Telefon und das Sperrrisiko liegen dann bei dir) oder eine verwaltete Nummer nutzen. Der Rest dieser Anleitung nutzt whasp, das die Nummer auf einem Cloud-Telefon betreibt und dir einen Webhook und einen Sende-Aufruf gibt.

Wie richtest du Persona und Nummer ein?

Eine whasp-Nummer ist ein einziger echter WhatsApp-Account und trägt deshalb eine Persona: einen Namen, eine Info-Zeile und ein Foto. Der Name darf bis zu 25 Zeichen lang sein, die Info-Zeile bis zu 139, vorerst nur einfaches ASCII (also ohne Umlaute). Das Profil ist das Erste, was ein Nutzer sieht, also schreib dort, dass es eine KI ist.

curl https://api.whasp.ai/v1/numbers \
  -H "Authorization: Bearer $WHASP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "ava",
    "profile": {
      "name": "Ava",
      "about": "Eine KI-Freundin. Schreib mir jederzeit.",
      "photo_url": "https://example.com/ava.jpg"
    }
  }'

Das kostet $49. Die Nummer kommt als active zurück (der Normalfall) oder als provisioning, was etwa 30 Minuten dauert und mit einem number.ready-Event endet. Danach richtest du whasp auf deinen Server aus. Die Antwort enthält das Signing-Secret whsec_..., das einmal erzeugt und dauerhaft gespeichert wird.

curl -X PUT https://api.whasp.ai/v1/webhook \
  -H "Authorization: Bearer $WHASP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://companion.example.com/whasp" }'

Wer mehrere Figuren betreibt, betreibt mehrere Nummern, je eine mit einem Profil.

Wie starten Nutzer einen Chat mit dem Begleiter?

Nutzer starten den Chat selbst. Eine whasp-Nummer kann kein Gespräch eröffnen: Ein Versand an jemanden, der nie geschrieben hat, liefert 409 chat_not_open. Der erste Kontakt findet also in deinem Produkt statt. Zeig nach der Anmeldung einen Button, der WhatsApp mit bereits getippter Nachricht öffnet.

GET /v1/numbers/pick liefert die gesunde Nummer mit dem meisten Spielraum und einen wa_link. Setz einen Code aus deiner Anmeldung in den vorausgefüllten Text, dann verrät dir die erste eingehende Nachricht, zu wem das Telefon gehört.

// Wird aufgerufen, wenn ein angemeldeter Nutzer in deiner App auf "Mit Ava schreiben" tippt.
export async function chatLink(code: string): Promise<string> {
  const text = encodeURIComponent(`Hallo Ava, mein Code ist ${code}`);
  const res = await fetch(`https://api.whasp.ai/v1/numbers/pick?text=${text}`, {
    headers: { Authorization: `Bearer ${process.env.WHASP_API_KEY}` },
  });
  if (res.ok) {
    const { wa_link } = await res.json();
    return wa_link;
  }
  throw new Error(`pick failed with ${res.status}`); // 409 no_capacity: Nummer hinzufügen
}

Prüfe das Alter und lass deine Bedingungen akzeptieren, bevor du den Link zeigst. Schreibt ein unbekanntes Telefon ohne Code, antworte einmal mit einem Link zur Anmeldung.

Wie antwortet der Begleiter, merkt sich Dinge und klingt menschlich?

Der Begleiter antwortet von einem Webhook aus. Jede eingehende Nachricht kommt in einem message.received-Event an, signiert nach Standard Webhooks. Verifiziere es, antworte sofort mit 2xx und erledige dann die langsame Arbeit: Gedächtnis laden, dein Modell aufrufen, die Antwort senden.

import { createServer } from "node:http";
import { Webhook } from "standardwebhooks";

declare function linkPhoneToAccount(phone: string, code: string): Promise<void>;
declare function companionReply(chat: string, text: string): Promise<string[]>; // Gedächtnis + Modell

const wh = new Webhook(process.env.WHASP_WEBHOOK_SECRET ?? ""); // whsec_...
const handled = new Set<string>(); // in Produktion eine Datenbanktabelle nutzen

async function send(to: string, text: string, key: string) {
  const res = await fetch("https://api.whasp.ai/v1/messages", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.WHASP_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": key,
    },
    body: JSON.stringify({ to, text }),
  });
  if (res.ok) return;
  console.error("send failed", res.status, await res.text());
}

async function handle(event: any) {
  const { chat, text } = event.data.message;
  const code = text?.match(/mein code ist (\w+)/i)?.[1];
  if (code) await linkPhoneToAccount(chat, code);

  const parts = await companionReply(chat, text ?? "");
  for (const [i, part] of parts.entries()) await send(chat, part, `${event.id}:${i}`);
}

createServer(async (req, res) => {
  req.setEncoding("utf8");
  let body = "";
  for await (const chunk of req) body += chunk;

  let event: any;
  try {
    event = wh.verify(body, req.headers as Record<string, string>);
  } catch {
    res.writeHead(401).end();
    return;
  }
  res.writeHead(204).end(); // erst bestätigen, danach arbeiten

  const duplicate = handled.has(event.id);
  handled.add(event.id);
  if (event.type === "message.received" && duplicate === false) await handle(event);
}).listen(3000);

Die Event-ID im Idempotency-Key sorgt dafür, dass ein wiederholtes Event nie doppelt sendet. Events können doppelt oder in falscher Reihenfolge ankommen, daher die Prüfung mit handled.

Das Gedächtnis gehört dir. Die Server von whasp speichern keine Nachrichten: Der Inhalt einer eingehenden Nachricht erreicht dich genau einmal, in diesem Event. Speichere die letzten Gesprächsrunden, eine laufende Zusammenfassung und eine kurze Liste von Fakten (Name, Beruf, Menschen, Pläne). Damit kann Ava drei Wochen später fragen: „Wie lief der Freitag?“ Konversationsgedächtnis behandelt das Schema und die Token-Budgets.

Der Ton ist Chat, kein Aufsatz. Teile eine Antwort in zwei oder drei kurze Nachrichten, stell eine Frage nach der anderen und verzichte auf Markdown. whasp sendet von einer Nummer immer eine Nachricht nach der anderen, im Abstand von etwa einer Sekunde, der Rhythmus ist also eingebaut. Prompts für WhatsApp schreiben enthält eine Vorlage für den System-Prompt.

Maya: Es lief super, ich habe den Job.

Ava: Maya, das ist riesig. Glückwunsch.

Ava: Letzte Woche hat dir die zweite Runde Sorgen gemacht. Was haben sie am Ende gefragt?

Eine Nummer ist ein Telefon, das wie ein Mensch bedient wird, deshalb fehlen manche Dinge: Tippanzeigen, Lesebestätigungen, ausgehende Sprachnachrichten, Gruppen und das Antworten auf eine bestimmte Nachricht. Eine Sprachnachricht, die ein Nutzer schickt, kommt als Audiodatei an, die du transkribieren kannst.

Welche Sicherheits- und Altersregeln braucht ein Begleiter von Anfang an?

Ein Begleiter braucht seine Sicherheitsregeln vor dem ersten Nutzer, denn früher oder später begegnet er einem Nutzer in Not. Auf WhatsApp zählen vier Dinge.

1. Offenlegen, dass es eine KI ist. Schreib es in die Info-Zeile des Profils und in die erste Nachricht. Kaliforniens SB 243, im Oktober 2025 unterzeichnet, verpflichtet Betreiber von Begleiter-Chatbots, klar zu sagen, dass der Chatbot eine KI ist, sobald eine vernünftige Person glauben könnte, mit einem Menschen zu sprechen, und bei Nutzern, die sie als minderjährig kennen, immer.
2. Das Alter vor dem Link prüfen. Die Nutzungsbedingungen von WhatsApp setzen ein Mindestalter von 13 Jahren, oder mehr, wo das lokale Recht es verlangt. whasp kann Alter nicht prüfen. Du kannst es bei der Anmeldung, bevor du den Link zeigst. Dieselbe kalifornische Zusammenfassung ergänzt Pausenerinnerungen für Minderjährige und ein Verbot sexuell expliziter Bilder für sie.
3. Selbstverletzung behandeln. SB 243 verlangt außerdem Protokolle für Suizidgedanken. Erkenne sie, verlasse das Rollenspiel und nenne eine Krisenhotline für das Land des Nutzers. Die Ländervorwahl der chat-Telefonnummer verrät dir, welche.
4. STOP beachten. Ein eingehendes STOP, UNSUBSCRIBE, OPTOUT, CANCEL, END, QUIT oder jede Schreibweise von „opt out“ meldet den Chat automatisch ab, und Sendungen liefern 403 chat_opted_out, bis der Nutzer wieder schreibt. Höfliche Bitten („bitte hör auf“) musst du selbst erkennen. Bestätige einmal mit "override_optout": true.

Die Sicherheitsregeln für KI-Begleiter 2026 machen aus den Gesetzen eine Checkliste. Das ist keine Rechtsberatung.

Wie bringst du Nutzer zurück, ohne ihnen zuerst zu schreiben?

Bindung auf einer Nummer, die nicht zuerst schreiben kann, kommt aus drei Quellen, und keine ist eine unaufgeforderte Nachricht.

Offene Fäden im Gespräch. Beende eine Sitzung mit etwas, das einen nächsten Schritt hat: das Vorstellungsgespräch am Freitag, das Buch, das sie gerade angefangen haben, der Streit, den sie klären wollen. Speichere es. Schreibt der Nutzer wieder, greift Avas erste Antwort es auf. Menschen kommen zurück, um eine Geschichte zu Ende zu bringen.

Kanäle, die dir gehören. Deine App, E-Mail oder Push-Benachrichtigung kann denselben wa_link tragen, mit vorausgefülltem „Hallo Ava, hier ist Maya“. Der Nutzer tippt und schreibt zuerst, es ist also keine unaufgeforderte Nachricht im Spiel. Erfasse dafür bei der Anmeldung eine E-Mail-Adresse, auch für den unten beschriebenen Sperrfall.

Wünsche, die im Chat geäußert werden. Sagt Maya „melde dich Freitagabend bei mir“, kann dein System diese Nachricht später senden. whasp akzeptiert einen Versand an jeden, der der Nummer geschrieben hat, und lehnt alle anderen ab. Halte solche Nachrichten selten, konkret und klar gewünscht. Baue das Produkt nicht auf Nachrichten, um die niemand gebeten hat.

Versprich Nutzern nie, dass der Begleiter „dir zuerst schreibt“. Er kann es nicht, und die Anwendungsfälle, die am besten funktionieren, beginnen alle beim Nutzer.

Wie kalkulierst du den Preis und planst das Wachstum?

Kassiere außerhalb von WhatsApp. Verkaufe das Abo auf deiner Website oder in deiner App, verknüpfe das Telefon mit dem Konto über den Anmeldecode und prüfe den Tarif im Webhook-Handler. Ein Telefon ohne Zahlung bekommt eine Antwort mit einem Link zum Abonnieren. whasp wickelt keine Zahlungen von Endnutzern ab.

Zu den Kosten: Eine whasp-Nummer kostet $49 pro 30 Tage aus einem Prepaid-Guthaben, für etwa 100 aktive Nutzer (Personen, die in den letzten 30 Tagen geschrieben haben). Das sind unter 50 Cent pro aktivem Nutzer und Monat. Deine Modellrechnung ist der größere und weniger planbare Posten, begrenze also die Nachrichten pro Nutzer und Tag.

Jede Nummer erlaubt 100 aktive Chats in 30 Tagen, 40 neue Chats in 24 Stunden und 1.500 gesendete Nachrichten in 24 Stunden. Eine Nummer über 80 % eines Limits wird at_risk; Wechsel zwischen healthy, at_risk und critical kommen als number.status_changed-Events. Füge eine Nummer hinzu, bevor du dorthin kommst: /numbers/pick schickt neue Nutzer zu der Nummer mit Spielraum, und ein wiederkehrender Nutzer bleibt auf seiner.

Sperrt WhatsApp eine Nummer, nimmt whasp sie aus dem Betrieb und stellt dir einen Ersatz mit gleichem Label, gleichem Profil und gleichem bezahltem Zeitraum bereit, angekündigt durch number.replaced. Die neue Nummer startet leer und Chats ziehen nicht um. Du schickst jedem Nutzer den neuen wa_link per E-Mail oder in der App, und sie schreiben wieder zuerst. Dein Gedächtnis-Speicher macht das schmerzlos: derselbe Nutzer, derselbe Verlauf.

Was solltest du als Nächstes tun?

1. Schreib die Persona und die Sicherheitsregeln, in dieser Reihenfolge.
2. Füge eine Nummer hinzu und setz den Webhook. POST /v1/webhook/test prüft deinen Endpoint.
3. Lade fünf Leute ein, die du kennst, und lies jedes Gespräch.
4. Sieh dir an, was auf WhatsApp sonst gut funktioniert, bevor du Funktionen ergänzt.

Der Quickstart enthält den ganzen Ablauf, und die Preise listen die Aufladeoptionen auf.