chatwoot-router 0.5.2 → 0.6.0

package/CHANGELOG.md

@@ -7,8 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-10-05
+
+### Added
+
+- `routing.kinds.<id>.<name>.label` (default `true`): `false` handles the kind without giving the ticket its label,
+  for a kind that is not a kind of ticket, such as a thank-you that is only resolved.
+
 ## [0.5.2] - 2026-10-05
 
+### Fixed
+
+- Clear a request's timeout once its response has been read. The pending `AbortSignal.timeout` timer kept a
+  Durable Object invocation open until it fired, so most alarms were billed and reported at about 60 seconds.
+
 ## [0.5.1] - 2026-10-05
 
 ### Fixed
@@ -17,11 +29,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   (`Contact#webhook_data`; users and bots have one), and the router required `type: "contact"`, so it ignored
   every customer message and a new ticket waited for the five-minute sweep.
 
-### Fixed
-
-- Clear a request's timeout once its response has been read. The pending `AbortSignal.timeout` timer kept a
-  Durable Object invocation open until it fired, so most alarms were billed and reported at about 60 seconds.
-
 ## [0.5.0] - 2026-10-05
 
 ### Fixed
@@ -127,7 +134,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   `routing_kind`.
 - The `chatwoot-router-store-config` command and `chatwoot-router/stored-config`, for a configuration in KV.
 
-[Unreleased]: https://github.com/Phala-Network/chatwoot-workers/compare/chatwoot-router@0.5.2...HEAD
+[Unreleased]: https://github.com/Phala-Network/chatwoot-workers/compare/chatwoot-router@0.6.0...HEAD
+[0.6.0]: https://github.com/Phala-Network/chatwoot-workers/compare/chatwoot-router@0.5.2...chatwoot-router@0.6.0
 [0.5.2]: https://github.com/Phala-Network/chatwoot-workers/compare/chatwoot-router@0.5.1...chatwoot-router@0.5.2
 [0.5.1]: https://github.com/Phala-Network/chatwoot-workers/compare/chatwoot-router@0.5.0...chatwoot-router@0.5.1
 [0.5.0]: https://github.com/Phala-Network/chatwoot-workers/compare/chatwoot-router@0.4.0...chatwoot-router@0.5.0

package/README.md

@@ -126,6 +126,7 @@ no unpublished shared package needs installing.
 | `routing.kinds.<id>.<name>.covers` | 1–1000 characters | required | What the kind is: Jev's criterion for recognizing it. |
 | `routing.kinds.<id>.<name>.cannedResponse` | short code | unset | The account's Chatwoot canned response sent to the customer once, by the account's agent bot (`CHATWOOT_AGENT_BOT_TOKENS`); handoff if it is missing. |
 | `routing.kinds.<id>.<name>.status` | `resolved` or `snoozed` | unset | Set instead of routing the ticket (`snoozed`: until the customer's next message), after the reply of a `cannedResponse`; a new customer message reopens it. |
+| `routing.kinds.<id>.<name>.label` | boolean | `true` | Whether the ticket gets the kind's label; `false` for a kind that is not a kind of ticket, such as a thank-you that is only resolved. |
 
 ### Secrets
 

package/lib/packages/chatwoot-router/scripts/store-config.js

@@ -141,7 +141,12 @@ var configSchema = z2.strictObject({
            * or `snoozed` until the customer's next message. A new message from the customer
            * reopens either.
            */
-          status: z2.enum(["resolved", "snoozed"]).optional()
+          status: z2.enum(["resolved", "snoozed"]).optional(),
+          /**
+           * Whether the ticket gets the kind's label (the default). False for a kind that is not a kind of
+           * ticket, such as a thank-you that is only resolved.
+           */
+          label: z2.boolean().default(true)
         })
       )
     ).optional()

package/lib/packages/chatwoot-router/scripts/stored-config.js

@@ -93,7 +93,12 @@ var configSchema = z2.strictObject({
            * or `snoozed` until the customer's next message. A new message from the customer
            * reopens either.
            */
-          status: z2.enum(["resolved", "snoozed"]).optional()
+          status: z2.enum(["resolved", "snoozed"]).optional(),
+          /**
+           * Whether the ticket gets the kind's label (the default). False for a kind that is not a kind of
+           * ticket, such as a thank-you that is only resolved.
+           */
+          label: z2.boolean().default(true)
         })
       )
     ).optional()

package/lib/packages/chatwoot-router/src/config.d.ts

@@ -21,6 +21,7 @@ export declare const configSchema: z.ZodObject<{
                 resolved: "resolved";
                 snoozed: "snoozed";
             }>>;
+            label: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strict>>>>;
     }, z.core.$strict>;
 }, z.core.$strict>;

package/lib/packages/chatwoot-router/src/index.js

@@ -363,6 +363,16 @@ function chatwootClient(baseUrl, token, fetch2) {
       );
     },
     /** The account's label names (Chatwoot saves them in lower case). */
+    /** The contact's latest 25 conversations, newest first, that this user may see. */
+    async contactConversations(accountId2, contactId) {
+      const list = await data(
+        "list contact conversations",
+        client.GET("/api/v1/accounts/{account_id}/contacts/{id}/conversations", {
+          params: { path: { account_id: accountId2, id: contactId } }
+        })
+      );
+      return list.payload ?? [];
+    },
     async listLabels(accountId2) {
       const list = await data(
         "list labels",
@@ -450,6 +460,7 @@ function toRelayConversation(conversationId, conversation) {
     priority: conversation.priority ?? null,
     labels: conversation.labels ?? [],
     contact: {
+      id: meta?.sender?.id ?? null,
       name: meta?.sender?.name ?? null,
       email: meta?.sender?.email ?? null,
       phone: meta?.sender?.phone_number ?? null,
@@ -875,7 +886,7 @@ async function routeConversation(ctx, accountId2, conversationId) {
   const labels = [
     .../* @__PURE__ */ new Set([
       ...current.conversation.labels,
-      ...[topic, kind ? decision.kind : null].filter((label) => label !== null)
+      ...[topic, kind?.label ? decision.kind : null].filter((label) => label !== null)
     ])
   ];
   if (labels.length !== current.conversation.labels.length) await bot.setLabels(accountId2, conversationId, labels);
@@ -1083,7 +1094,12 @@ var configSchema = z5.strictObject({
            * or `snoozed` until the customer's next message. A new message from the customer
            * reopens either.
            */
-          status: z5.enum(["resolved", "snoozed"]).optional()
+          status: z5.enum(["resolved", "snoozed"]).optional(),
+          /**
+           * Whether the ticket gets the kind's label (the default). False for a kind that is not a kind of
+           * ticket, such as a thank-you that is only resolved.
+           */
+          label: z5.boolean().default(true)
         })
       )
     ).optional()

package/lib/shared/chatwoot/api.d.ts

@@ -185,6 +185,8 @@ export declare function chatwootClient(baseUrl: string, token: string, fetch: Fe
      */
     unassign(accountId: number, conversationId: number): Promise<void>;
     /** The account's label names (Chatwoot saves them in lower case). */
+    /** The contact's latest 25 conversations, newest first, that this user may see. */
+    contactConversations(accountId: number, contactId: number): Promise<ChatwootConversation[]>;
     listLabels(accountId: number): Promise<string[]>;
     conversationLabels(accountId: number, conversationId: number): Promise<string[]>;
     /** Replaces the conversation's labels (the spec's "Add Labels" overwrites the list). */

package/lib/shared/types.d.ts

@@ -43,6 +43,8 @@ export interface RelayConversation {
     priority?: string | null;
     labels: string[];
     contact: {
+        /** The contact's Chatwoot id. */
+        id?: number | null;
         name?: string | null;
         email?: string | null;
         phone?: string | null;
@@ -80,6 +82,8 @@ export interface RelayMessage {
     /** The Discord avatar of the linked agent who sent the message, if any. */
     discordAvatarUrl?: string;
     sender?: {
+        /** The Chatwoot id of the contact, user, or agent bot (see `type`). */
+        id?: number | null | undefined;
         name?: string | null | undefined;
         email?: string | null | undefined;
         type?: string | null | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatwoot-router",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Route Chatwoot conversations with TypeSafe Jev on Cloudflare Workers.",
   "keywords": [
     "chatwoot",