Make Helpdesk email updates explicit

2026-04-24 23:39:19 +00:00
parent c0904659e4
commit fb6d0c2736
4 changed files with 151 additions and 34 deletions
@@ -47,6 +47,25 @@ $client->updateIssue((int) $created['id'], ['notes' => 'Follow-up note']);
 $client->deleteIssue((int) $created['id']);
 ```

+`updateIssue()` is intentionally safe by default: on Helpdesk-backed issues, a
+normal Redmine note does **not** send an email to the customer. To send through
+the Helpdesk plugin, opt in explicitly:
+
+```php
+$client->updateIssue(39858, [
+    'notes' => 'Customer-visible response.',
+], [
+    'send_helpdesk_email' => true,
+]);
+
+// Equivalent explicit form:
+$client->sendHelpdeskIssueResponse(39858, 'Customer-visible response.');
+```
+
+Use the default non-email update for internal notes, status/category/assignee
+changes, and automation cleanup. Use the Helpdesk email path only when the
+caller deliberately wants the customer to receive mail.
+
 ## Test instance

 A working test copy of Redmine is available on the LAN at `192.168.50.170`.