WhatsApp-meldingen versturen vanuit Monday.com met webhooks

Monday.com stuurt zelf geen WhatsApp-berichten, maar het heeft wel een ingebouwde webhook-integratie die bij vrijwel elke boardwijziging een HTTP-request kan afvuren. Combineer dat met de TextMeFlow API en je stuurt binnen enkele minuten een WhatsApp-melding naar een klant of collega zodra een item van status verandert, een deadline nadert of er een nieuwe rij wordt toegevoegd.

Dit artikel toont de kortste weg: Monday.com → een kleine webhook-ontvanger → de TextMeFlow API. Geen Zapier of Make nodig, al kan je die tools gebruiken als je geen eigen endpoint wil bouwen.

Hoe de Monday.com-webhook werkt

Monday.com biedt "Integrations" aan op boardniveau. Via de automatiserings-bouwer kies je een trigger (bijvoorbeeld "status wijzigt naar Klaar" of "item wordt aangemaakt") en als actie "Send a webhook". Je geeft daar één URL op — die van jouw ontvanger — en Monday.com post daar bij elke matching wijziging een JSON-payload naartoe met het board-ID, item-ID, kolomwaarden en de nieuwe status.

Belangrijk detail: Monday.com stuurt bij het aanmaken van de webhook eerst een challenge-verificatieverzoek. Je endpoint moet die challenge-waarde ongewijzigd teruggeven in de response, anders wordt de webhook niet geactiveerd.

// routes/api.php (Laravel)
Route::post('/webhooks/monday', function (Illuminate\Http\Request $request) {
    if ($request->has('challenge')) {
        return response()->json(['challenge' => $request->input('challenge')]);
    }

    $event = $request->input('event');
    // ... verwerk de statuswijziging, zie onder

    return response()->json(['ok' => true]);
});

Van Monday.com-event naar WhatsApp-bericht

Zodra de challenge is afgehandeld, bevat elke volgende call een event-object met onder meer pulseId (het item), columnId, value (nieuwe waarde) en previousValue. Haal uit je eigen database het telefoonnummer op dat bij dat item hoort — meestal gekoppeld via een customfield of een losse mapping-tabel — en stuur dat door naar de TextMeFlow API:

$phone = Item::where('monday_item_id', $event['pulseId'])->value('whatsapp_number');

if ($phone) {
    Http::withToken(config('services.textmeflow.api_key'))
        ->post('https://textmeflow.eu/api/v1/messages', [
            'to' => $phone,
            'type' => 'text',
            'text' => "Statusupdate: item #{$event['pulseId']} staat nu op \"{$event['value']['label']['text']}\".",
        ]);
}

Gebruik je liever geen eigen backend, dan kan je dezelfde twee stappen (verificatie + forward) ook in n8n of Make bouwen — zie onze gids over WhatsApp-berichten versturen vanuit n8n, Make.com of Zapier voor de opzet van zo'n flow.

Beveilig je endpoint

Monday.com-webhooks zelf zijn niet ondertekend, maar de TextMeFlow-kant van je integratie wel: elke inkomende statusmelding die TextMeFlow terugstuurt (bijvoorbeeld "bezorgd" of "gefaald") komt met een HMAC-signature in de header. Verifieer die altijd voor je de payload verwerkt — de volledige uitleg staat in Verifying WhatsApp webhook signatures en in de webhooks-documentatie. Voor je eigen Monday.com-ontvanger geldt hetzelfde advies: zet er minstens een geheime query-parameter of IP-allowlist op, zodat niet elke willekeurige POST je flow kan triggeren.

Praktische toepassingen

Een paar voorbeelden die goed werken met deze opzet:

• Projectopvolging: klant krijgt een WhatsApp-bericht zodra een item naar "Review" of "Klaar" verschuift.
• Interne escalatie: stuur een bericht naar een teamlid wanneer een item langer dan X dagen op "In behandeling" blijft staan (te combineren met Monday.com's eigen tijd-gebaseerde triggers).
• Deadline-herinneringen: koppel de datumkolom aan een geplande herinnering, een dag voor de deadline.

Houd bij elk van deze toepassingen rekening met de anti-spam-regels: rate limits, een risicoscore per nummer en automatische STOP-verwerking zorgen ervoor dat je WhatsApp-nummer niet overbelast raakt, ook niet als een board plots tien statuswijzigingen per minuut doorstuurt.

Starten

Je hebt enkel een TextMeFlow API-key nodig om deze koppeling te bouwen. Het gratis plan geeft je 50 berichten per maand om de integratie te testen voor je overstapt naar een betaald plan.

Begin gratis met testen