← ClaudeAtlas

sending-whatsapplisted

Sends WhatsApp messages via the Sendly API — connect a number, check senders and 24-hour windows, send free-form or template messages, and manage Meta-reviewed templates. Applies when messaging customers on WhatsApp, building WhatsApp notifications or OTP delivery, or deciding between free-form and template sends.
SendlyHQ/sendly-skills · ★ 0 · AI & Automation · score 62
Install: claude install-skill SendlyHQ/sendly-skills
# WhatsApp Messaging with Sendly WhatsApp is a first-class Sendly channel: connect a number you own, then send through the same Messages endpoint as SMS with `channel: "whatsapp"`. > **Not yet generally available.** WhatsApp is gated behind the `whatsapp_channel` rollout flag. Until it is enabled for your account, `/api/v1/whatsapp/*` endpoints return `not_found` (404) and WhatsApp sends via `/api/v1/messages` return `403 whatsapp_not_enabled`. Ask Sendly to enable it before relying on these endpoints. WhatsApp always requires a **live** API key — test keys get `403 whatsapp_requires_live_key` (delivery is never sandbox-simulated on this channel). ## The two rules that shape everything 1. **Connecting a number needs a human.** The signup returns a `connectUrl` that a person must open in a browser and log in with **Facebook** to link their WhatsApp Business Account. You (the agent) cannot complete this step programmatically — hand the URL to the account owner, then poll until the status is `active`. 2. **The 24-hour window decides what you can send.** Free-form text and media only deliver while a customer-service window is open (it opens, and resets to 24 hours, each time the recipient messages your number). Outside a window, only a Meta-**approved template** delivers. ## Quick start ```typescript import Sendly from "@sendly/node"; const sendly = new Sendly(process.env.SENDLY_API_KEY!); const { senders } = await sendly.whatsapp.senders.list(); const from = senders.find