InloggenGratis proefperiode starten
Meta Tech Provider

Beveilig je WhatsApp-automatiseringen: sleutels, webhooks en handtekeningen

Beveilig een WhatsApp-automatisering op vier punten: de AI-sleutel, opgeslagen versleuteld en alleen gebruikt voor AI-antwoorden; de webhook die een automatisering aanroept, die een HMAC-handtekening moet controleren voordat hij een verzoek vertrouwt; het doorsturen van binnenkomende berichten, ondertekend met een geheim dat je kunt roteren; en de mensen en assistenten met toegang, beperkt tot wat ze nodig hebben.

easyCoexistence slaat je AI-sleutels versleuteld op en toont ze nooit meer, ondertekent elk Call my webhook-verzoek en elk doorgestuurd bericht met X-EC-Signature met een geheim dat alleen jij hebt, en weigert webhook-adressen die geen publiek HTTPS zijn.

AES-256-GCM

Versleuteling in rust voor opgeslagen AI-sleutels, ondertekeningsgeheimen en het Meta-toegangstoken van het nummer.

Last 4

Wat je van een opgeslagen AI-sleutel ooit nog ziet: "ending in" met de laatste vier tekens.

192 bits

Willekeur in elk ondertekeningsgeheim: whsec_ gevolgd door 24 willekeurige bytes, één per automatisering en één per doorstuurnummer.

HTTPS only

Webhook- en doorstuur-URL's moeten publiek HTTPS zijn; privé- en interne adressen worden geweigerd bij opslaan en vóór elke verzending.

5 minutes

Aanbevolen limiet op de leeftijd van de t-waarde in de handtekening, om herhaalde verzoeken te weigeren.

Wat moet je beschermen in een WhatsApp-automatisering?

Vijf inloggegevens, elk met een eigen plek en een eigen oplossing als ze lekken. Twee daarvan horen bij de automatiseringen zelf, de AI-sleutel en het ondertekeningsgeheim van Call my webhook; het doorstuurgeheim hoort bij het nummer; het toegangstoken en de inlog van je assistent horen bij het account. Als je weet welk geheim bij wat hoort, weet je wat je moet roteren als er iets misgaat.

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.

Hoe worden AI-sleutels opgeslagen en gebruikt?

Alleen vanuit het dashboard: de knop AI keys op de pagina Automations, daarna Test and save. De sleutel wordt eerst gecontroleerd bij een gratis endpoint van de provider, dat geen tokens verbruikt, en een sleutel die de provider weigert wordt weggegooid zonder opgeslagen te worden. Een werkende sleutel wordt versleuteld in rust opgeslagen met AES-256-GCM, alleen ontsleuteld om die provider aan te roepen voor je AI-stappen en agents, en om spraakberichten uit te schrijven bij een OpenAI- of OpenRouter-sleutel, en daarna alleen getoond als "ending in 1234". Geen MCP-tool accepteert of geeft een sleutel terug, dus hij komt nooit in een chat met je assistent terecht.

Een account heeft één sleutel per provider, en een nieuwe opslaan vervangt de oude. Maak voor automatiseringen een aparte sleutel aan bij de provider, met een uitgavelimiet waar de provider die biedt, zodat je hem kunt intrekken zonder je andere apps te breken. Als de provider hem ooit weigert, komen automatiseringen die hem gebruiken op Paused te staan en krijg je één e-mail; een werkende sleutel opslaan zet ze vanzelf weer aan.

Hoe controleer je of een Call my webhook-verzoek echt is?

Controleer de handtekening voordat je iets anders leest. Elk verzoek bevat X-EC-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">, ondertekend met het Signing secret van die automatisering, dat je na het opslaan kopieert uit de stap in de editor. Bereken de HMAC opnieuw over de ruwe bytes, vergelijk in constante tijd, en weiger een t die meer dan 5 minuten van je klok afwijkt. De body vertelt je ook twee dingen die de moeite waard zijn. dry_run is true wanneer het verzoek van Try it komt, dus sla alles over wat niet terug te draaien is, zoals het aanmaken van een bestelling. En run_id is uniek per run; bewaar de runs die je al hebt verwerkt en weiger een herhaald verzoek. Antwoord binnen 20 seconden; {"reply": "..."} wordt letterlijk naar de klant gestuurd, dus geef klantentekst nooit ongecontroleerd door.

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." }

Hoe werken doorstuurgeheimen, en hoe roteer je ze?

Een nummer dat is ingesteld op Through easyCoexistence kan de binnenkomende berichten doorsturen naar je eigen systeem. De eerste keer dat je een Forward URL opslaat, wordt een geheim aangemaakt en eenmaal getoond, onder "Your signing secret, shown once. Copy it now:"; het ondertekent elke doorgestuurde POST met hetzelfde X-EC-Signature-schema. Een nieuw geheim op de pagina van het nummer, of set_inbound_mode met rotate_secret op true, maakt een vervanging aan, opnieuw eenmaal getoond, en vanaf dat moment ondertekent alles ermee, ook de nieuwe pogingen van oudere leveringen. Je kunt ook zelf een geheim typen, minstens 24 tekens, dat wordt opgeslagen en nooit meer getoond. Stoppen met doorsturen verwijdert het geheim, dus een URL later opslaan begint met een nieuw geheim.

Roteer na een teamlid dat vertrekt, nadat een geheim in een repository, een ticket of een log is beland, en wanneer je hosting verandert. Een Call my webhook-geheim hoort bij de automatisering en alleen de accounteigenaar ziet het. Waar de editor New secret toont, onder een trigger "Your system calls a URL", vervangt die knop het en werkt het oude meteen niet meer; maak bij een automatisering zonder die knop de automatisering opnieuw aan, laat je ontvanger naar het nieuwe geheim wijzen en verwijder daarna de oude automatisering.

Welke adressen kunnen automatiseringen aanroepen?

Alleen publieke HTTPS-adressen. Een Call my webhook-URL of Forward URL die begint met http://, verwijst naar localhost, een privénetwerkbereik, een .internal- of .local-naam, of een cloud-metadata-adres wordt geweigerd bij opslaan, en na DNS opnieuw gecontroleerd vóór elk verzoek, zodat een publieke naam later niet naar een privénetwerk kan worden gericht. Redirects worden niet gevolgd: een 301 of 302 laat de stap mislukken, dus sla het uiteindelijke adres op.

Houd geheimen buiten de URL zelf. list_automations geeft de stappen van elke automatisering terug, inclusief de webhook-URL, aan elke assistent die met je account is verbonden, dus een token in de querystring is daar leesbaar. Laat de handtekening het bewijs dragen.

Hoe houd je de toegang tot een minimum?

Geef elke persoon en elke tool alleen de toegang die hun taak nodig heeft, en verwijder wat niet meer gebruikt wordt. De connectorkant, met inloggen, bevestigingen en geblokkeerde tools, staat op de pagina over veilig WhatsApp koppelen aan een AI; aan de automatiseringskant zijn deze gewoonten het belangrijkst:

  • Vraag get_api_credentials alleen in een privé-chat: het toegangstoken van het nummer staat dan in dat transcript.
  • Geef de voorkeur aan Call my webhook of een Forward URL boven het token aan een externe tool geven.
  • Verwijder automatiseringen die je hebt uitgefaseerd; dat trekt ook hun ondertekeningsgeheimen in.
  • Houd er rekening mee dat run-logs klantberichten en antwoorden 30 dagen bewaren, en Conversations chats bewaren gedurende je bewaartermijn (30, 90 of 365 dagen), beide leesbaar in het dashboard en via je verbonden assistent.
  • Zet je op een nummer op Straight to your system een lange willekeurige geheime waarde in het pad van de callback-URL, omdat de handtekening van Meta daar niet gecontroleerd kan worden.

Veelgemaakte fouten

  • De handtekening verifiëren over JSON die je framework opnieuw heeft geserialiseerd. Veel parsers wijzigen spaties, escaping of de volgorde van sleutels; bereken de HMAC over de ruwe verzoekbytes waar je stack die beschikbaar stelt.
  • Neveneffecten draaien bij testaanroepen. Try it roept je webhook aan met dry_run op true; een bestelling, terugbetaling of CRM-schrijfactie die dan wordt gedaan, is echt.
  • Een AI-sleutel in een chat met je assistent plakken om tijd te besparen. Geen enkele tool neemt hem aan, en hij blijft in het transcript staan; gebruik AI-sleutels in het dashboard.
  • Een doorstuur-verzoek controleren met het Call my webhook-geheim, of andersom. Het zijn aparte geheimen: één per nummer voor doorsturen, één per automatisering voor webhook-aanroepen.
Dit doen met EasyCoexistence

Je nummer blijft op de officiële Cloud API van Meta via Coexistence, 24/7 bewaakt. Vanaf US$ 9 per verbonden nummer per maand, dalend tot US$ 0,75 naarmate je nummers toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Kan het personeel of de support van easyCoexistence mijn AI-sleutel zien?

De sleutel wordt nooit meer getoond nadat je hem hebt opgeslagen, niet in het dashboard, niet in MCP-resultaten en niet in de feiten die de supportassistent leest. Alleen het systeem ontsleutelt hem, op het moment dat het je provider aanroept voor een AI-antwoord.

Wie kan mijn run-logs van automatiseringen lezen?

Iedereen die is ingelogd op je easyCoexistence-account, ook mensen die je hebt uitgenodigd, in het tabblad Runs, en elke assistent die met het account is verbonden, via list_automation_runs en get_automation_run. Logs bevatten het bericht van de klant en het antwoord, en worden na 30 dagen verwijderd.

Hoe verwijder ik een AI-sleutel veilig?

Zet eerst de automatiseringen die hem gebruiken en elke agent die erop draait uit met Switch Off, selecteer daarna Remove onder AI keys en trek de sleutel in bij de provider. Als je hem verwijdert terwijl automatiseringen hem nog gebruiken, worden ze bij hun volgende AI-antwoord gepauzeerd en krijg je een e-mail.

Stuurt Try it klantgegevens naar mijn webhook?

Het stuurt alleen de voorbeeldtekst die je hebt getypt, met dry_run op true en een lege geschiedenis. Echte runs sturen het binnenkomende bericht en de recente berichten van de chat, tot 10, dus behandel je endpoint alsof het klantgegevens verwerkt.

Lees verder

Klaar om te beginnen?

Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.

Start je gratis proefperiode

Geverifieerd op