Skip to content

Document translated admin reply topics and translations field in 2.16 #692

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
yasser-aboelgheit-intercom merged 4 commits into from
Sep 30, 2026
Merged

Document translated admin reply topics and translations field in 2.16 #692

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9c3ef04
Document translated admin reply topics and translations field in 2.16
yasser-aboelgheit-intercom Sep 30, 2026
3b9d71a
Match the 2.16 translations examples to developer-docs
yasser-aboelgheit-intercom Sep 30, 2026
15e866f
Shorten the 2.16 translations descriptions
yasser-aboelgheit-intercom Sep 30, 2026
f0dd7d5
Add an admin_reply request example to replyTicket
yasser-aboelgheit-intercom Sep 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Shorten the 2.16 translations descriptions 
Limits them to what the field contains and drops the body sentence, which is
wrong when a conversation is retrieved with include_translations=true.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
  • Loading branch information
@yasser-aboelgheit-intercom @claude
yasser-aboelgheit-intercom and claude committed Sep 30, 2026
commit 15e866fbf029f05738735430d837da19c068930f
45 changes: 12 additions & 33 deletions descriptions/2.16/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28084,17 +28084,10 @@ components:
type: object
nullable: true
description: >-
A map of the reply text keyed by locale code, with values in the
same HTML format as `body`. Backs the `conversation.admin.replied.translated`
webhook topic. The special `original` key holds the source locale code
of the reply; every other key is a locale code whose value is the reply
text translated into that locale. The `translations` field does not modify
`body`; `body` carries the reply as authored.
This webhook topic is not sent for every translated reply: it is
suppressed when the reply's `body` contains any text outside an HTML block
element, which includes plain-text replies created through the REST API.
Wrap the body in `<p>`, `<div>`, or another supported block element to
avoid this.
A map of the reply text keyed by locale code. Backs the
`conversation.admin.replied.translated` webhook topic. `original` holds
the locale code the reply was written in; every other key holds the
reply translated into that locale.
properties:
original:
type: string
Expand Down Expand Up @@ -34800,17 +34793,10 @@ components:
type: object
nullable: true
description: >-
A map of the reply text keyed by locale code, with values in the
same HTML format as `body`. Backs the `ticket.admin.replied.translated`
webhook topic. The special `original` key holds the source locale code
of the reply; every other key is a locale code whose value is the reply
text translated into that locale. The `translations` field does not modify
`body`; `body` carries the reply as authored.
This webhook topic is not sent for every translated reply: it is
suppressed when the reply's `body` contains any text outside an HTML block
element, which includes plain-text replies created through the REST API.
Wrap the body in `<p>`, `<div>`, or another supported block element to
avoid this.
A map of the reply text keyed by locale code. Backs the
`ticket.admin.replied.translated` webhook topic. `original` holds
the locale code the reply was written in; every other key holds the
reply translated into that locale.
properties:
original:
type: string
Expand Down Expand Up @@ -34997,17 +34983,10 @@ components:
type: object
nullable: true
description: >-
A map of the reply text keyed by locale code, with values in the
same HTML format as `body`. Backs the `ticket.admin.replied.translated`
webhook topic. The special `original` key holds the source locale code
of the reply; every other key is a locale code whose value is the reply
text translated into that locale. The `translations` field does not modify
`body`; `body` carries the reply as authored.
This webhook topic is not sent for every translated reply: it is
suppressed when the reply's `body` contains any text outside an HTML block
element, which includes plain-text replies created through the REST API.
Wrap the body in `<p>`, `<div>`, or another supported block element to
avoid this.
A map of the reply text keyed by locale code. Backs the
`ticket.admin.replied.translated` webhook topic. `original` holds
the locale code the reply was written in; every other key holds the
reply translated into that locale.
properties:
original:
type: string
Expand Down
Loading