From aac29f5b424065fdb705e7ddfaadb33c6ae2f499 Mon Sep 17 00:00:00 2001
From: Maximilian Kaske <maximilian@kaske.org>
Date: Fri, 2 Oct 2026 15:29:43 +0200
Subject: [PATCH] fix: whatsapp notification test

---
 apps/dashboard/.env.example                   |  3 +++
 .../forms/notifications/form-whatsapp.tsx     | 25 +++++++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/apps/dashboard/.env.example b/apps/dashboard/.env.example
index 5e45d7c4..c3ffe074 100644
--- a/apps/dashboard/.env.example
+++ b/apps/dashboard/.env.example
@@ -73,6 +73,9 @@ WORKOS_WEBHOOK_SECRET=
 
 PAGERDUTY_APP_ID=
 
+# WhatsApp sender number shown in the notification form hint (e.g. +1 754 255 8482)
+NEXT_PUBLIC_WHATSAPP_PHONE_NUMBER=
+
 SLACK_SUPPORT_WEBHOOK_URL=
 
 WORKSPACES_HIDE_URL=
diff --git a/apps/dashboard/src/components/forms/notifications/form-whatsapp.tsx b/apps/dashboard/src/components/forms/notifications/form-whatsapp.tsx
index 19c713cb..4a2d3f62 100644
--- a/apps/dashboard/src/components/forms/notifications/form-whatsapp.tsx
+++ b/apps/dashboard/src/components/forms/notifications/form-whatsapp.tsx
@@ -15,6 +15,7 @@ import { Input } from "@openstatus/ui/components/ui/input";
 import { cn } from "@openstatus/ui/lib/utils";
 import { useMutation } from "@tanstack/react-query";
 import { isTRPCClientError } from "@trpc/client";
+import Link from "next/link";
 import React, { useTransition } from "react";
 import { useForm } from "react-hook-form";
 import { toast } from "sonner";
@@ -48,6 +49,8 @@ export function FormWhatsApp({
   onSubmit: (values: FormValues) => Promise<void>;
   monitors: { id: number; name: string }[];
 }) {
+  // Sender number shown in the anti-spam hint; unset on self-hosted installs.
+  const senderPhoneNumber = process.env.NEXT_PUBLIC_WHATSAPP_PHONE_NUMBER;
   const form = useForm<FormValues>({
     resolver: zodResolver(schema),
     defaultValues: defaultValues ?? {
@@ -165,6 +168,28 @@ export function FormWhatsApp({
                 <FormMessage />
                 <FormDescription>
                   Enter the phone number to send notifications to.
+                  {senderPhoneNumber ? (
+                    <>
+                      {" "}
+                      Not receiving messages? Send a message to our number{" "}
+                      <Link
+                        href={`https://wa.me/${senderPhoneNumber.replace(/\D/g, "")}`}
+                        rel="noreferrer"
+                        target="_blank"
+                      >
+                        {senderPhoneNumber}
+                      </Link>{" "}
+                      first so WhatsApp knows it&apos;s not spam.{" "}
+                      <Link
+                        href="https://www.openstatus.dev/docs/reference/notification/#whatsapp"
+                        rel="noreferrer"
+                        target="_blank"
+                      >
+                        Read more
+                      </Link>
+                      .
+                    </>
+                  ) : null}
                 </FormDescription>
               </FormItem>
             )}
-- 
2.51.2