@andreprado/agentkit 0.1.0-alpha.10 → 0.1.0-alpha.11

package/docs/guides/connect-whatsapp-zapster.md

@@ -97,6 +97,7 @@ https://<deploy-host>/channels/chn_<id>/whatsapp/zapster/webhook?token=<ZAPSTER_
 - Zapster webhook headers are origin validation, not a cryptographic body signature.
 - Use optional `ZAPSTER_WEBHOOK_TOKEN` in the webhook URL when the endpoint should require an extra secret known only to AgentKit and Zapster.
 - Unsupported media should be logged as skipped/unsupported without creating an agent run.
+- AgentKit handles Zapster `message.received` envelopes with event id at `id`, message text at `data.content.text`, and contact identity at `data.sender.id`.
 
 ## Verification
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andreprado/agentkit",
-  "version": "0.1.0-alpha.10",
+  "version": "0.1.0-alpha.11",
   "private": false,
   "type": "module",
   "repository": {

package/src/runtime/channels/whatsapp-zapster.ts

@@ -71,16 +71,21 @@ export const zapsterWhatsappChannelAdapter: ChannelAdapter = {
   },
   normalizeInbound(input) {
     const body = parseJsonObject(input);
-    const message = readRecord(body, "message");
+    const officialMessage = normalizeZapsterOfficialMessage(body);
+    const message = officialMessage ?? normalizeZapsterLegacyMessage(body);
     const instanceId = input.headers.get("x-instance-id") ?? readString(body, "instance_id") ?? "default";
-    const providerEventId = readString(body, "event_id") ?? input.headers.get("x-message-id") ?? readString(message, "id");
+    const providerEventId =
+      readString(body, "id") ??
+      readString(body, "event_id") ??
+      input.headers.get("x-message-id") ??
+      message.id;
 
     if (!providerEventId) {
-      throw new AgentKitError("channel_payload_invalid", "Zapster payload is missing event_id, X-Message-ID, or message.id.");
+      throw new AgentKitError("channel_payload_invalid", "Zapster payload is missing id, event_id, X-Message-ID, or message.id.");
     }
 
-    const contactId = readString(message, "from") ?? "unknown";
-    const messageType = readString(message, "type") ?? "unknown";
+    const contactId = message.contactId ?? "unknown";
+    const messageType = message.type ?? "unknown";
     const base = {
       type: "whatsapp" as const,
       provider: "zapster" as const,
@@ -95,6 +100,7 @@ export const zapsterWhatsappChannelAdapter: ChannelAdapter = {
       providerMetadata: {
         instanceId,
         messageType,
+        ...(readString(body, "type") ? { eventType: readString(body, "type") } : {}),
       },
     };
 
@@ -108,7 +114,7 @@ export const zapsterWhatsappChannelAdapter: ChannelAdapter = {
       ];
     }
 
-    const text = readString(readRecord(message, "text"), "body");
+    const text = message.text;
 
     if (!text) {
       return [
@@ -128,7 +134,7 @@ export const zapsterWhatsappChannelAdapter: ChannelAdapter = {
           role: "user",
           contentType: "text",
           content: text,
-          providerMessageId: readString(message, "id"),
+          providerMessageId: message.id,
         },
       },
     ];
@@ -167,6 +173,41 @@ export const zapsterWhatsappChannelAdapter: ChannelAdapter = {
   },
 };
 
+type NormalizedZapsterWebhookMessage = {
+  id?: string;
+  contactId?: string;
+  type?: string;
+  text?: string;
+};
+
+function normalizeZapsterOfficialMessage(body: Record<string, unknown>): NormalizedZapsterWebhookMessage | null {
+  if (readString(body, "type") !== "message.received") {
+    return null;
+  }
+
+  const data = readRecord(body, "data");
+  const content = readRecord(data, "content");
+  const sender = readRecord(data, "sender");
+
+  return {
+    id: readString(data, "id"),
+    contactId: readString(sender, "id"),
+    type: readString(data, "type"),
+    text: readString(content, "text"),
+  };
+}
+
+function normalizeZapsterLegacyMessage(body: Record<string, unknown>): NormalizedZapsterWebhookMessage {
+  const message = readRecord(body, "message");
+
+  return {
+    id: readString(message, "id"),
+    contactId: readString(message, "from"),
+    type: readString(message, "type"),
+    text: readString(readRecord(message, "text"), "body"),
+  };
+}
+
 function verifyOptionalWebhookToken(input: WebhookVerificationInput): WebhookVerificationResult {
   const expectsToken = input.channel.secrets.includes("ZAPSTER_WEBHOOK_TOKEN");
 

package/src/templates/skills/agentkit-channels/references/whatsapp-zapster.md

@@ -27,6 +27,8 @@ agentkit channels deliveries list support-whatsapp
 
 Paste the stable AgentKit webhook URL into Zapster settings. If the channel declares `ZAPSTER_WEBHOOK_TOKEN`, append `?token=<ZAPSTER_WEBHOOK_TOKEN>` to the Zapster webhook URL. Keep phone numbers redacted in logs by default.
 
+AgentKit handles Zapster `message.received` envelopes with event id at `id`, message text at `data.content.text`, and contact identity at `data.sender.id`. Unsupported media should be logged as skipped/unsupported without creating an agent run.
+
 Buffer rapid WhatsApp messages:
 
 ```ts