SpeckyDocs

WhatsApp Integration

What it does

Let customers message your WhatsApp Business number for feedback and booking.

How your data reaches Specky

WhatsApp has no history endpoint Specky can query, so data arrives only by webhook — WhatsApp tells Specky the moment something happens. That has one consequence worth reading twice:

Nothing that happened before you set the webhook up is recoverable. There is no backfill and no Sync button, because there would be nothing for it to fetch. Set the webhook up first, then generate the activity you care about.

What you'll need

  • Access Token (Required) — Permanent access token from your Meta WhatsApp Business app.
  • Phone Number ID (Required) — Found in Meta App Dashboard → WhatsApp → API Setup.
  • App Secret (Required) — From App Dashboard → Settings → Basic. Required to verify inbound webhook calls really came from Meta — without it, anyone who learns your Phone Number ID could inject fake messages.

    • Setup

    Go to Settings → Integrations, find WhatsApp, and click Connect.

    Prerequisites

    Requires a Meta Business account with the WhatsApp Business Platform (Cloud API) set up — see developers.facebook.com/docs/whatsapp/cloud-api/get-started.

    How to connect

  • In your Meta App Dashboard, go to WhatsApp → API Setup
  • Generate a permanent access token (System User token recommended over the 24h temporary one)
  • Copy the Phone Number ID shown on the same page
  • In WhatsApp → Configuration, set the webhook URL to https://specky.space/api/integrations/whatsapp/webhook and the verify token to the value your admin configured for Specky, then subscribe to the messages field
  • Copy the App Secret from Settings → Basic — required so the webhook can verify inbound calls really came from Meta

    • What Specky does with your credentials

  • Ingests inbound messages to your WhatsApp Business number as feedback signals in real time
  • Auto-replies: book/schedule sends your booking link, anything else gets a thank-you and is logged as feedback
  • Can post stakeholder updates within Meta's 24-hour customer-service window (WhatsApp blocks free-form outbound messages outside that window unless using a pre-approved template)

    • Data synced

    DataUsed for

    Inbound customer messagesDirect customer feedback, support requests, booking requests

    After connecting

    Everything Specky pulls in from WhatsApp shows up in Discovery alongside your other sources, and feeds synthesis, clustering, and the AI chat's answers about your product. You don't have to do anything with it directly — it's there so the rest of Specky has something to reason over.

    Disconnecting WhatsApp removes both the connection and the signals it brought in.

    Troubleshooting

  • Connected, but nothing appears. Check the webhook on the WhatsApp side: that it points at the URL in the setup steps above, and that it's subscribed to the right events. Nothing reaches Specky without it.
  • "Upgrade to connect". Your plan caps how many integrations you can connect at once, and a few providers are Scale-only. Settings → Usage shows where you stand.
  • Credentials stopped working. Tokens expire and get revoked. Reconnect with a fresh one — your existing signals are kept.

    • See the WhatsApp integration page for what it's for and the questions people usually ask first, or the Integrations Overview for how integrations work in general.