Latest · v1.11.0

Changelog
every release, in full.

12 releases and 37 notes, generated straight from the package changelogs — so what you read here is exactly what shipped to npm. All @msgly/* packages version in lockstep, so one version number describes the whole library.

Upgrading from 1.5.0 or earlier? Read this first.

Nothing was removed and no call signature changed, so existing code keeps working. One item is time-critical: @msgly/whatsapp, @msgly/instagram and @msgly/messenger defaulted to Meta Graph API v20.0, which Meta retires on 24 September 2026. Upgrading the packages is the whole fix — unless you pinned apiVersion yourself, in which case your explicit value still wins and must be raised. Full migration guide →

12 releases
  1. v1.12.0

    Next release · unpublished8 packages
    Minor

    Close the parity gaps left by 1.10 and 1.11: setup-time number checks on the rest of the phone channels, and a chat link for Dial.

    verifyPhoneNumber() on six more adapters. 1.10 added it to Twilio SMS, Twilio Voice, Genesys SMS, Genesys Voice and Dial, which left every other number-carrying channel checking only that its sender field was non-empty. All six now behave the same way: a local E.164 gate that names the specific mistake ("missing the leading +", "strip spaces, dashes"), then a provider lookup answering the question a format check cannot — is this number actually on this account? verifyCredentials() calls it, so the normal setup flow gets the check for free and reports which field is wrong.

    • Plivo — GET /v1/Account/{auth_id}/Number/
    • Plivo Voice — the same resource
    • Vonage SMS — GET /account/numbers
    • Telnyx — GET /v2/phone_numbers?filter[phone_number]=…
    • Exotel Voice — GET /v1/Accounts/{sid}/IncomingPhoneNumbers.json
    • Vonage Voice — format only, see below

    Plivo and Vonage return their numbers without a leading +, so the comparison is on digits. @msgly/core gains phoneDigits, sameNumber and isAlphanumericSenderId for this, next to the existing isValidE164 and describeE164Problem.

    An alphanumeric sender ID is inconclusive, not malformed. Plivo, Vonage and Telnyx all accept either a number or a registered sender id in the same field. A sender id is registered with the destination carrier rather than rented on the account, so there is nothing to look it up against — and running the E.164 gate on one would reject a working configuration. It reports ok: true with a hint noting that recipients cannot reply and that several countries reject it outright.

    Vonage Voice is a format check only, deliberately. Vonage rents numbers at the account level and the only endpoint that lists them authenticates with the api_key/api_secret pair @msgly/vonage-sms takes; a Voice application JWT cannot read it, and VonageVoiceConfig has no reason to carry account credentials just for a setup check. A well-formed number reports inconclusive rather than owned — the mistakes people actually hit are caught, and the ownership question is reported as unanswered rather than guessed at. Vonage Voice also takes its number without a leading +, unlike every other adapter here; the gate accepts either form and names the one Vonage wants.

    Unanswerable lookups still fail open, as in 1.10: a key without permission to list numbers, or an unexpected response, reports ok: true with inconclusive. Only a definite not_owned or malformed fails. Exotel Voice's endpoint is modeled, not fetched — Exotel's v1 API is shaped like Twilio's, and several envelopes are accepted — which is exactly why it fails open.

    Note that verifyCredentials() on these six adapters now fails when the sender is wrong, where before it only checked the credentials. Two existing test fixtures had to gain a number for this reason: an empty number list now legitimately means "that number is not on this account".

    @msgly/dial gains getChatLink(). 1.11 shipped chat links for every channel that has one and listed the omissions, but Dial fell through: it was grouped with neither the SMS rails that got sms: links nor the senders that cannot receive a reply. A Dial line is a real provisioned number, so it gets the same sms:<number> link, with text prefilled and tracked: false. One link covers the line however it is provisioned — the system messaging app picks between SMS/MMS and iMessage itself. It returns null when fromNumber is a phone-number id or a nickname, since neither is something a scanner can dial.

    @msgly/core@msgly/dial@msgly/exotel-voice@msgly/plivo@msgly/plivo-voice@msgly/telnyx@msgly/vonage-sms@msgly/vonage-voice

  2. v1.11.0

    Unreleased42 packages
    Minor

    Chat links — the URL behind a "scan to message us" QR code, for every channel that has one.

    Minor

    Carry the sender's profile photo on inbound messages.

  3. v1.10.0

    Unreleased42 packages
    Minor

    Verify the configured phone number at setup time, not at first send.

  4. v1.9.0

    Unreleased42 packages
    Minor

    Add @msgly/genesys-sms and @msgly/genesys-voice — Genesys Cloud CX contact-center messaging and telephony, as a channel-split pair mirroring @msgly/twilio-sms/@msgly/twilio-voice.

  5. v1.8.0

    Unreleased40 packages
    Minor

    Add two push channels, so push is a complete story rather than one provider.

    Minor

    Add Dial — agent-provisioned numbers, with SMS, MMS and iMessage on one line.

    Minor

    Add Mailgun, Postmark and Exotel Voice.

    Minor

    Add Expo push and RCS Business Messaging, and a card content type in core.

    Minor

    Add Plivo Voice and Vonage Voice, taking voice from one provider to three.

    Minor

    Fix WhatsApp send-failure handling, which retried failures that could never succeed and could not tell a dead number from a throttle.

  6. v1.7.0

    Unreleased29 packages
    Patch

    @msgly/core@1.7.0

    Minor

    Fix the Twilio Voice response model, which could not work as designed, and close the gaps between what the adapter claimed and what it did.

  7. v1.6.0

    Unreleased30 packages
    Minor

    Bring the Meta adapters back into API support, and make reactions, typing and message threading real across every channel that has them.

    Minor

    Add WhatsApp Coexistence support — the WhatsApp Business app and the Cloud API live on the same number, with staff answering from the handset while the API automates alongside them.

  8. v1.5.0

    Unreleased30 packages
    Minor

    Add @msgly/tiktok — video and photo publishing, comment replies and direct messages.

  9. v1.4.0

    Unreleased29 packages
    Minor

    Add @msgly/reddit — subreddit publishing, thread replies and inbox polling.

  10. v1.3.0

    Unreleased28 packages
    Minor

    Add native broadcast and feed publishing.

    Patch

    Documentation catch-up.

    Patch

    Cover the outbound path on the three thinnest-tested adapters.

  11. v1.2.0

    Unreleased28 packages
    Minor

    Add @msgly/ses and @msgly/fcm.

  12. v1.1.0

    Unreleased26 packages
    Minor

    Add @msgly/exotel — SMS for the Indian market.

    Minor

    Add attachment support and paced campaign sending.

    Minor

    Add List-Unsubscribe support to the Gmail and Outlook adapters, completing the set — all five email adapters now emit one-click unsubscribe headers via an unsubscribe config, overridable per message.

    Minor

    Add @msgly/rocketchat and @msgly/googlechat.

    Patch

    Fill in genuine media gaps in the Teams and LINE adapters.

    Minor

    Add @msgly/viber and @msgly/mattermost.

    Minor

    Add @msgly/msg91 — India SMS via MSG91's DLT Flow API.

    Minor

    Add @msgly/plivo and @msgly/resend.

    Minor

    Suppress recipients automatically on hard bounces and spam complaints.

    Minor

    Add opt-out handling to campaigns.

    Minor

    Add @msgly/telnyx and @msgly/sendgrid.

    Patch

    Add the missing root ESLint configuration.

    Minor

    Add @msgly/smtp — an SMTP + IMAP adapter covering Yahoo, Zoho, Fastmail, iCloud, AOL, and any custom mail server.

    Minor

    Add @msgly/vonage-sms — global SMS via Vonage (Nexmo).

    Patch

    Harden WeChat webhook signature verification.

    Patch

    Repository and packaging fixes.