Native iMessage polls

Native iMessage polls have no title. Their snapshots and nested vote context omit the title field; option labels still use title. Match a poll with content.pollMessageGuid. Match a selected option with content.option.optionIdentifier, not its label — different options can have identical labels.

Poll creation and option additions

Poll creation and option additions arrive as content.type === "poll", with content.change set to "created" or "optionAdded". Both contain the full current option set. An option addition does not represent a vote.

for await (const [space, message] of app.messages) {
  if (message.content.type === "poll" && message.content.change) {
    console.log(message.content.pollMessageGuid, message.content.change);
    for (const opt of message.content.options) {
      console.log(opt.title, opt.optionIdentifier);
    }
  }
}

Votes

Votes and removed votes arrive as content.type === "poll_option", with selected set to true or false. The nested content.poll retains the poll GUID and option identifiers.

if (message.content.type === "poll_option") {
  const { pollMessageGuid, option, selected } = message.content;
  // Correlate by pollMessageGuid and option.optionIdentifier.
}

Use the vote message ID for duplicate detection and the poll GUID for correlation. A created poll uses its root GUID as its message ID.

Compatibility

These identity fields are optional on shared Spectrum content because other providers can still supply polls without native identifiers. The poll(title, ...) builder still requires a nonempty title for outbound polls. Native snapshots with a poll GUID require distinct option identifiers, even when their labels are equal. The native app.webhook() handler preserves the same poll content types and identifiers. Hosted delivery also requires the corresponding webhook-worker update and SDK rollout; updating only the receiving application is not enough. Previously skipped events are not automatically replayed.

Get started

Core concepts

Content

Providers

Advanced

Integrations

Best Practices

Troubleshooting

Native iMessage polls

Poll creation and option additions

Votes

Compatibility

​Poll creation and option additions

​Votes

​Compatibility

Poll creation and option additions

Votes

Compatibility