· 5 min · TextMeFlow Team

WhatsApp-Nachrichten aus Supabase Edge Functions senden

Wenn dein Backend auf Supabase läuft, hast du Postgres, Auth, Storage und eine Deno-basierte Serverless-Runtime schon an einem Ort — dann brauchst du keinen separaten Node-Server, nur um eine WhatsApp-Benachrichtigung zu senden, wenn sich eine Zeile ändert. Eine Supabase Edge Function kann die TextMeFlow API direkt aufrufen, und ein Datenbank-Webhook kann diese Function auslösen, sobald eine Zeile eingefügt oder aktualisiert wird. Kein Polling, kein Cron-Job, der prüft, ob sich seit dem letzten Mal etwas geändert hat.

Dieser Artikel zeigt zwei Wege, das aufzusetzen: einen Datenbank-Webhook, der auf ein Tabellen-Event reagiert, und eine geplante Edge Function für Erinnerungen, die nicht an eine einzelne Zeilenänderung gebunden sind.

Die Edge Function erstellen

Erzeuge eine neue Function mit der Supabase CLI:

supabase functions new send-whatsapp

Das legt supabase/functions/send-whatsapp/index.ts an. Schreibe sie so, dass sie eine Telefonnummer und einen Text annimmt und dann den TextMeFlow-Messages-Endpunkt aufruft:

import "jsr:@supabase/functions-js/edge-runtime.d.ts"

const API_KEY = Deno.env.get("TEXTMEFLOW_API_KEY")!

Deno.serve(async (req) => {
  const { to, text } = await req.json()

  if (!to || !text) {
    return new Response(JSON.stringify({ error: "to and text are required" }), {
      status: 400,
    })
  }

  const res = await fetch("https://api.textmeflow.eu/v1/messages", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ to, text }),
  })

  const body = await res.json()
  return new Response(JSON.stringify(body), { status: res.status })
})

Speichere den API-Schlüssel als Function-Secret, statt ihn hart zu codieren, und deploye:

supabase secrets set TEXTMEFLOW_API_KEY=tmf_your_api_key_here
supabase functions deploy send-whatsapp

Jedes TextMeFlow-Konto bekommt bei der Anmeldung einen tmf_-Schlüssel, und diese Function behandelt ihn wie ein Secret — genau wie du ein Datenbank-Passwort behandeln würdest: niemals im clientseitigen Code, niemals in einer Migrationsdatei.

Über einen Datenbank-Webhook auslösen

Die Datenbank-Webhooks von Supabase (unter Database → Webhooks im Dashboard, oder per supabase_functions-Trigger in SQL) senden eine HTTP-Anfrage, sobald eine Zeile in einer von dir gewählten Tabelle eingefügt, aktualisiert oder gelöscht wird. Richte einen davon auf deine Edge Function, und du bekommst bei jeder Datenänderung eine WhatsApp-Nachricht, ohne irgendwo eine Polling-Schleife.

Angenommen, du hast eine orders-Tabelle und willst eine WhatsApp-Nachricht, sobald status auf shipped springt. Erstelle den Webhook in SQL:

create trigger notify_order_shipped
after update on orders
for each row
when (old.status is distinct from new.status and new.status = 'shipped')
execute function supabase_functions.http_request(
  'https://<project-ref>.supabase.co/functions/v1/send-whatsapp',
  'POST',
  '{"Content-Type":"application/json"}',
  '{}',
  '1000'
);

Der Trigger übergibt standardmäßig die Zeilendaten als Request-Body, also muss deine Edge Function to und text aus der Supabase-Webhook-Payload-Form herauslesen (record.customer_phone, record.status usw.) statt aus einem flachen {to, text}-Objekt — passe die Function so an, dass sie den Nachrichtentext aus den relevanten Spalten zusammensetzt, und rufe dann die TextMeFlow API genauso auf. Dieses Muster funktioniert für alles Transaktionale: eine Anmeldebestätigung, ein geschlossenes Support-Ticket, eine Zahlungszeile, die in einer payments-Tabelle landet, synchronisiert aus Stripe oder Mollie — siehe WhatsApp-Bestätigungen aus Stripe-Webhooks senden, falls Supabase nur deine Datenschicht ist und Stripe die eigentliche Auslöserquelle.

Geplante Erinnerungen mit pg_cron

Nicht jede Nachricht hängt an einer einzelnen Zeilenänderung — eine Erinnerung "dein Termin ist morgen" muss zeitgesteuert ausgelöst werden, nicht durch ein Update. Supabase unterstützt pg_cron als Postgres-Erweiterung, mit der du deine Edge Function nach Zeitplan aufrufen kannst:

select cron.schedule(
  'appointment-reminders',
  '0 9 * * *',
  $$
  select
    net.http_post(
      url := 'https://<project-ref>.supabase.co/functions/v1/send-whatsapp',
      headers := '{"Content-Type":"application/json"}'::jsonb,
      body := jsonb_build_object('to', phone, 'text', 'Reminder: your appointment is tomorrow at ' || appt_time)
    )
  from appointments
  where appt_date = current_date + 1;
  $$
);

Das läuft täglich um 09:00 UTC, sucht jeden Termin für den nächsten Tag und sendet pro Zeile eine WhatsApp-Nachricht über http_post von pg_net. Es ist derselbe Mechanismus, den mehrere gehostete Automatisierungstools unter der Haube verwenden — nur läuft er hier in deiner eigenen Datenbank statt bei einem externen Scheduler, was praktisch ist, wenn du für etwas so Einfaches keine zusätzliche externe Abhängigkeit einbauen willst.

Die Antwort verarbeiten, nicht blind feuern

Ein 202 Accepted mit einer message_id und status: "queued" bedeutet, dass TextMeFlow den Auftrag angenommen hat — nicht, dass WhatsApp bereits zugestellt hat. Willst du eine Zustellbestätigung, schreib die message_id in eine whatsapp_messages-Tabelle zurück und lass deinen eingehenden Webhook-Handler die Zeile aktualisieren, sobald der Status-Webhook eintrifft — so taucht ein fehlgeschlagener oder nicht zugestellter Versand in einer Abfrage auf, statt stillschweigend in einem Function-Log zu verschwinden, das du nie wieder öffnest.

Datenbank-Webhooks wiederholen Versuche auch bei einer Nicht-2xx-Antwort, also stelle sicher, dass deine Edge Function den tatsächlichen Statuscode der TextMeFlow API zurückgibt, statt immer 200 zu liefern — sonst sieht ein echter Fehler (falsches Telefonformat, getrennte Sitzung, Rate Limit) für Supabase wie ein Erfolg aus und wird nie wiederholt oder sichtbar.

Warum nicht einfach die API vom Frontend aus aufrufen

Es ist verlockend, die Edge Function zu überspringen und TextMeFlow direkt von einem clientseitigen Insert in Supabase aus aufzurufen, aber damit landet dein API-Schlüssel im Browser-Bundle, wo ihn jeder auslesen und Nachrichten auf dein Kontingent senden kann. Über eine Edge Function bleibt der Schlüssel serverseitig, du kannst validieren und die Rate begrenzen, bevor der Aufruf hinausgeht, und hast eine Stelle, um Logging hinzuzufügen, falls ein bestimmter Trigger öfter auslöst als erwartet.

Jetzt kostenlos anmelden, um einen API-Schlüssel zu bekommen und das an deinem eigenen Supabase-Projekt zu testen — 50 Nachrichten pro Monat kosten nichts, während du die Trigger-Verkabelung zum Laufen bringst.

Selbst WhatsApp-Nachrichten per API senden?

Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.

Für immer gratis