@andreprado/agentkit 0.1.0-alpha.20 → 0.1.0-alpha.21

package/src/runtime/channels.ts

@@ -200,7 +200,7 @@ export type ChannelAdapter = ChannelAdapterId & {
 };
 
 export type PortableChannelRouteContract = {
-  route: "/channels/:name/:type/:provider/webhook";
+  route: "/channels/:name/:type/:provider/webhook" | "/channels/:name/webhook";
   verification: WebhookVerificationResult;
   dedupe: {
     key: string;

package/src/runtime/config.ts

@@ -30,8 +30,8 @@ const AGENT_RUNTIMES = new Set<AgentRuntime>(["local", "edge"]);
 const PROVIDERS = new Set<AgentProviderName>(["test", "openai", "anthropic", "openrouter", "custom"]);
 const ACCESS_MODES = new Set<AccessMode>(["private", "token", "public"]);
 const TOOL_VISIBILITIES = new Set<ToolVisibility>(["user", "internal"]);
-const CHANNEL_TYPES = new Set<ChannelType>(["website", "telegram", "whatsapp", "discord", "slack"]);
-const CHANNEL_PROVIDERS = new Set<ChannelProvider>(["agentkit", "telegram", "zapster", "meta", "discord", "slack"]);
+const CHANNEL_TYPES = new Set<ChannelType>(["website", "telegram", "whatsapp", "discord", "slack", "webhook"]);
+const CHANNEL_PROVIDERS = new Set<ChannelProvider>(["agentkit", "telegram", "zapster", "meta", "uazapi", "evolution", "discord", "slack", "generic"]);
 const CHANNEL_BUFFER_MODES = new Set<ChannelBufferMode>(["off", "debounce"]);
 const CHANNEL_AUDIO_MODES = new Set<ChannelAudioMode>(["off", "reject", "transcribe"]);
 const DISCORD_CHANNEL_MODES = new Set<DiscordChannelMode>(["interactions", "bot"]);
@@ -627,6 +627,11 @@ function validateChannel(value: unknown, index: number, hasTranscriptionConfig:
     return;
   }
 
+  if (value.type === "webhook") {
+    validateGenericWebhookChannel(value, index);
+    return;
+  }
+
   validateChannelAudio(value.audio, index, hasTranscriptionConfig);
 
   if (value.type === "website") {
@@ -699,7 +704,7 @@ function validateTelegramChannel(value: Record<string, unknown>, index: number):
 
 function validateWhatsappChannel(value: Record<string, unknown>, index: number): void {
   if (value.type !== "whatsapp") {
-    throw invalidConfig(`channels[${index}].type must be "website", "telegram", "whatsapp", "discord", or "slack".`);
+    throw invalidConfig(`channels[${index}].type must be "website", "telegram", "whatsapp", "discord", "slack", or "webhook".`);
   }
 
   if (value.provider === "zapster") {
@@ -720,7 +725,25 @@ function validateWhatsappChannel(value: Record<string, unknown>, index: number):
     return;
   }
 
-  throw invalidConfig(`channels[${index}].provider must be "zapster" or "meta" when type is "whatsapp".`);
+  if (value.provider === "uazapi") {
+    expectRequiredSecrets(
+      value.secrets,
+      ["UAZAPI_BASE_URL", "UAZAPI_TOKEN"],
+      `channels[${index}]`,
+    );
+    return;
+  }
+
+  if (value.provider === "evolution") {
+    expectRequiredSecrets(
+      value.secrets,
+      ["EVOLUTION_API_BASE_URL", "EVOLUTION_API_KEY", "EVOLUTION_INSTANCE_NAME", "EVOLUTION_WEBHOOK_TOKEN"],
+      `channels[${index}]`,
+    );
+    return;
+  }
+
+  throw invalidConfig(`channels[${index}].provider must be "zapster", "meta", "uazapi", or "evolution" when type is "whatsapp".`);
 }
 
 function validateDiscordChannel(value: Record<string, unknown>, index: number): void {
@@ -755,6 +778,18 @@ function validateSlackChannel(value: Record<string, unknown>, index: number): vo
   expectRequiredSecrets(value.secrets, ["SLACK_BOT_TOKEN", "SLACK_SIGNING_SECRET"], `channels[${index}]`);
 }
 
+function validateGenericWebhookChannel(value: Record<string, unknown>, index: number): void {
+  if (value.provider !== "generic") {
+    throw invalidConfig(`channels[${index}].provider must be "generic" when type is "webhook".`);
+  }
+
+  if (value.audio !== undefined) {
+    throw invalidConfig(`channels[${index}].audio is not supported when type is "webhook".`);
+  }
+
+  expectRequiredSecrets(value.secrets, ["AGENTKIT_WEBHOOK_SECRET"], `channels[${index}]`);
+}
+
 function validateChannelLimits(value: unknown, index: number): void {
   if (value === undefined) {
     return;

package/src/runtime/core/targets.ts

@@ -6,7 +6,7 @@ export type RuntimeTargetId = (typeof runtimeTargetIds)[number];
 export type RuntimeTargetCapabilityState = "available" | "planned" | "unsupported";
 export type RuntimeStorageCapability = "agentkit" | "durable-object-sqlite" | "local-sqlite" | "postgres";
 export type RuntimeFilesCapability = "none" | "r2" | "local-disk" | "s3-compatible";
-export type RuntimeChannelCapability = "website" | "telegram" | "whatsapp" | "discord" | "slack";
+export type RuntimeChannelCapability = "website" | "telegram" | "whatsapp" | "discord" | "slack" | "webhook";
 export type RuntimeProviderSupport = "pi-local" | "edge-compatible" | "server-env";
 
 export type RuntimeTargetCapabilities = {
@@ -35,7 +35,7 @@ export const runtimeTargets: Readonly<Record<RuntimeTargetId, RuntimeTarget>> =
       dev: "available",
       storage: ["local-sqlite"],
       files: ["local-disk"],
-      channels: ["website", "slack"],
+      channels: ["website", "slack", "webhook"],
       providers: ["pi-local"],
     },
   },
@@ -48,7 +48,7 @@ export const runtimeTargets: Readonly<Record<RuntimeTargetId, RuntimeTarget>> =
       dev: "planned",
       storage: ["agentkit", "durable-object-sqlite", "postgres"],
       files: ["none", "r2"],
-      channels: ["website", "telegram", "whatsapp", "discord", "slack"],
+      channels: ["website", "telegram", "whatsapp", "discord", "slack", "webhook"],
       providers: ["edge-compatible"],
     },
   },
@@ -61,7 +61,7 @@ export const runtimeTargets: Readonly<Record<RuntimeTargetId, RuntimeTarget>> =
       dev: "planned",
       storage: ["local-sqlite", "postgres"],
       files: ["none", "local-disk", "s3-compatible"],
-      channels: ["website", "telegram", "whatsapp", "discord", "slack"],
+      channels: ["website", "telegram", "whatsapp", "discord", "slack", "webhook"],
       providers: ["server-env"],
     },
   },
@@ -74,7 +74,7 @@ export const runtimeTargets: Readonly<Record<RuntimeTargetId, RuntimeTarget>> =
       dev: "unsupported",
       storage: ["local-sqlite", "postgres"],
       files: ["none", "local-disk", "s3-compatible"],
-      channels: ["website", "telegram", "whatsapp", "discord", "slack"],
+      channels: ["website", "telegram", "whatsapp", "discord", "slack", "webhook"],
       providers: ["server-env"],
     },
   },

package/src/runtime/dev-server.ts

@@ -9,10 +9,13 @@ import { openCapsuleStore, type ConversationRecord } from "../storage/sqlite";
 import type { AgentChannel, ChannelProvider, ChannelType } from "../index";
 import type { ChannelAdapter, NormalizedChannelMessage, RawWebhookEvent } from "./channels";
 import { discordChannelAdapter } from "./channels/discord";
+import { genericWebhookChannelAdapter } from "./channels/generic-webhook";
 import { slackChannelAdapter } from "./channels/slack";
 import { telegramChannelAdapter } from "./channels/telegram";
 import { websiteChannelAdapter } from "./channels/website";
+import { evolutionWhatsappChannelAdapter } from "./channels/whatsapp-evolution";
 import { metaWhatsappChannelAdapter } from "./channels/whatsapp-meta";
+import { uazapiWhatsappChannelAdapter } from "./channels/whatsapp-uazapi";
 import { zapsterWhatsappChannelAdapter } from "./channels/whatsapp-zapster";
 import { runAgentMessage } from "./chat";
 import { isChannelBufferEnabled, renderBufferedChannelMessage, resolveChannelBuffer } from "./channel-buffer";
@@ -320,13 +323,14 @@ async function handleDevServerRequest(
       return await handleLocalFile(capsule, request, decodeURIComponent(fileMatch[1]));
     }
 
-    const channelMatch = route.match(/^\/channels\/([^/]+)\/(website|telegram|whatsapp|discord|slack)\/([^/]+)\/webhook$/);
+    const channelMatch = route.match(/^\/channels\/([^/]+)\/(website|telegram|whatsapp|discord|slack|webhook)\/([^/]+)\/webhook$/);
+    const directWebhookMatch = route.match(/^\/channels\/([^/]+)\/webhook$/);
 
-    if (channelMatch) {
+    if (channelMatch || directWebhookMatch) {
       return await handlePortableChannel(capsule, request, channelRuntime, {
-        name: decodeURIComponent(channelMatch[1]),
-        type: channelMatch[2] as ChannelType,
-        provider: decodeURIComponent(channelMatch[3]) as ChannelProvider,
+        name: decodeURIComponent((channelMatch ?? directWebhookMatch)?.[1] ?? ""),
+        type: channelMatch ? channelMatch[2] as ChannelType : "webhook",
+        provider: channelMatch ? decodeURIComponent(channelMatch[3]) as ChannelProvider : "generic",
       });
     }
 
@@ -1137,6 +1141,14 @@ function adapterForChannel(type: ChannelType, provider: ChannelProvider): Channe
     return metaWhatsappChannelAdapter;
   }
 
+  if (type === "whatsapp" && provider === "uazapi") {
+    return uazapiWhatsappChannelAdapter;
+  }
+
+  if (type === "whatsapp" && provider === "evolution") {
+    return evolutionWhatsappChannelAdapter;
+  }
+
   if (type === "discord" && provider === "discord") {
     return discordChannelAdapter;
   }
@@ -1145,6 +1157,10 @@ function adapterForChannel(type: ChannelType, provider: ChannelProvider): Channe
     return slackChannelAdapter;
   }
 
+  if (type === "webhook" && provider === "generic") {
+    return genericWebhookChannelAdapter;
+  }
+
   throw new AgentKitError("channel_not_found", `No channel adapter for ${type}/${provider}.`);
 }
 

package/src/runtime/targets/cloudflare/build.ts

@@ -462,11 +462,30 @@ export function slackChannel(input) {
   };
 }
 
+export function webhookChannel(input) {
+  return {
+    type: "webhook",
+    provider: "generic",
+    name: input.name,
+    secrets: normalizeChannelSecrets(input.secrets ?? ["AGENTKIT_WEBHOOK_SECRET"], "generic webhook channel"),
+    ...(input.limits ? { limits: input.limits } : {}),
+    ...(input.buffer ? { buffer: normalizeChannelBuffer(input.buffer, "generic webhook channel") } : {}),
+  };
+}
+
 function defaultWhatsappChannelSecrets(provider) {
   if (provider === "zapster") {
     return ["ZAPSTER_API_KEY", "ZAPSTER_INSTANCE_ID", "ZAPSTER_WEBHOOK_ID"];
   }
 
+  if (provider === "uazapi") {
+    return ["UAZAPI_BASE_URL", "UAZAPI_TOKEN"];
+  }
+
+  if (provider === "evolution") {
+    return ["EVOLUTION_API_BASE_URL", "EVOLUTION_API_KEY", "EVOLUTION_INSTANCE_NAME", "EVOLUTION_WEBHOOK_TOKEN"];
+  }
+
   return ["META_WHATSAPP_ACCESS_TOKEN", "META_WHATSAPP_APP_SECRET", "META_WHATSAPP_VERIFY_TOKEN"];
 }
 
@@ -1128,9 +1147,10 @@ export default {
 
 function isHostedChannelWebhookPath(pathname) {
   return (
-    /^\\/channels\\/[^/]+\\/(?:website\\/agentkit|telegram\\/telegram|whatsapp\\/(?:zapster|meta)|discord\\/discord|slack\\/slack)\\/webhook$/.test(pathname) ||
-    /^\\/channels\\/[^/]+\\/(?:website|telegram|discord|slack)\\/webhook$/.test(pathname) ||
-    /^\\/channels\\/[^/]+\\/whatsapp\\/(?:zapster|meta)\\/webhook$/.test(pathname)
+    /^\\/channels\\/[^/]+\\/(?:website\\/agentkit|telegram\\/telegram|whatsapp\\/(?:zapster|meta|uazapi|evolution)|discord\\/discord|slack\\/slack|webhook\\/generic)\\/webhook$/.test(pathname) ||
+    /^\\/channels\\/[^/]+\\/(?:website|telegram|discord|slack|webhook)\\/webhook$/.test(pathname) ||
+    /^\\/channels\\/[^/]+\\/webhook$/.test(pathname) ||
+    /^\\/channels\\/[^/]+\\/whatsapp\\/(?:zapster|meta|uazapi|evolution)\\/webhook$/.test(pathname)
   );
 }
 

package/src/templates/skills/agentkit-capsule/SKILL.md

@@ -27,7 +27,7 @@ Use this first inside an AgentKit Agent Capsule.
 - Improve from hosted or local production evidence: `skills/agentkit-improve/SKILL.md`
 - Prepare hosted deploy: `skills/agentkit-deploy/SKILL.md`
 - Work with secrets, external APIs, public access, channels, or real data: `skills/agentkit-security/SKILL.md`
-- Add or debug website, Telegram, WhatsApp, Discord, or Slack channels: `skills/agentkit-channels/SKILL.md`
+- Add or debug website, Telegram, WhatsApp, Discord, Slack, or generic webhook channels: `skills/agentkit-channels/SKILL.md`
 - Investigate command failures: `skills/agentkit-troubleshooting/SKILL.md`
 
 For a compact docs map, read `references/docs-router.md`.

package/src/templates/skills/agentkit-capsule/references/docs-router.md

@@ -9,7 +9,7 @@ Prefer the narrowest source that covers the task.
 - Safe AgentKit product feedback drafts/submission: `docs/guides/send-feedback.md`
 - Real provider setup: `docs/guides/use-provider.md`
 - Deploy readiness, managed secrets, smoke checks, hosted UI: `docs/guides/prepare-deploy.md`
-- Channels: `docs/guides/add-channel.md`, `connect-discord.md`, `connect-slack.md`, `connect-telegram.md`, `connect-whatsapp-zapster.md`, `debug-channel.md`
+- Channels: `docs/guides/add-channel.md`, `connect-discord.md`, `connect-slack.md`, `connect-telegram.md`, `connect-whatsapp-evolution.md`, `connect-whatsapp-uazapi.md`, `connect-whatsapp-zapster.md`, `debug-channel.md`
 - Security: `docs/guides/security-rules.md`
 
 Use `npm run agentkit -- docs full` only for a complete-contract audit, framework internals, or a behavior not covered by the task guide.

package/src/templates/skills/agentkit-channels/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agentkit-channels
-description: Use when adding, connecting, testing, buffering, transcribing audio, or debugging AgentKit website, Telegram, WhatsApp, Discord, or Slack channels, including channel config helpers, provider secrets, webhook setup, channel tests, delivery logs, burst-message buffers, and transcription provider secrets.
+description: Use when adding, connecting, testing, buffering, transcribing audio, or debugging AgentKit website, Telegram, WhatsApp, Discord, Slack, or generic webhook channels, including channel config helpers, provider secrets, webhook setup, channel tests, delivery logs, burst-message buffers, and transcription provider secrets.
 ---
 
 # AgentKit Channels
@@ -47,7 +47,7 @@ V1 providers:
 - `openai`: `gpt-4o-mini-transcribe`, `gpt-4o-transcribe`, `whisper-1`; default secret `OPENAI_API_KEY`.
 - `groq`: `whisper-large-v3-turbo`, `whisper-large-v3`, `distil-whisper-large-v3-en`; default secret `GROQ_API_KEY`.
 
-Telegram voice notes are usually OGG/Opus, so use Groq for the default Telegram voice-note path in V1. Zapster audio needs a usable HTTPS Zapster media download URL in the webhook payload; arbitrary hosts are rejected before bearer auth is sent. Hosted channel creation requires the transcription secret automatically when the channel enables transcription. Webhooks only enqueue audio jobs; download and transcription run in the retryable channel worker before the agent run.
+Telegram voice notes are usually OGG/Opus, so use Groq for the default Telegram voice-note path in V1. Zapster audio needs a usable HTTPS Zapster media download URL in the webhook payload; arbitrary hosts are rejected before bearer auth is sent. UAZAPI audio downloads go through UAZAPI `/message/download` with base64 return enabled. Evolution audio downloads go through Evolution API `/chat/getBase64FromMediaMessage/{instance}` with base64 return enabled. Arbitrary UAZAPI and Evolution webhook media hosts are not fetched. Hosted channel creation requires the transcription secret automatically when the channel enables transcription. Webhooks only enqueue audio jobs; download and transcription run in the retryable channel worker before the agent run.
 
 Discord channels do not support audio in V1.
 
@@ -80,9 +80,12 @@ npm run agentkit -- channels list
 npm run agentkit -- channels add website website-chat
 npm run agentkit -- channels connect telegram support-telegram
 npm run agentkit -- channels add whatsapp support-whatsapp --provider zapster
+npm run agentkit -- channels connect whatsapp support-whatsapp --provider uazapi
+npm run agentkit -- channels connect whatsapp main-whatsapp --provider evolution
 npm run agentkit -- channels connect discord support-discord
 npm run agentkit -- channels connect discord server-discord --mode bot
 npm run agentkit -- channels connect slack support-slack
+npm run agentkit -- channels connect webhook n8n-webhook
 npm run agentkit -- channels doctor support-telegram
 npm run agentkit -- channels test support-telegram --message "hello"
 npm run agentkit -- channels test-audio support-telegram --fixture voice-note
@@ -95,6 +98,8 @@ npm run agentkit -- channels deliveries list support-telegram
 - `references/discord.md`
 - `references/slack.md`
 - `references/telegram.md`
+- `references/whatsapp-evolution.md`
+- `references/whatsapp-uazapi.md`
 - `references/whatsapp-zapster.md`
 - `references/channel-buffering.md`
 - `references/channel-debugging.md`
@@ -102,3 +107,21 @@ npm run agentkit -- channels deliveries list support-telegram
 ## Safety
 
 Do not paste provider tokens into code, docs, fixtures, prompts, evals, or delivery logs. Webhook URLs are public transport endpoints; authenticity comes from provider validation or channel tokens.
+
+## Generic Webhooks
+
+Use `webhookChannel({ name: "n8n-webhook" })` for n8n, Make, Zapier, Pipedream, or custom server events.
+
+Canonical JSON:
+
+```json
+{
+  "event_id": "evt_123",
+  "external_id": "customer_123",
+  "message": "hello from n8n"
+}
+```
+
+`event_id` is required for dedupe. `external_id` is recommended for conversation continuity and is hashed before storage. Authenticate with `Authorization: Bearer <AGENTKIT_WEBHOOK_SECRET>`, `X-AgentKit-Webhook-Secret`, or `X-AgentKit-Webhook-Signature: sha256=<hmac of raw JSON body>`.
+
+Generic webhooks are inbound-only in V1. Add a separate tool if the agent must call back into n8n after it runs.

package/src/templates/skills/agentkit-channels/references/channel-debugging.md

@@ -62,5 +62,5 @@ Common errors:
 - `channel_limit_exceeded`: backpressure skipped the message.
 - `synthetic_expected_failure`: a synthetic test reached AgentKit, but the provider correctly rejected a fake test recipient.
 - `buffered` delivery state: message is waiting for the channel quiet window or max wait before one coalesced agent run is queued.
-- `adapter_stubbed`: explicit dry-run mode built a provider request but did not call the provider.
+- `adapter_stubbed`: adapter completed without calling an outbound provider, either because explicit dry-run mode is enabled or the channel is inbound-only.
 - `provider_sent`: the provider accepted the outbound send and returned a provider message ID.

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

@@ -0,0 +1,57 @@
+# WhatsApp Through Evolution API
+
+Required secrets:
+
+```txt
+EVOLUTION_API_BASE_URL
+EVOLUTION_API_KEY
+EVOLUTION_INSTANCE_NAME
+EVOLUTION_WEBHOOK_TOKEN
+```
+
+Audio transcription also needs the configured transcription secret, usually `OPENAI_API_KEY` or `GROQ_API_KEY`.
+
+Commands:
+
+```sh
+agentkit deploy
+agentkit channels add whatsapp main-whatsapp --provider evolution
+agentkit channels setup main-whatsapp --apply
+agentkit channels status main-whatsapp
+agentkit channels test main-whatsapp --message "hello"
+agentkit channels deliveries list main-whatsapp
+```
+
+AgentKit applies Evolution setup by calling `/webhook/set/{instance}` with the stable hosted URL and then confirming the configured webhook through `/webhook/find/{instance}`. AgentKit appends `?token=<EVOLUTION_WEBHOOK_TOKEN>` to the registered webhook URL.
+
+Inbound Evolution `MESSAGES_UPSERT` webhooks normalize text and audio messages. `fromMe` messages are skipped to avoid reply loops. Unsupported media should be logged as skipped/unsupported without creating an agent run.
+
+Outbound replies call Evolution API `POST /message/sendText/{instance}` with the `apikey` header and a JSON body containing `number` and `text`. Only set `AGENTKIT_CHANNEL_SEND_DRY_RUN=1` in tests when Evolution should not receive a real message.
+
+Buffer rapid WhatsApp messages:
+
+```ts
+whatsappChannel({
+  name: "main-whatsapp",
+  provider: "evolution",
+  buffer: {
+    mode: "debounce",
+    quietWindowMs: 2500,
+    maxWaitMs: 12000,
+    maxMessages: 20,
+    maxChars: 8000,
+  },
+})
+```
+
+Transcribe WhatsApp audio:
+
+```ts
+whatsappChannel({
+  name: "main-whatsapp",
+  provider: "evolution",
+  audio: { mode: "transcribe" },
+})
+```
+
+Evolution audio downloads use `/chat/getBase64FromMediaMessage/{instance}` and AgentKit rejects unsafe Evolution base URLs before sending `EVOLUTION_API_KEY`; do not use localhost, private-network hosts, or HTTP base URLs.

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

@@ -0,0 +1,61 @@
+# WhatsApp Through UAZAPI
+
+Required secrets:
+
+```txt
+UAZAPI_BASE_URL
+UAZAPI_TOKEN
+```
+
+Optional hardening secret:
+
+```txt
+UAZAPI_WEBHOOK_TOKEN
+```
+
+Audio transcription also needs the configured transcription secret, usually `OPENAI_API_KEY` or `GROQ_API_KEY`.
+
+Commands:
+
+```sh
+agentkit deploy
+agentkit channels add whatsapp support-whatsapp --provider uazapi
+agentkit channels setup support-whatsapp --apply
+agentkit channels status support-whatsapp
+agentkit channels test support-whatsapp --message "hello"
+agentkit channels deliveries list support-whatsapp
+```
+
+AgentKit applies UAZAPI setup by calling `/webhook` with the stable hosted URL and then confirming that UAZAPI lists the configured webhook. If the channel declares `UAZAPI_WEBHOOK_TOKEN`, AgentKit appends `?token=<UAZAPI_WEBHOOK_TOKEN>` to the registered webhook URL.
+
+Inbound UAZAPI `messages` webhooks normalize text and audio messages. `fromMe` and `wasSentByApi` messages are skipped to avoid reply loops. Unsupported media should be logged as skipped/unsupported without creating an agent run.
+
+Outbound replies call UAZAPI `POST /send/text` with the `token` header and a JSON body containing `number`, `text`, `readchat`, `async`, `track_source`, and `track_id`. Only set `AGENTKIT_CHANNEL_SEND_DRY_RUN=1` in tests when UAZAPI should not receive a real message.
+
+Buffer rapid WhatsApp messages:
+
+```ts
+whatsappChannel({
+  name: "support-whatsapp",
+  provider: "uazapi",
+  buffer: {
+    mode: "debounce",
+    quietWindowMs: 2500,
+    maxWaitMs: 12000,
+    maxMessages: 20,
+    maxChars: 8000,
+  },
+})
+```
+
+Transcribe WhatsApp audio:
+
+```ts
+whatsappChannel({
+  name: "support-whatsapp",
+  provider: "uazapi",
+  audio: { mode: "transcribe" },
+})
+```
+
+UAZAPI audio downloads use `/message/download` with `return_base64: true`, `return_link: false`, `generate_mp3: false`, and `transcribe: false`. AgentKit rejects unsafe UAZAPI base URLs before sending `UAZAPI_TOKEN`; do not use localhost, private-network hosts, or HTTP base URLs.