· 6 min · TextMeFlow Team

Envoyer des messages WhatsApp depuis Supabase Edge Functions

Si votre backend repose sur Supabase, vous disposez déjà de Postgres, de l'auth, du stockage et d'un runtime serverless basé sur Deno au même endroit — pas besoin d'un serveur Node séparé juste pour envoyer une notification WhatsApp quand une ligne change. Une Supabase Edge Function peut appeler directement l'API TextMeFlow, et un webhook de base de données peut déclencher cette fonction dès qu'une ligne est insérée ou mise à jour. Aucun polling, aucun cron job qui vérifie "est-ce que quelque chose a changé depuis la dernière fois".

Cet article couvre deux façons de mettre cela en place : un webhook de base de données qui se déclenche sur un événement de table, et une Edge Function planifiée pour les rappels qui ne sont pas liés à un seul changement de ligne.

Créer l'Edge Function

Générez une nouvelle fonction avec le CLI Supabase :

supabase functions new send-whatsapp

Cela crée supabase/functions/send-whatsapp/index.ts. Écrivez-la pour qu'elle accepte un numéro de téléphone et un texte, puis appelle le endpoint messages de TextMeFlow :

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 })
})

Stockez la clé API comme secret de fonction plutôt que de la coder en dur, puis déployez :

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

Chaque compte TextMeFlow reçoit une clé tmf_ à l'inscription, et cette fonction la traite comme un secret, exactement comme vous traiteriez un mot de passe de base de données : jamais dans du code côté client, jamais dans un fichier de migration.

Déclencher depuis un webhook de base de données

Les webhooks de base de données de Supabase (sous Database → Webhooks dans le tableau de bord, ou via un trigger supabase_functions en SQL) envoient une requête HTTP dès qu'une ligne est insérée, mise à jour ou supprimée dans une table de votre choix. Pointez-en un vers votre Edge Function et vous obtenez un message WhatsApp à chaque changement de données, sans boucle de polling nulle part.

Supposons que vous ayez une table orders et que vous vouliez un message WhatsApp dès que status passe à shipped. Créez le webhook en 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'
);

Le trigger transmet les données de la ligne comme corps de requête par défaut, donc votre Edge Function doit extraire to et text de la forme du payload webhook de Supabase (record.customer_phone, record.status, etc.) plutôt que d'un objet plat {to, text} — ajustez la fonction pour construire le texte du message à partir des colonnes pertinentes, puis appelez l'API TextMeFlow de la même façon. Ce schéma fonctionne pour tout ce qui est transactionnel : une confirmation d'inscription, la clôture d'un ticket support, une ligne de paiement qui arrive dans une table payments synchronisée depuis Stripe ou Mollie — voir envoyer des confirmations WhatsApp depuis les webhooks Stripe si Supabase n'est que votre couche de données et que Stripe est la véritable source du déclencheur.

Rappels planifiés avec pg_cron

Tous les messages ne correspondent pas à un seul changement de ligne — un rappel "votre rendez-vous est demain" doit se déclencher sur une base horaire, pas sur une mise à jour. Supabase prend en charge pg_cron comme extension Postgres, que vous pouvez utiliser pour appeler votre Edge Function selon un calendrier :

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;
  $$
);

Ceci s'exécute chaque jour à 09h00 UTC, trouve chaque rendez-vous prévu le lendemain, et envoie un message WhatsApp par ligne via http_post de pg_net. C'est le même mécanisme que plusieurs outils d'automatisation hébergés utilisent en interne, sauf qu'il tourne ici dans votre propre base de données plutôt que chez un planificateur tiers — utile si vous préférez ne pas ajouter une dépendance externe supplémentaire pour quelque chose d'aussi simple.

Traitez la réponse, n'envoyez pas à l'aveugle

Un 202 Accepted avec un message_id et status: "queued" signifie que TextMeFlow a accepté la tâche, pas que WhatsApp l'a déjà livrée. Si vous voulez une confirmation de livraison, réécrivez le message_id dans une table whatsapp_messages et laissez votre gestionnaire de webhook entrant mettre à jour la ligne quand le webhook de statut arrive — ainsi un envoi échoué ou non livré apparaît dans une requête plutôt que de disparaître silencieusement dans un journal de fonction que vous n'ouvrirez jamais.

Les webhooks de base de données font aussi des tentatives de réessai sur une réponse non-2xx, donc assurez-vous que votre Edge Function retourne le vrai code de statut de l'API TextMeFlow plutôt que de toujours renvoyer 200 — sinon une véritable erreur (mauvais format de numéro, session déconnectée, limite de débit) ressemble à un succès pour Supabase et n'est jamais ni réessayée ni remontée.

Pourquoi ne pas simplement appeler l'API depuis votre frontend

Il est tentant de sauter l'Edge Function et d'appeler TextMeFlow directement depuis un insert côté client dans Supabase, mais cela place votre clé API dans le bundle du navigateur, où n'importe qui peut l'extraire et envoyer des messages sur votre quota. Passer par une Edge Function garde la clé côté serveur, vous permet de valider et de limiter le débit avant que l'appel ne parte, et vous donne un seul endroit où ajouter du logging si un déclencheur particulier se met à partir plus souvent que prévu.

Inscrivez-vous au plan gratuit pour obtenir une clé API et tester cela sur votre propre projet Supabase — 50 messages par mois ne coûtent rien pendant que vous réglez le câblage du déclencheur.

Envie d'envoyer des messages WhatsApp via API ?

Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.

Gratuit pour toujours