Skip to content

Describe the two AI attributes on 2.17 and Preview conversations by name - #736

Merged
yasser-aboelgheit-intercom merged 3 commits into
mainfrom
yasser/2.17-conversation-custom-attributes
Oct 21, 2026
Merged

yasser-aboelgheit-intercom merged 3 commits into
mainfrom
yasser/2.17-conversation-custom-attributes

Conversation

@yasser-aboelgheit-intercom

@yasser-aboelgheit-intercom yasser-aboelgheit-intercom commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

Why?

On a 2.17 or Preview conversation, only "AI Topic and Subtopic" and "CX Score reasons" come back as lists of objects, but the spec allows those lists as the value of any custom attribute. The docs website already describes the two by name, so the two references disagree.

How?

Names the two attributes as read-only lists on the 2.17 and Preview response schemas and gives each list item its own schema, matching the website copy. The request schema is unchanged.

Notes for reviewers
  • History: both shapes came from the same change. This repo's version merged in Document Topics and CX Score reasons in a conversation's custom_attributes (Preview and 2.17) #642 on 14 October at 09:10 UTC. The website's companion PR was opened a minute earlier on 27 August and merged 17 minutes later. The two diverged during review, and neither has changed since.
  • SDKs: the SDKs build from 2.14 and Preview, so the Preview change will change the generated custom attribute types. fern check passes with 0 errors.
  • Preview: Preview gets the same change, so the next version doesn't bring the mismatch back.

Generated with Claude Code

Only "AI Topic and Subtopic" and "CX Score reasons" carry arrays, so name
them as read-only properties instead of allowing the arrays for any key.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@yasser-aboelgheit-intercom
yasser-aboelgheit-intercom requested a review from a team October 21, 2026 09:31
cathalging
cathalging previously approved these changes Oct 21, 2026
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@yasser-aboelgheit-intercom yasser-aboelgheit-intercom changed the title Name the two AI attributes in 2.17 conversation custom_attributes Describe the two AI attributes on 2.17 and Preview conversations by name Oct 21, 2026
@yasser-aboelgheit-intercom
yasser-aboelgheit-intercom merged commit c49d18d into main Oct 21, 2026
4 checks passed
@yasser-aboelgheit-intercom
yasser-aboelgheit-intercom deleted the yasser/2.17-conversation-custom-attributes branch October 21, 2026 10:24
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.

2 participants