Skip to content

Add startConversation method and missing Messenger/data attributes. - #834

Merged
devrnt merged 1 commit into
mainfrom
sdk-parity-methods-attrs
Jul 29, 2026
Merged

Add startConversation method and missing Messenger/data attributes.#834
devrnt merged 1 commit into
mainfrom
sdk-parity-methods-attrs

Conversation

@devrnt

@devrnt devrnt commented Jul 29, 2026

Copy link
Copy Markdown
Owner

What

Closes the remaining gaps between react-use-intercom and the official Intercom JavaScript SDK, found
by a full scan of the methods and [attributes/objects](https://developers.intercom.com/installing-int
ercom/web/attributes-objects) docs.

Method

  • startConversation(message) — opens the Messenger and immediately starts a new conversation with the supplied message.

Messenger attributes

  • linkColor (link_color) — hyperlink color in messages.
  • themeMode (theme_mode) — 'light' | 'dark' | 'system'.
  • messengerStyleId (messenger_style_id) — load a specific messenger style configuration.
  • hideNotifications (hide_notifications) — start with in-app notifications hidden at boot (pairs with the existing hideNotifications runtime method).

Data attribute

  • pageTitle (page_title) — page-view tracking label.

Notes

  • All additions are optional and backwards-compatible → minor (changeset included).
  • Attributes follow the existing camelCase → snake_case mapping in mappers.ts; README continues to defer attribute docs to the IntercomProps types.

Verification

  • pnpm build (incl. DTS typecheck) ✓
  • pnpm test
  • pnpm lint

🤖 Generated with Claude Code

Reach parity with the official Intercom JavaScript SDK:
- add the startConversation method
- add the linkColor, themeMode, messengerStyleId and hideNotifications
  Messenger attributes
- add the pageTitle data attribute

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Jul 29, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7322d54

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
react-use-intercom Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@devrnt
devrnt merged commit c67cc33 into main Jul 29, 2026
3 of 4 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

Size Change: 0 B

Total Size: 5.7 kB

ℹ️ View Unchanged
Filename Size
packages/react-use-intercom/dist/index.cjs 2.93 kB
packages/react-use-intercom/dist/index.js 2.77 kB

compressed-size-action

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant