iMessage

Create a tracked iMessage opt-in link

Changed on

Generates a per-campaign link that opens Messages on this sender with body prefilled.

Why use it

A thread the contact opens skips the pacing and the first-message content rule that apply when the sender writes first.

It is also the only way in for senders without the add-on for new contacts. Their sends to anyone else fail with recipient_must_message_first.

Attribution

Each link carries a unique code in place of the [opt-in-code] placeholder. When the contact sends it, the resulting message.received webhook (and the stored inbox message's metadata) has optIn: true and your parameters under optInParameters.

That lets you attribute the conversation to the campaign or lead that produced it.

For an untracked link, use the sender's optInLink instead.

post/v1/imessage/senders/{senderId}/opt-in-links

Request

  • Base URL
    https://zernio.com/api
  • Auth
    HTTP bearer

Path parameters

senderIdstring required

Request body

bodystring required

Prefilled message text. Must contain the literal [opt-in-code] placeholder, e.g. "Hi! My code is [opt-in-code]".

parametersobject

Custom key/values (e.g. leadId, campaign) echoed back on the opt-in message.

optInCodestring

Your own code in place of the generated one (3-8 characters, no spaces or #, !, -). An unredeemed link lives 24 hours; re-issuing with the same code replaces it, and the earlier URL stops matching.

Response

Opt-in link created

successboolean

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    7 more changes in this revision