WhatsApp

Send your posts as scheduled WhatsApp broadcasts to the people who agreed to hear from you, and answer their replies in the ShortSync inbox.

WhatsApp is in beta. It uses Meta's official WhatsApp Business Platform (the Cloud API). WhatsApp has no API for Status or Channels, so a WhatsApp post is a message sent to each of your opted-in contacts, not a public post.

Requirements

  • Account: A WhatsApp Business account on Meta's WhatsApp Business Platform (you can create one while connecting), in a Meta business portfolio, with a payment method added in WhatsApp Manager
  • Number: A phone number that isn't on WhatsApp yet, or the number of your WhatsApp Business app (you keep using the app on it)
  • Content: Video posts (MP4 up to 16 MB; bigger files are compressed to fit), image posts (JPEG or PNG up to 5 MB) and text posts. No carousels.
  • Text: Your caption fills the template's {{1}} on one line. Together with the template's own text it can be up to 1,024 characters.
  • Cost: Meta bills your WhatsApp Business account for each message it delivers. ShortSync doesn't add a per-message fee.
  • Daily limits: ShortSync allows 5 WhatsApp broadcasts per workspace per day. Meta also limits how many people your number can message a day, and raises it as you send good-quality messages.

Connect WhatsApp

  1. In ShortSync, go to Connections and click WhatsApp.
  2. Choose A new number, or My WhatsApp Business app number to keep chatting in the app on the same number. Then click Continue with Facebook.
  3. Meta opens a window. Sign in to Facebook, pick or create your business portfolio and WhatsApp Business account, and add or pick the phone number. Meta sends a code to the number to verify it.
  4. The window closes and WhatsApp shows as connected with your number. ShortSync never sees your Facebook password, and the access token is stored encrypted (AES-256-GCM).

One number can be connected per workspace. To use another number, disconnect WhatsApp and connect again.

Message templates

WhatsApp only lets businesses start a conversation with a template Meta has approved. Your broadcast sends one template, with the post filled in:

  • The post's video or image becomes the template's header, so make one template with a video header for video posts, one with an image header for image posts, and one without a header for text posts.
  • Your caption goes where the template has {{1}}, for example "New video: {{1}} Watch it now." Meta doesn't allow {{1}} as the very first or last thing in the message. A template without it sends the same text every time.
  • Add an optional footer and one link button, for example to your YouTube channel.
  • Marketing templates automatically get a Stop promotions button. Tapping it opts the contact out of your broadcasts.

Create templates on the WhatsApp page (open it from the WhatsApp settings in the Upload flow). Meta usually reviews a template within minutes, and the status updates by itself. Templates you made in WhatsApp Manager show up there too.

Contacts and consent

WhatsApp requires that people agree to get messages from your business before you send them broadcasts. On the WhatsApp page you can:

  • Add a contact by phone number (with the country code), name and tags.
  • Import a CSV with a phone column and optional name and tags columns (separate several tags with |). Up to 5,000 rows at a time.
  • Both need you to tick "These people agreed to get WhatsApp messages from my business". ShortSync records when and how each contact opted in.

People who opt out (with the Stop promotions button, or by replying STOP) are never sent a broadcast again, even if you import them again. People who message your number first are added as contacts, but they don't get broadcasts until you add them with consent.

Post settings

In the Settings step, the WhatsApp panel has:

  • Message template: the approved templates that fit the post, with a preview of the message.
  • Send to: everyone who opted in, or only contacts with the tags you pick, with the number of people it reaches.
  • Send as text only: send a video post with a template that has no video.

Save settings defaults remembers the template and tags for your next upload.

In the API and through MCP, WhatsApp options go in platform_options.whatsapp: template_id, audience_tags and text_only. Templates and contacts have their own endpoints, /api/v1/whatsapp/templates and /api/v1/whatsapp/contacts, and MCP tools list_whatsapp_templates, create_whatsapp_template, list_whatsapp_contacts and add_whatsapp_contacts.

Sending

  • At the scheduled time ShortSync uploads the media to WhatsApp once and sends the template to each contact, a few at a time so your number stays within Meta's rate limits. A big audience can take a few minutes.
  • The post shows how many messages were sent, delivered, read and failed, and the numbers update as people open them.
  • If your number has reached its daily messaging limit, the messages over it fail. Meta raises the limit as you keep sending messages people want.
  • Sent WhatsApp messages can't be unsent, so deleting a sent broadcast in ShortSync isn't possible. You can still cancel a scheduled one.
  • There's no first comment and no analytics beyond the delivery counts.
  • WhatsApp broadcasts count toward your workspace's daily limit for WhatsApp. See Daily posting limits.

Replies in the inbox

When someone replies to a broadcast or messages your number, the chat shows up in the ShortSync inbox. You can answer with free text (up to 4,096 characters) for 24 hours after their last message; the reply box shows how long is left. After that, WhatsApp only allows templates, so reach them with your next broadcast. Photos, videos and voice notes they send open in the inbox.

Disconnecting

Disconnecting WhatsApp in Connections stops ShortSync from sending and receiving messages on your number and removes its templates from ShortSync. The templates stay in WhatsApp Manager, and your contacts stay in ShortSync so you can reconnect later. To remove ShortSync's access in Meta too, open your business settings and remove ShortSync under Integrations.

Common issues

I don't see my template in the Settings step

Only approved templates whose header fits the post show up: a video header for video posts, an image header for image posts, and no media header for text posts. Click Refresh after Meta approves it.

My template was rejected

The reason from Meta is shown under the template. Common ones: {{1}} at the very start or end, a body that reads as spam, or the wrong category (anything promotional is Marketing). Delete it and create a new one with a different name.

Some messages failed

A number isn't on WhatsApp, the person opted out of marketing messages, your number hit its daily limit, or your WhatsApp account has no payment method. Check your account in WhatsApp Manager and retry the post; contacts who already got it aren't sent it twice.

I can't reply in the inbox

More than 24 hours have passed since their last message, so WhatsApp only allows templates. Send them a broadcast, or wait for them to write again.

WhatsApp says it needs reconnecting

The access was removed in Meta, or the WhatsApp account was disabled. Click WhatsApp in Connections and go through the Meta window again with the same number.