When a CV gets shortlisted, WhatsApp fires in 2 seconds.

Try it — step by step

Create a login, shortlist a candidate, and watch WhatsApp fire in real time. The player below walks the whole process; do it yourself on the live app.

► Watch the full video walkthrough →

Every screen, step by step

The full flow, screen by screen — exactly what you'll do on wcapp.fcits.ae. The complete video walkthrough lives on the WhatsApp services page.

How it works

The four key files

The core send function

// lib/whatsapp.js
const URL = `https://graph.facebook.com/v23.0/${PHONE_ID}/messages`;

async function sendTemplateMessage(to, templateName, languageCode, bodyParams = []) {
  const payload = {
    messaging_product: 'whatsapp',
    to,
    type: 'template',
    template: {
      name: templateName,
      language: { code: languageCode },
      components: [{
        type: 'body',
        parameters: bodyParams.map(t => ({ type: 'text', text: String(t) }))
      }]
    }
  };
  const res = await fetch(URL, {
    method: 'POST',
    headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
    body: JSON.stringify(payload)
  });
  return res.json();
}

The action trigger

// api/cv-selected.js  — fires when "Select CV" is clicked
module.exports = async function handler(req, res) {
  if (req.headers['x-api-secret'] !== process.env.API_SHARED_SECRET)
    return res.status(401).json({ error: 'Unauthorized' });

  const { candidateName, candidateRole, candidatePhone, jobTitle, recruiterName } = req.body;

  // 1) Ping the recruiter
  await sendTemplateMessage(
    process.env.RECRUITER_WHATSAPP_NUMBER,
    'cv_selected_alert', 'en',
    [recruiterName, candidateName, candidateRole, jobTitle]
  );

  // 2) Optionally notify the candidate
  if (candidatePhone) {
    await sendTemplateMessage(
      candidatePhone, 'candidate_shortlisted', 'en',
      [candidateName, jobTitle]
    );
  }
  res.status(200).json({ ok: true });
};

The approved template body

Hi {{1}}, a new CV was just shortlisted on azizsaif.com/ai.

👤 Candidate: {{2}}
💼 Role: {{3}}
📌 Position: {{4}}

Open the dashboard to review the full profile.

Submit this in Meta Business → WhatsApp Manager → Message Templates under category UTILITY. Approval typically takes under 5 minutes.

Setup in 15 minutes

1. Create a Business app at developers.facebook.com and add the WhatsApp product.
2. Copy the Phone Number ID, Business Account ID, and a temporary token from API Setup.
3. In Business Settings → System Users, generate a permanent token with whatsapp_business_management + whatsapp_business_messaging.
4. Create the two templates (cv_selected_alert, candidate_shortlisted) and wait for approval.
5. Set the webhook callback to https://azizsaif.com/api/webhook with your verify token, subscribe to messages.
6. Deploy to Vercel — vercel --prod — and add all env vars.

The code

The complete source — Node.js, Express, front-end, templates, Meta setup guide — lives in this repo:

• GitHub: ai-cv-whatsapp-trigger
• Full README with deploy steps
• api/cv-selected.js — the trigger
• lib/whatsapp.js — the Graph API client

Where this fits in the recruitment stack

• CV intake — candidates upload via cvfast or the recruiter dashboard.
• Shortlist — recruiter clicks Select CV → this trigger fires.
• Engage — WhatsApp template lands in the candidate's phone within seconds.
• Convert — replies route back through /api/webhook into Supabase / Asana for follow-up.