AnmeldenKostenlose Testphase starten
Meta Tech Provider

Ihre WhatsApp-Automatisierungen absichern: Schlüssel, Webhooks und Signaturen

Eine WhatsApp-Automatisierung sichern Sie an vier Punkten: dem KI-Schlüssel, der verschlüsselt gespeichert und nur für KI-Antworten genutzt wird; dem Webhook, den eine Automatisierung aufruft und der vor dem Vertrauen in eine Anfrage eine HMAC-Signatur prüfen sollte; der Weiterleitung eingehender Nachrichten, signiert mit einem Geheimnis, das Sie rotieren können; und den Personen und Assistenten mit Zugriff, der auf das Nötige beschränkt bleibt.

easyCoexistence speichert Ihre KI-Schlüssel verschlüsselt und zeigt sie nie wieder an.

AES-256-GCM

Verschlüsselung im Ruhezustand für gespeicherte KI-Schlüssel, Signiergeheimnisse und das Meta-Zugriffs-Token der Nummer.

Last 4

Nach dem Speichern sehen Sie vom KI-Schlüssel nur noch „ending in“ mit den letzten vier Zeichen.

192 bits

Zufälligkeit in jedem Signiergeheimnis: whsec_, gefolgt von 24 Zufallsbytes, eines pro Automatisierung und eines pro Weiterleitungsnummer.

HTTPS only

Webhook- und Weiterleitungs-URLs müssen öffentlich und per HTTPS erreichbar sein; private und interne Adressen werden beim Speichern und vor jedem Versand abgelehnt.

5 minutes

Empfohlene Obergrenze für das Alter des t-Werts der Signatur, damit wiederholte Anfragen abgelehnt werden.

Was muss in einem WhatsApp-Automatisierungs-Setup geschützt werden?

Fünf Zugangsdaten, jede mit eigenem Ort und eigener Maßnahme bei einem Leck. Zwei davon gehören den Automatisierungen selbst: der KI-Schlüssel und das Signiergeheimnis von „Call my webhook“. Das Weiterleitungsgeheimnis gehört zur Nummer, das Zugriffs-Token und die Anmeldung Ihres Assistenten gehören zum Konto. Wer weiß, wem welches gehört, weiß, was bei einem Problem zu rotieren ist.

AI keyYour Anthropic, OpenAI or OpenRouter key. Saved under AI keys, encrypted, shown only as its last 4 characters.
Webhook signing secretOne per automation, for Call my webhook. Shown as Signing secret in the editor once the automation is saved.
Forward secretOne per number, for the Forward URL. Shown once; New secret replaces it.
Number access tokenReturned by get_api_credentials for sending through Meta's API. Treat it like a password.
Assistant sign-inThe OAuth session of ChatGPT, Claude or another MCP client. Removed from the client's settings.

Wie werden KI-Schlüssel gespeichert und verwendet?

Nur über das Dashboard: die Schaltfläche „AI keys“ auf der Seite Automations, dann „Test and save“. Der Schlüssel wird zuerst gegen einen kostenlosen Endpoint des Anbieters geprüft, der keine Tokens verbraucht. Ein Schlüssel, den der Anbieter ablehnt, wird verworfen und nicht gespeichert. Ein funktionierender Schlüssel wird im Ruhezustand mit AES-256-GCM verschlüsselt, nur zum Aufruf dieses Anbieters für Ihre KI-Schritte und Agenten sowie zum Ausschreiben von Sprachnachrichten bei einem OpenAI- oder OpenRouter-Schlüssel entschlüsselt und danach nur noch als „ending in 1234“ angezeigt. Kein MCP-Tool nimmt einen Schlüssel an oder gibt ihn zurück, er gelangt also nie in einen Chat mit Ihrem Assistenten.

Ein Konto hat einen Schlüssel pro Anbieter, und ein neuer ersetzt den alten. Legen Sie beim Anbieter einen eigenen Schlüssel für Automatisierungen an, wenn möglich mit Ausgabenlimit, damit er widerrufen werden kann, ohne Ihre anderen Apps zu unterbrechen. Lehnt der Anbieter ihn später ab, zeigen Automatisierungen, die ihn nutzen, „Paused“, und Sie erhalten eine E-Mail. Das Speichern eines funktionierenden Schlüssels startet sie von selbst neu.

Wie prüfen Sie, dass eine Anfrage von „Call my webhook“ echt ist?

Prüfen Sie die Signatur, bevor Sie irgendetwas anderes lesen. Jede Anfrage trägt X-EC-Signature: t=<Unix-Sekunden>,v1=<hex HMAC-SHA256 von "<t>.<Body>">, berechnet mit dem „Signing secret“ der jeweiligen Automatisierung als Schlüssel. Sie kopieren es nach dem Speichern aus dem Schritt im Editor. Berechnen Sie den HMAC über die rohen Bytes des Bodys neu, vergleichen Sie in konstanter Zeit und lehnen Sie ein t ab, das mehr als 5 Minuten von Ihrer Uhr abweicht. Auch der Body liefert zwei Hinweise, auf die Sie reagieren sollten. dry_run ist true, wenn die Anfrage aus „Try it“ stammt; überspringen Sie dann alles Unumkehrbare, etwa das Anlegen einer Bestellung. Und run_id ist für jeden Lauf eindeutig: Speichern Sie die bereits bearbeiteten und lehnen Sie eine wiederholte Anfrage ab. Antworten Sie innerhalb von 20 Sekunden. {"reply": "..."} wird unverändert an den Kunden gesendet, reichen Sie daher Kundentext nie ungeprüft weiter.

A Call my webhook request: headers and body
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>

{
  "event": "automation.step",
  "dry_run": false,
  "automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
  "run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
  "channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
  "message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
  "history": [
    { "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
    { "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
  ]
}

// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }

Wie funktionieren Weiterleitungsgeheimnisse, und wie rotieren Sie sie?

Eine Nummer mit der Einstellung „Through easyCoexistence“ kann eingehende Nachrichten an Ihr eigenes System weiterleiten. Beim ersten Speichern einer Weiterleitungs-URL wird ein Geheimnis erzeugt und nur einmal angezeigt, unter „Your signing secret, shown once. Copy it now:“. Es signiert jeden weitergeleiteten POST nach demselben X-EC-Signature-Schema. Ein neues Geheimnis auf der Seite der Nummer oder set_inbound_mode mit rotate_secret auf true erzeugt einen Ersatz, ebenfalls nur einmal angezeigt. Danach signiert alles damit, auch Wiederholungen älterer Zustellungen. Sie können auch ein eigenes Geheimnis mit mindestens 24 Zeichen eingeben, das gespeichert und nie wieder angezeigt wird. Das Beenden der Weiterleitung über „Stop forwarding“ löscht das Geheimnis, sodass beim späteren Speichern einer URL ein frisches entsteht.

Rotieren Sie, nachdem ein Teammitglied mit Zugriff ausgeschieden ist, nachdem ein Geheimnis in einem Repository, einem Ticket oder einem Log gelandet ist und wenn Sie den Hosting-Anbieter wechseln. Das Geheimnis von „Call my webhook“ gehört zur Automatisierung, und nur der Kontoinhaber sieht es. Wo der Editor unter einem Auslöser „Your system calls a URL“ „New secret“ zeigt, ersetzt dieser Knopf es, und das alte funktioniert sofort nicht mehr. Legen Sie bei einer Automatisierung ohne diesen Knopf die Automatisierung neu an, stellen Ihren Empfänger auf das neue Geheimnis um und löschen dann die alte Automatisierung.

Welche Adressen können Automatisierungen aufrufen?

Nur öffentliche HTTPS-Adressen. Eine URL für „Call my webhook“ oder eine Weiterleitungs-URL, die mit http:// beginnt, auf localhost zeigt, in einen privaten Netzbereich führt, einen Namen mit .internal oder .local trägt oder auf eine Metadaten-Adresse eines Cloud-Anbieters verweist, wird beim Speichern abgelehnt. Vor jeder Anfrage wird sie nach der DNS-Auflösung erneut geprüft, sodass ein öffentlicher Name später nicht in ein privates Netz umgeleitet werden kann. Weiterleitungen werden nicht verfolgt: Ein 301 oder 302 lässt den Schritt fehlschlagen, speichern Sie also die endgültige Adresse.

Halten Sie Geheimnisse aus der URL selbst heraus. list_automations gibt die Schritte jeder Automatisierung einschließlich der Webhook-URL an jeden mit Ihrem Konto verbundenen Assistenten zurück, ein Token im Query-String ist dort also lesbar. Lassen Sie stattdessen die Signatur den Nachweis tragen.

Wie halten Sie den Zugriff auf ein Minimum?

Geben Sie jeder Person und jedem Tool nur den Zugriff, den ihre Aufgabe braucht, und entfernen Sie, was nicht mehr genutzt wird. Die Connector-Seite mit Anmeldung, Bestätigungen und gesperrten Tools ist auf der Seite zum sicheren Verbinden von WhatsApp mit einem KI-Assistenten beschrieben. Auf der Seite der Automatisierungen zählen vor allem diese Gewohnheiten:

  • Fragen Sie get_api_credentials nur in einem privaten Chat an, denn das Zugriffs-Token der Nummer steht dann in diesem Verlauf.
  • Bevorzugen Sie „Call my webhook“ oder eine Weiterleitungs-URL, statt das Token einem Drittanbieter-Tool zu übergeben.
  • Löschen Sie Automatisierungen, die Sie ausgemustert haben. Damit werden auch ihre Signiergeheimnisse ungültig.
  • Denken Sie daran, dass Laufprotokolle Kundennachrichten und Antworten 30 Tage lang speichern und Conversations Chats für Ihren Aufbewahrungszeitraum (30, 90 oder 365 Tage) behalten, beides lesbar im Dashboard und über Ihren verbundenen Assistenten.
  • Bei einer Nummer, die auf „Straight to your system“ steht, setzen Sie ein langes zufälliges Geheimnis in den Pfad der Callback-URL, da sich die Signatur von Meta dort nicht prüfen lässt.

Häufige Fehler

  • Die Signatur über JSON prüfen, das Ihr Framework neu serialisiert hat. Viele Parser ändern Leerzeichen, Escaping oder die Schlüsselreihenfolge. Berechnen Sie den HMAC über die rohen Bytes der Anfrage, wo Ihr Stack sie offenlegt.
  • Nebenwirkungen bei Testaufrufen auslösen. „Try it“ ruft Ihren Webhook mit dry_run auf true auf, und eine dabei angelegte Bestellung, Erstattung oder CRM-Schreibung ist echt.
  • Einen KI-Schlüssel in den Chat mit Ihrem Assistenten einfügen, um Zeit zu sparen. Kein Tool nimmt ihn an, und er bleibt im Verlauf stehen. Verwenden Sie KI-Schlüssel im Dashboard.
  • Eine Weiterleitung mit dem Geheimnis von „Call my webhook“ prüfen oder umgekehrt. Es sind getrennte Geheimnisse: eines pro Nummer für Weiterleitungen, eines pro Automatisierung für Webhook-Aufrufe.
Mit EasyCoexistence

Jede Anfrage von „Call my webhook“ und jede weitergeleitete Nachricht signiert es mit X-EC-Signature, mit einem Geheimnis, das nur Sie besitzen, und Webhook-Adressen, die nicht öffentlich über HTTPS erreichbar sind, werden abgelehnt. Ihre Nummer bleibt über Coexistence auf der offiziellen Cloud API von Meta, rund um die Uhr überwacht. US$ 9 bis US$ 0.75 pro Nummer und Monat, sinkend mit jeder weiteren Nummer, mit den ersten 3 Tagen kostenlos.

Häufig gestellte Fragen

Kann das easyCoexistence-Team oder der Support meinen KI-Schlüssel sehen?

Der Schlüssel wird nach dem Speichern nie angezeigt: nicht im Dashboard, nicht in MCP-Ergebnissen und nicht in den Fakten, die der Support-Assistent liest. Nur das System entschlüsselt ihn, und zwar erst in dem Moment, in dem es Ihren Anbieter für eine KI-Antwort aufruft.

Wer kann meine Laufprotokolle der Automatisierungen lesen?

Jede Person, die im easyCoexistence-Konto angemeldet ist, einschließlich der Personen, die Sie dazu eingeladen haben, im Tab „Runs“, sowie jeder mit dem Konto verbundene Assistent über list_automation_runs und get_automation_run. Die Protokolle enthalten die Nachricht des Kunden und die Antwort und werden nach 30 Tagen gelöscht.

Wie entferne ich einen KI-Schlüssel sicher?

Schalten Sie zuerst die Automatisierungen, die ihn nutzen, und jeden Agenten, der darauf läuft, mit „Switch Off“ aus. Wählen Sie dann unter „AI keys“ die Option „Remove“ und widerrufen Sie den Schlüssel beim Anbieter. Wird er entfernt, während Automatisierungen ihn noch nutzen, werden diese bei ihrer nächsten KI-Antwort pausiert und Sie erhalten eine E-Mail.

Sendet „Try it“ Kundendaten an meinen Webhook?

Es sendet nur den Beispieltext, den Sie eingegeben haben, mit dry_run auf true und leerem Verlauf. Echte Läufe senden die eingehende Nachricht und bis zu 10 letzte Nachrichten des Chats. Behandeln Sie Ihren Endpoint deshalb so, als verarbeite er Kundendaten.

Weiterlesen

Bereit für den Start?

Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.

Kostenlose Testphase starten

Verifiziert am