· 5 min · TextMeFlow Team

Envoyer des WhatsApp depuis Firebase Cloud Functions

Si votre application tourne sur Firebase, les données censées déclencher un message WhatsApp — une nouvelle commande, un changement de statut, une réservation — vivent déjà dans Firestore. Plutôt que d'interroger ces données depuis un script externe, une Cloud Function peut réagir directement à l'écriture et appeler l'API TextMeFlow dans le même mouvement. Pas de backend séparé, pas de tâche cron qui vérifie toutes les quelques minutes si quelque chose a changé.

Cet article couvre les deux déclencheurs que vous utiliserez réellement : une fonction onDocumentWritten sur Firestore pour tout ce qui est lié à un seul document, et une fonction planifiée pour les rappels qui se déclenchent selon l'horloge plutôt que selon une modification.

Stockez la clé API comme secret, pas comme variable d'environnement

Cloud Functions (2e génération) prend en charge Secret Manager nativement, et c'est là qu'une clé API tmf_ doit se trouver — jamais dans .env, jamais commitée à côté de firebase.json. Créez-la une fois :

firebase functions:secrets:set TEXTMEFLOW_API_KEY

Il vous sera demandé de coller la valeur, et Firebase la stocke dans Google Secret Manager plutôt que dans le code ou la configuration de votre fonction.

Réagir à une écriture Firestore

Supposons que vous ayez une collection orders, et que vous souhaitiez un message WhatsApp au moment où le champ status d'un document passe à shipped. Avec le SDK Firebase Functions v2 :

const { onDocumentUpdated } = require("firebase-functions/v2/firestore");
const { defineSecret } = require("firebase-functions/params");

const textmeflowKey = defineSecret("TEXTMEFLOW_API_KEY");

exports.notifyOrderShipped = onDocumentUpdated(
  { document: "orders/{orderId}", secrets: [textmeflowKey] },
  async (event) => {
    const before = event.data.before.data();
    const after = event.data.after.data();

    if (before.status === after.status || after.status !== "shipped") {
      return;
    }

    const res = await fetch("https://api.textmeflow.eu/v1/messages", {
      method: "POST",
      headers: {
        Authorization: `Bearer ${textmeflowKey.value()}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        to: after.customerPhone,
        text: `Votre commande #${after.orderNumber} a été expédiée et est en route.`,
      }),
    });

    if (!res.ok) {
      const body = await res.text();
      throw new Error(`Envoi TextMeFlow échoué : ${res.status} ${body}`);
    }
  }
);

La vérification before.status === after.status compte plus qu'il n'y paraît : un déclencheur Firestore se déclenche aussi sur des écritures qui ne touchent qu'un champ sans rapport du même document, et sans cette vérification, vous enverriez un message en double chaque fois que quelqu'un modifie l'adresse de livraison après l'expédition.

Lever une erreur sur une réponse non-2xx est également délibéré. Cloud Functions relance une invocation échouée (si vous activez les retries sur le déclencheur), donc faire remonter l'erreur réelle — un format de téléphone invalide, une session déconnectée, un 429 dû à une limite de débit — laisse la logique de retry propre à Firebase faire le travail, plutôt que de laisser le message disparaître silencieusement dans un journal de fonction que personne n'ouvre avant qu'un client ne se plaigne.

Rappels planifiés avec Cloud Scheduler

Tous les messages ne correspondent pas à une modification de document unique. Un rappel du type « votre rendez-vous est demain » doit se déclencher selon l'horloge, pas selon une écriture. onSchedule encapsule Cloud Scheduler précisément pour ce cas :

const { onSchedule } = require("firebase-functions/v2/scheduler");
const { getFirestore } = require("firebase-admin/firestore");

exports.appointmentReminders = onSchedule(
  { schedule: "0 9 * * *", secrets: [textmeflowKey] },
  async () => {
    const db = getFirestore();
    const tomorrow = new Date();
    tomorrow.setDate(tomorrow.getDate() + 1);
    const dateStr = tomorrow.toISOString().slice(0, 10);

    const snapshot = await db
      .collection("appointments")
      .where("date", "==", dateStr)
      .get();

    await Promise.all(
      snapshot.docs.map((doc) => {
        const appt = doc.data();
        return fetch("https://api.textmeflow.eu/v1/messages", {
          method: "POST",
          headers: {
            Authorization: `Bearer ${textmeflowKey.value()}`,
            "Content-Type": "application/json",
          },
          body: JSON.stringify({
            to: appt.phone,
            text: `Rappel : votre rendez-vous est demain à ${appt.time}.`,
          }),
        });
      })
    );
  }
);

Cette fonction s'exécute chaque jour à 09h00 dans le fuseau horaire configuré, recherche chaque rendez-vous prévu pour le lendemain, et envoie un message WhatsApp par document. C'est un cousin proche du schéma décrit dans envoyer des confirmations WhatsApp depuis les webhooks Stripe — une source de déclenchement qui n'est pas un appel API direct, mais qui alimente finalement le même appel /v1/messages.

Éviter les doublons lors d'invocations relancées

Une fonction planifiée ou un déclencheur Firestore relancé peut s'exécuter deux fois pour le même événement logique — Cloud Functions garantit une livraison « au moins une fois », pas « exactement une fois ». Si un rappel WhatsApp en double gênerait plus un client qu'un rappel manqué, écrivez un marqueur dans Firestore avant ou après l'envoi (remindedAt: new Date() sur le document du rendez-vous) et vérifiez-le en début de fonction. Cela transforme une relance en no-op plutôt qu'en un second message qui atterrit dans la même conversation dix secondes plus tard.

Traitez la réponse comme une file d'attente, pas une garantie de livraison

Un 202 Accepted accompagné d'un message_id signifie que TextMeFlow a mis la tâche en file d'attente — pas que WhatsApp l'a livrée. En réécrivant ce message_id sur le document Firestore (whatsappMessageId: body.message_id), votre gestionnaire de webhooks entrants peut mettre à jour ce même document dès que l'événement de statut de livraison arrive, afin qu'un envoi échoué apparaisse comme un champ interrogeable plutôt que de disparaître une fois la fonction terminée.

Inscrivez-vous au plan gratuit pour obtenir une clé API et brancher ceci dans votre propre projet Firebase — 50 messages par mois ne coûtent rien pendant que vous réglez la logique de déclenchement avant d'envoyer de vrais volumes.

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