From 5056465fad768c98c3ad5fef2ad412047645f344 Mon Sep 17 00:00:00 2001 From: Cathal Ging Date: Wed, 26 Aug 2026 12:04:56 +0100 Subject: [PATCH] Document the body-content caveat on translated-reply webhook topics The translations field description implied conversation.admin.replied.translated and ticket.admin.replied.translated fire for every translated admin reply. In practice the topic is suppressed when the reply's body has text outside an HTML block element, which includes plain-text replies sent through the REST API. Add that caveat to the three affected schema descriptions in the Preview spec. --- descriptions/0/api.intercom.io.yaml | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 78df412..86ec103 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -32214,7 +32214,10 @@ components: text translated into that locale, as HTML in the same format as `body`. The `body` field is unchanged and always stays in the original source language. Available in the Preview API version - only (set `Intercom-Version: Preview`). + only (set `Intercom-Version: Preview`). 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. required: - original additionalProperties: @@ -39880,7 +39883,10 @@ components: text translated into that locale, as HTML in the same format as `body`. The `body` field is unchanged and always stays in the original source language. Available in the Preview API version - only (set `Intercom-Version: Preview`). + only (set `Intercom-Version: Preview`). 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. required: - original additionalProperties: @@ -40069,7 +40075,10 @@ components: text translated into that locale, as HTML in the same format as `body`. The `body` field is unchanged and always stays in the original source language. Available in the Preview API version - only (set `Intercom-Version: Preview`). + only (set `Intercom-Version: Preview`). 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. required: - original additionalProperties: