@automagik/omni 2.260729.3 → 2.260730.1

package/db/drizzle/0042_whatsapp_cloud_channel.sql

@@ -0,0 +1,65 @@
+-- WhatsApp Cloud (Meta Cloud API) channel — Group 1 foundation.
+--
+-- Adds:
+--   * Per-instance Meta config columns on `instances` (phone_number_id, waba_id,
+--     access_token, app_id, business_id, api_version, connection_method,
+--     display_phone_number, connected_at).
+--   * New `whatsapp_templates` table for HSM templates (synced with Meta).
+--   * Index on `instances.meta_phone_number_id` for webhook resolution
+--     (Meta webhook is global; instance is looked up by phone_number_id).
+--
+-- Hand-written to mirror the pattern of 0034_instances_require_genie_signature.
+-- Run `bunx drizzle-kit generate` after `bun install` to (re)align the
+-- snapshot if the schema diverges from what's encoded here.
+
+-- NOTE: no explicit BEGIN/COMMIT — the boot migrator executes this file on a
+-- pooled postgres-js connection, which rejects raw transaction control
+-- (UNSAFE_TRANSACTION). The file is a single batch (no statement-breakpoints),
+-- so it executes atomically anyway, and every statement is idempotent.
+
+-- --------------------------------------------------------------------------
+-- instances: WhatsApp Cloud per-instance config
+-- --------------------------------------------------------------------------
+ALTER TABLE "instances"
+  ADD COLUMN IF NOT EXISTS "meta_phone_number_id" varchar(64),
+  ADD COLUMN IF NOT EXISTS "meta_waba_id" varchar(64),
+  ADD COLUMN IF NOT EXISTS "meta_access_token" text,
+  ADD COLUMN IF NOT EXISTS "meta_app_id" varchar(64),
+  ADD COLUMN IF NOT EXISTS "meta_business_id" varchar(64),
+  ADD COLUMN IF NOT EXISTS "meta_api_version" varchar(16) DEFAULT 'v25.0' NOT NULL,
+  ADD COLUMN IF NOT EXISTS "meta_connection_method" varchar(32) DEFAULT 'manual',
+  ADD COLUMN IF NOT EXISTS "meta_display_phone_number" varchar(32),
+  ADD COLUMN IF NOT EXISTS "meta_connected_at" timestamptz;
+
+CREATE INDEX IF NOT EXISTS "instances_meta_phone_number_idx"
+  ON "instances" ("meta_phone_number_id");
+
+-- --------------------------------------------------------------------------
+-- whatsapp_templates: HSM templates (Meta Graph API mirror)
+-- --------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS "whatsapp_templates" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  "instance_id" uuid NOT NULL REFERENCES "instances"("id") ON DELETE CASCADE,
+  "meta_id" varchar(64),
+  "waba_id" varchar(64) NOT NULL,
+  "name" varchar(255) NOT NULL,
+  "language" varchar(16) DEFAULT 'pt_BR' NOT NULL,
+  "category" varchar(32) NOT NULL,
+  "status" varchar(32) DEFAULT 'PENDING' NOT NULL,
+  "components" jsonb,
+  "variable_mapping" jsonb,
+  "rejection_reason" text,
+  "quality_score" varchar(16),
+  "created_at" timestamptz DEFAULT now() NOT NULL,
+  "updated_at" timestamptz DEFAULT now() NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS "idx_wa_tpl_instance"
+  ON "whatsapp_templates" ("instance_id");
+
+CREATE UNIQUE INDEX IF NOT EXISTS "idx_wa_tpl_instance_name_lang"
+  ON "whatsapp_templates" ("instance_id", "name", "language");
+
+CREATE INDEX IF NOT EXISTS "idx_wa_tpl_status"
+  ON "whatsapp_templates" ("status");
+

package/db/drizzle/meta/_journal.json

@@ -295,6 +295,13 @@
       "when": 1784100000000,
       "tag": "0041_tenant_ownership_columns",
       "breakpoints": true
+    },
+    {
+      "idx": 42,
+      "version": "7",
+      "when": 1784200000000,
+      "tag": "0042_whatsapp_cloud_channel",
+      "breakpoints": true
     }
   ]
 }

package/dist/commands/instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/commands/instances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqMpC,wBAAgB,sBAAsB,IAAI,OAAO,CA0vChD"}
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/commands/instances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqMpC,wBAAgB,sBAAsB,IAAI,OAAO,CAwzChD"}

package/dist/index.js

@@ -8184,7 +8184,9 @@ var init_types2 = __esm(() => {
     "voice.stream_ended",
     "voice.session_ended",
     "voice.user_joined_channel",
-    "voice.user_left_channel"
+    "voice.user_left_channel",
+    "template.status_changed",
+    "channel.alert"
   ];
 });
 // ../core/src/events/envelope.ts
@@ -32227,6 +32229,268 @@ var init_person = __esm(() => {
   });
 });
 
+// ../core/src/schemas/whatsapp-cloud.ts
+var MetaTemplateCategorySchema, MetaTemplateStatusSchema, MetaTemplateQualityScoreSchema, MetaTemplateHeaderComponentSchema, MetaTemplateBodyComponentSchema, MetaTemplateFooterComponentSchema, MetaTemplateButtonSchema, MetaTemplateButtonsComponentSchema, WhatsAppTemplateComponentSchema, InboundContextSchema, InboundMediaSchema, MetaInboundTextMessageSchema, MetaInboundMediaMessageSchema, MetaInboundLocationMessageSchema, MetaInboundContactsMessageSchema, MetaInboundReactionMessageSchema, MetaInboundInteractiveMessageSchema, MetaInboundButtonMessageSchema, MetaInboundMessageSchema, MetaWebhookStatusEntrySchema, MetaTemplateStatusUpdateSchema, MetaWebhookValueSchema, MetaWebhookChangeSchema, MetaWebhookEntrySchema, MetaWebhookPayloadSchema, EmbeddedSignupExchangeRequestSchema, EmbeddedSignupExchangeResponseSchema, WhatsAppCloudConnectRequestSchema, WhatsAppFlowSendSchema, WhatsAppCloudRegisterRequestSchema, SendTemplateRequestSchema;
+var init_whatsapp_cloud = __esm(() => {
+  init_zod();
+  init_common();
+  MetaTemplateCategorySchema = exports_external.enum(["MARKETING", "UTILITY", "AUTHENTICATION"]);
+  MetaTemplateStatusSchema = exports_external.enum(["APPROVED", "PENDING", "REJECTED", "PAUSED", "DELETED"]);
+  MetaTemplateQualityScoreSchema = exports_external.enum(["GREEN", "YELLOW", "RED", "UNKNOWN"]);
+  MetaTemplateHeaderComponentSchema = exports_external.object({
+    type: exports_external.literal("HEADER"),
+    format: exports_external.enum(["TEXT", "IMAGE", "VIDEO", "DOCUMENT", "LOCATION"]),
+    text: exports_external.string().optional(),
+    example: exports_external.object({
+      header_text: exports_external.array(exports_external.string()).optional(),
+      header_handle: exports_external.array(exports_external.string()).optional()
+    }).optional()
+  });
+  MetaTemplateBodyComponentSchema = exports_external.object({
+    type: exports_external.literal("BODY"),
+    text: exports_external.string(),
+    example: exports_external.object({
+      body_text: exports_external.array(exports_external.array(exports_external.string())).optional()
+    }).optional()
+  });
+  MetaTemplateFooterComponentSchema = exports_external.object({
+    type: exports_external.literal("FOOTER"),
+    text: exports_external.string()
+  });
+  MetaTemplateButtonSchema = exports_external.discriminatedUnion("type", [
+    exports_external.object({ type: exports_external.literal("QUICK_REPLY"), text: exports_external.string() }),
+    exports_external.object({
+      type: exports_external.literal("URL"),
+      text: exports_external.string(),
+      url: exports_external.string().url(),
+      example: exports_external.array(exports_external.string()).optional()
+    }),
+    exports_external.object({ type: exports_external.literal("PHONE_NUMBER"), text: exports_external.string(), phone_number: exports_external.string() }),
+    exports_external.object({ type: exports_external.literal("COPY_CODE"), example: exports_external.string() })
+  ]);
+  MetaTemplateButtonsComponentSchema = exports_external.object({
+    type: exports_external.literal("BUTTONS"),
+    buttons: exports_external.array(MetaTemplateButtonSchema).min(1).max(10)
+  });
+  WhatsAppTemplateComponentSchema = exports_external.discriminatedUnion("type", [
+    MetaTemplateHeaderComponentSchema,
+    MetaTemplateBodyComponentSchema,
+    MetaTemplateFooterComponentSchema,
+    MetaTemplateButtonsComponentSchema
+  ]);
+  InboundContextSchema = exports_external.object({
+    id: exports_external.string().optional(),
+    from: exports_external.string().optional(),
+    forwarded: exports_external.boolean().optional(),
+    frequently_forwarded: exports_external.boolean().optional()
+  });
+  InboundMediaSchema = exports_external.object({
+    id: exports_external.string(),
+    mime_type: exports_external.string().optional(),
+    sha256: exports_external.string().optional(),
+    caption: exports_external.string().optional(),
+    filename: exports_external.string().optional(),
+    voice: exports_external.boolean().optional()
+  });
+  MetaInboundTextMessageSchema = exports_external.object({
+    type: exports_external.literal("text"),
+    from: exports_external.string(),
+    id: exports_external.string(),
+    timestamp: exports_external.string(),
+    text: exports_external.object({ body: exports_external.string() }),
+    context: InboundContextSchema.optional()
+  });
+  MetaInboundMediaMessageSchema = exports_external.object({
+    type: exports_external.enum(["image", "audio", "video", "document", "sticker"]),
+    from: exports_external.string(),
+    id: exports_external.string(),
+    timestamp: exports_external.string(),
+    image: InboundMediaSchema.optional(),
+    audio: InboundMediaSchema.optional(),
+    video: InboundMediaSchema.optional(),
+    document: InboundMediaSchema.optional(),
+    sticker: InboundMediaSchema.optional(),
+    context: InboundContextSchema.optional()
+  });
+  MetaInboundLocationMessageSchema = exports_external.object({
+    type: exports_external.literal("location"),
+    from: exports_external.string(),
+    id: exports_external.string(),
+    timestamp: exports_external.string(),
+    location: exports_external.object({
+      latitude: exports_external.number(),
+      longitude: exports_external.number(),
+      name: exports_external.string().optional(),
+      address: exports_external.string().optional()
+    }),
+    context: InboundContextSchema.optional()
+  });
+  MetaInboundContactsMessageSchema = exports_external.object({
+    type: exports_external.literal("contacts"),
+    from: exports_external.string(),
+    id: exports_external.string(),
+    timestamp: exports_external.string(),
+    contacts: exports_external.array(exports_external.object({
+      name: exports_external.object({ formatted_name: exports_external.string().optional(), first_name: exports_external.string().optional() }).passthrough(),
+      phones: exports_external.array(exports_external.object({ phone: exports_external.string().optional(), wa_id: exports_external.string().optional() }).passthrough()).optional()
+    }).passthrough()),
+    context: InboundContextSchema.optional()
+  });
+  MetaInboundReactionMessageSchema = exports_external.object({
+    type: exports_external.literal("reaction"),
+    from: exports_external.string(),
+    id: exports_external.string(),
+    timestamp: exports_external.string(),
+    reaction: exports_external.object({
+      message_id: exports_external.string(),
+      emoji: exports_external.string()
+    })
+  });
+  MetaInboundInteractiveMessageSchema = exports_external.object({
+    type: exports_external.literal("interactive"),
+    from: exports_external.string(),
+    id: exports_external.string(),
+    timestamp: exports_external.string(),
+    interactive: exports_external.object({
+      type: exports_external.enum(["button_reply", "list_reply", "nfm_reply"]),
+      button_reply: exports_external.object({ id: exports_external.string(), title: exports_external.string() }).optional(),
+      list_reply: exports_external.object({ id: exports_external.string(), title: exports_external.string(), description: exports_external.string().optional() }).optional(),
+      nfm_reply: exports_external.object({ response_json: exports_external.string(), body: exports_external.string().optional(), name: exports_external.string().optional() }).optional()
+    }),
+    context: InboundContextSchema.optional()
+  });
+  MetaInboundButtonMessageSchema = exports_external.object({
+    type: exports_external.literal("button"),
+    from: exports_external.string(),
+    id: exports_external.string(),
+    timestamp: exports_external.string(),
+    button: exports_external.object({ payload: exports_external.string(), text: exports_external.string() }),
+    context: InboundContextSchema.optional()
+  });
+  MetaInboundMessageSchema = exports_external.union([
+    MetaInboundTextMessageSchema,
+    MetaInboundMediaMessageSchema,
+    MetaInboundLocationMessageSchema,
+    MetaInboundContactsMessageSchema,
+    MetaInboundReactionMessageSchema,
+    MetaInboundInteractiveMessageSchema,
+    MetaInboundButtonMessageSchema
+  ]);
+  MetaWebhookStatusEntrySchema = exports_external.object({
+    id: exports_external.string(),
+    status: exports_external.enum(["sent", "delivered", "read", "failed"]),
+    timestamp: exports_external.string(),
+    recipient_id: exports_external.string(),
+    errors: exports_external.array(exports_external.object({
+      code: exports_external.number(),
+      title: exports_external.string(),
+      message: exports_external.string().optional(),
+      error_data: exports_external.object({ details: exports_external.string().optional() }).passthrough().optional()
+    }).passthrough()).optional(),
+    conversation: exports_external.object({
+      id: exports_external.string(),
+      origin: exports_external.object({ type: exports_external.string() }).passthrough().optional()
+    }).passthrough().optional(),
+    pricing: exports_external.object({
+      pricing_model: exports_external.string(),
+      billable: exports_external.boolean(),
+      category: exports_external.string()
+    }).passthrough().optional()
+  });
+  MetaTemplateStatusUpdateSchema = exports_external.object({
+    message_template_id: exports_external.string(),
+    message_template_name: exports_external.string(),
+    message_template_language: exports_external.string(),
+    event: exports_external.enum(["APPROVED", "REJECTED", "FLAGGED", "PAUSED", "DISABLED"]),
+    reason: exports_external.string().optional()
+  });
+  MetaWebhookValueSchema = exports_external.object({
+    messaging_product: exports_external.literal("whatsapp").optional(),
+    metadata: exports_external.object({
+      display_phone_number: exports_external.string(),
+      phone_number_id: exports_external.string()
+    }).optional(),
+    contacts: exports_external.array(exports_external.object({
+      profile: exports_external.object({ name: exports_external.string().optional() }).passthrough().optional(),
+      wa_id: exports_external.string().optional()
+    }).passthrough()).optional(),
+    messages: exports_external.array(MetaInboundMessageSchema).optional(),
+    statuses: exports_external.array(MetaWebhookStatusEntrySchema).optional(),
+    errors: exports_external.array(exports_external.object({
+      code: exports_external.number(),
+      title: exports_external.string(),
+      message: exports_external.string().optional()
+    }).passthrough()).optional()
+  });
+  MetaWebhookChangeSchema = exports_external.object({
+    field: exports_external.string(),
+    value: exports_external.union([MetaWebhookValueSchema, MetaTemplateStatusUpdateSchema, exports_external.record(exports_external.string(), exports_external.unknown())])
+  });
+  MetaWebhookEntrySchema = exports_external.object({
+    id: exports_external.string(),
+    changes: exports_external.array(MetaWebhookChangeSchema),
+    time: exports_external.number().optional()
+  });
+  MetaWebhookPayloadSchema = exports_external.object({
+    object: exports_external.literal("whatsapp_business_account"),
+    entry: exports_external.array(MetaWebhookEntrySchema)
+  });
+  EmbeddedSignupExchangeRequestSchema = exports_external.object({
+    code: exports_external.string().min(1)
+  });
+  EmbeddedSignupExchangeResponseSchema = exports_external.object({
+    exchangeHandle: exports_external.string(),
+    wabaIds: exports_external.array(exports_external.string()),
+    phoneNumbers: exports_external.array(exports_external.object({
+      phone_number_id: exports_external.string(),
+      wabaId: exports_external.string(),
+      display_phone_number: exports_external.string().optional(),
+      verified_name: exports_external.string().optional(),
+      quality_rating: exports_external.string().optional()
+    }))
+  });
+  WhatsAppCloudConnectRequestSchema = exports_external.object({
+    accessToken: exports_external.string().min(1).optional(),
+    exchangeHandle: exports_external.string().min(1).optional(),
+    phoneNumberId: exports_external.string().min(1),
+    wabaId: exports_external.string().min(1),
+    appId: exports_external.string().optional(),
+    businessId: exports_external.string().optional()
+  }).refine((v) => Boolean(v.accessToken) !== Boolean(v.exchangeHandle), {
+    message: "Provide exactly one of `accessToken` (manual flow) or `exchangeHandle` (Embedded Signup flow)",
+    path: ["accessToken"]
+  });
+  WhatsAppFlowSendSchema = exports_external.object({
+    flowId: exports_external.string().min(1).optional(),
+    flowName: exports_external.string().min(1).optional(),
+    cta: exports_external.string().min(1).max(30),
+    bodyText: exports_external.string().min(1).max(1024),
+    headerText: exports_external.string().max(60).optional(),
+    footerText: exports_external.string().max(60).optional(),
+    screen: exports_external.string().optional(),
+    data: exports_external.record(exports_external.string(), exports_external.unknown()).optional(),
+    flowToken: exports_external.string().optional(),
+    draft: exports_external.boolean().optional()
+  }).refine((v) => Boolean(v.flowId) !== Boolean(v.flowName), {
+    message: "Provide exactly one of flowId or flowName",
+    path: ["flowId"]
+  });
+  WhatsAppCloudRegisterRequestSchema = exports_external.object({
+    pin: exports_external.string().regex(/^\d{6}$/, "PIN must be exactly 6 digits").optional()
+  });
+  SendTemplateRequestSchema = exports_external.object({
+    to: PhoneSchema,
+    templateName: exports_external.string().min(1),
+    language: exports_external.string().min(2).default("pt_BR"),
+    variables: exports_external.record(exports_external.string(), exports_external.string()).default({}),
+    headerMedia: exports_external.object({
+      type: exports_external.enum(["image", "video", "document"]),
+      url: exports_external.string().url().optional(),
+      handle: exports_external.string().optional()
+    }).optional()
+  });
+});
+
 // ../core/src/schemas/index.ts
 var init_schemas = __esm(() => {
   init_agent2();
@@ -32240,6 +32504,7 @@ var init_schemas = __esm(() => {
   init_instance();
   init_message();
   init_person();
+  init_whatsapp_cloud();
 });
 
 // ../core/src/types/channel.ts
@@ -32272,6 +32537,9 @@ var init_channel = __esm(() => {
     "live_location",
     "product",
     "pix",
+    "template",
+    "location_request",
+    "flow",
     "edit",
     "delete",
     "unknown"
@@ -32281,6 +32549,14 @@ var init_channel = __esm(() => {
   RULE_TYPES = ["allow", "deny"];
 });
 
+// ../core/src/types/whatsapp-cloud.ts
+var META_TEMPLATE_CATEGORIES, META_TEMPLATE_STATUSES, META_TEMPLATE_QUALITY_SCORES;
+var init_whatsapp_cloud2 = __esm(() => {
+  META_TEMPLATE_CATEGORIES = ["MARKETING", "UTILITY", "AUTHENTICATION"];
+  META_TEMPLATE_STATUSES = ["APPROVED", "PENDING", "REJECTED", "PAUSED", "DELETED"];
+  META_TEMPLATE_QUALITY_SCORES = ["GREEN", "YELLOW", "RED", "UNKNOWN"];
+});
+
 // ../core/src/types/index.ts
 function ok(value) {
   return { ok: true, value };
@@ -32292,6 +32568,7 @@ var SETTING_VALUE_TYPES;
 var init_types5 = __esm(() => {
   init_channel();
   init_agent();
+  init_whatsapp_cloud2();
   SETTING_VALUE_TYPES = ["string", "integer", "boolean", "json", "secret"];
 });
 
@@ -66871,6 +67148,10 @@ __export(exports_src, {
   armSequence: () => armSequence,
   appUptime: () => appUptime,
   agentStateKey: () => agentStateKey,
+  WhatsAppTemplateComponentSchema: () => WhatsAppTemplateComponentSchema,
+  WhatsAppFlowSendSchema: () => WhatsAppFlowSendSchema,
+  WhatsAppCloudRegisterRequestSchema: () => WhatsAppCloudRegisterRequestSchema,
+  WhatsAppCloudConnectRequestSchema: () => WhatsAppCloudConnectRequestSchema,
   WebhookAgentProvider: () => WebhookAgentProvider,
   ValidationError: () => ValidationError2,
   UuidSchema: () => UuidSchema,
@@ -66891,6 +67172,7 @@ __export(exports_src, {
   SplitDelayModeSchema: () => SplitDelayModeSchema,
   SettingValueTypeSchema: () => SettingValueTypeSchema,
   SetAgentStateSchema: () => SetAgentStateSchema,
+  SendTemplateRequestSchema: () => SendTemplateRequestSchema,
   SendResultSchema: () => SendResultSchema,
   Scheduler: () => Scheduler,
   STREAM_NAMES: () => STREAM_NAMES,
@@ -66922,7 +67204,32 @@ __export(exports_src, {
   NatsGenieProvider: () => NatsGenieProvider,
   NatsEventBus: () => NatsEventBus,
   MetadataSchema: () => MetadataSchema,
+  MetaWebhookValueSchema: () => MetaWebhookValueSchema,
+  MetaWebhookStatusEntrySchema: () => MetaWebhookStatusEntrySchema,
+  MetaWebhookPayloadSchema: () => MetaWebhookPayloadSchema,
+  MetaWebhookEntrySchema: () => MetaWebhookEntrySchema,
+  MetaWebhookChangeSchema: () => MetaWebhookChangeSchema,
+  MetaTemplateStatusUpdateSchema: () => MetaTemplateStatusUpdateSchema,
+  MetaTemplateStatusSchema: () => MetaTemplateStatusSchema,
+  MetaTemplateQualityScoreSchema: () => MetaTemplateQualityScoreSchema,
+  MetaTemplateHeaderComponentSchema: () => MetaTemplateHeaderComponentSchema,
+  MetaTemplateFooterComponentSchema: () => MetaTemplateFooterComponentSchema,
+  MetaTemplateCategorySchema: () => MetaTemplateCategorySchema,
+  MetaTemplateButtonsComponentSchema: () => MetaTemplateButtonsComponentSchema,
+  MetaTemplateButtonSchema: () => MetaTemplateButtonSchema,
+  MetaTemplateBodyComponentSchema: () => MetaTemplateBodyComponentSchema,
+  MetaInboundTextMessageSchema: () => MetaInboundTextMessageSchema,
+  MetaInboundReactionMessageSchema: () => MetaInboundReactionMessageSchema,
+  MetaInboundMessageSchema: () => MetaInboundMessageSchema,
+  MetaInboundMediaMessageSchema: () => MetaInboundMediaMessageSchema,
+  MetaInboundLocationMessageSchema: () => MetaInboundLocationMessageSchema,
+  MetaInboundInteractiveMessageSchema: () => MetaInboundInteractiveMessageSchema,
+  MetaInboundContactsMessageSchema: () => MetaInboundContactsMessageSchema,
+  MetaInboundButtonMessageSchema: () => MetaInboundButtonMessageSchema,
   MIN_HOOK_PRIORITY: () => MIN_HOOK_PRIORITY,
+  META_TEMPLATE_STATUSES: () => META_TEMPLATE_STATUSES,
+  META_TEMPLATE_QUALITY_SCORES: () => META_TEMPLATE_QUALITY_SCORES,
+  META_TEMPLATE_CATEGORIES: () => META_TEMPLATE_CATEGORIES,
   MESSAGING_WINDOW_MS: () => MESSAGING_WINDOW_MS,
   MAX_HOOK_PRIORITY: () => MAX_HOOK_PRIORITY,
   MAX_HOOKS_PER_INSTANCE: () => MAX_HOOKS_PER_INSTANCE,
@@ -66957,6 +67264,8 @@ __export(exports_src, {
   EventStatusSchema: () => EventStatusSchema,
   EventRegistry: () => EventRegistry,
   EventQuerySchema: () => EventQuerySchema,
+  EmbeddedSignupExchangeResponseSchema: () => EmbeddedSignupExchangeResponseSchema,
+  EmbeddedSignupExchangeRequestSchema: () => EmbeddedSignupExchangeRequestSchema,
   EmailSchema: () => EmailSchema,
   EgressLimitError: () => EgressLimitError,
   EgressBlockedError: () => EgressBlockedError,
@@ -72319,6 +72628,7 @@ var init_pg_core = __esm(() => {
 // ../db/src/schema.ts
 var exports_schema = {};
 __export(exports_schema, {
+  whatsappTemplates: () => whatsappTemplates,
   webhookSources: () => webhookSources,
   turnsRelations: () => turnsRelations,
   turns: () => turns,
@@ -72448,7 +72758,7 @@ __export(exports_schema, {
   accessRules: () => accessRules,
   accessModes: () => accessModes
 });
-var channelTypes, agentTypes, agentSystems, agentEntityTypes, debounceMode, splitDelayMode, supersedeMode, replyFilterMode, agentSessionStrategies, ruleTypes, accessModes, settingValueTypes, apiKeyStatuses, apiKeyProfiles, eventTypes, contentTypes, chatTypes, messageSources, messageTypes, messageStatuses, deliveryStatuses, jobStatuses, providerSchemas, agentProviders, agents, agentRoutes, agentSessions, apiKeys, apiKeyAuditLogs, apiKeysRelations, apiKeyAuditLogsRelations, instances, persons, platformIdentities, conversations, chats, chatParticipants, omniGroups, messages2, omniEvents, handoffLogs, closeContactOutcomes, closeContactLogs, accessRules, globalSettings, settingChangeHistory, batchJobs, syncJobTypes, syncJobs, mediaContent, chatIdMappings, pluginStorage, agentProvidersRelations, agentsRelations, instancesRelations, syncJobsRelations, personsRelations, platformIdentitiesRelations, conversationsRelations, chatsRelations, chatParticipantsRelations, messagesRelations, omniEventsRelations, accessRulesRelations, globalSettingsRelations, settingChangeHistoryRelations, batchJobsRelations, mediaContentRelations, chatIdMappingsRelations, deadLetterStatuses, deadLetterEvents, payloadStorageConfig, payloadStages, eventPayloads, webhookSources, conditionOperators, actionTypes, automationDebounceModes, automations2, automationLogStatuses, automationLogs, consumerOffsets, automationsRelations, automationLogsRelations, triggerLogs, triggerLogsRelations, agentRoutesRelations, agentTaskStatuses, agentTasks, agentTasksRelations, turnStatuses, turnActions, turns, turnsRelations, followUpDisarmReasons, chatFollowUpState, chatFollowUpStateRelations, processedEvents, genieHosts, tenantStatuses, principalTypes, principalStatuses, tenantRoles, membershipStatuses, credentialClasses, authCredentialStatuses, platformApiKeyStatuses, tenants, principals, tenantMemberships, tenantRolePolicies, platformApiKeys, tenantKeyLineage, authCredentials, tenantAuditLogs, platformAuditLogs, platformProviderCatalog, tenantProviderConfig, platformSettings, tenantSettings, platformSettingChangeHistory, tenantSettingChangeHistory, platformPluginStorage, tenantPluginStorage, platformPayloadStorageConfig, tenantPayloadStorageOverrides, tenantMigrationLedger, tenantMigrationLedgerHistory;
+var channelTypes, agentTypes, agentSystems, agentEntityTypes, debounceMode, splitDelayMode, supersedeMode, replyFilterMode, agentSessionStrategies, ruleTypes, accessModes, settingValueTypes, apiKeyStatuses, apiKeyProfiles, eventTypes, contentTypes, chatTypes, messageSources, messageTypes, messageStatuses, deliveryStatuses, jobStatuses, providerSchemas, agentProviders, agents, agentRoutes, agentSessions, apiKeys, apiKeyAuditLogs, apiKeysRelations, apiKeyAuditLogsRelations, instances, whatsappTemplates, persons, platformIdentities, conversations, chats, chatParticipants, omniGroups, messages2, omniEvents, handoffLogs, closeContactOutcomes, closeContactLogs, accessRules, globalSettings, settingChangeHistory, batchJobs, syncJobTypes, syncJobs, mediaContent, chatIdMappings, pluginStorage, agentProvidersRelations, agentsRelations, instancesRelations, syncJobsRelations, personsRelations, platformIdentitiesRelations, conversationsRelations, chatsRelations, chatParticipantsRelations, messagesRelations, omniEventsRelations, accessRulesRelations, globalSettingsRelations, settingChangeHistoryRelations, batchJobsRelations, mediaContentRelations, chatIdMappingsRelations, deadLetterStatuses, deadLetterEvents, payloadStorageConfig, payloadStages, eventPayloads, webhookSources, conditionOperators, actionTypes, automationDebounceModes, automations2, automationLogStatuses, automationLogs, consumerOffsets, automationsRelations, automationLogsRelations, triggerLogs, triggerLogsRelations, agentRoutesRelations, agentTaskStatuses, agentTasks, agentTasksRelations, turnStatuses, turnActions, turns, turnsRelations, followUpDisarmReasons, chatFollowUpState, chatFollowUpStateRelations, processedEvents, genieHosts, tenantStatuses, principalTypes, principalStatuses, tenantRoles, membershipStatuses, credentialClasses, authCredentialStatuses, platformApiKeyStatuses, tenants, principals, tenantMemberships, tenantRolePolicies, platformApiKeys, tenantKeyLineage, authCredentials, tenantAuditLogs, platformAuditLogs, platformProviderCatalog, tenantProviderConfig, platformSettings, tenantSettings, platformSettingChangeHistory, tenantSettingChangeHistory, platformPluginStorage, tenantPluginStorage, platformPayloadStorageConfig, tenantPayloadStorageOverrides, tenantMigrationLedger, tenantMigrationLedgerHistory;
 var init_schema2 = __esm(() => {
   init_events();
   init_drizzle_orm();
@@ -72748,6 +73058,15 @@ var init_schema2 = __esm(() => {
     twilioStatusCallbackUrl: text("twilio_status_callback_url"),
     twilioWebhookUrl: text("twilio_webhook_url"),
     twilioValidateSignature: boolean("twilio_validate_signature").notNull().default(true),
+    metaPhoneNumberId: varchar("meta_phone_number_id", { length: 64 }),
+    metaWabaId: varchar("meta_waba_id", { length: 64 }),
+    metaAccessToken: text("meta_access_token"),
+    metaAppId: varchar("meta_app_id", { length: 64 }),
+    metaBusinessId: varchar("meta_business_id", { length: 64 }),
+    metaApiVersion: varchar("meta_api_version", { length: 16 }).notNull().default("v25.0"),
+    metaConnectionMethod: varchar("meta_connection_method", { length: 32 }).default("manual"),
+    metaDisplayPhoneNumber: varchar("meta_display_phone_number", { length: 32 }),
+    metaConnectedAt: timestamp("meta_connected_at", { withTimezone: true }),
     agentId: uuid("agent_id").references(() => agents.id, { onDelete: "set null" }),
     agentTimeout: integer("agent_timeout").notNull().default(600),
     agentStreamMode: boolean("agent_stream_mode").notNull().default(false),
@@ -72828,8 +73147,29 @@ var init_schema2 = __esm(() => {
     isActiveIdx: index("instances_is_active_idx").on(table3.isActive),
     isDefaultIdx: index("instances_is_default_idx").on(table3.isDefault),
     agentIdIdx: index("instances_agent_id_idx").on(table3.agentId),
+    metaPhoneNumberIdx: index("instances_meta_phone_number_idx").on(table3.metaPhoneNumberId),
     chainModeCheck: check("instances_chain_mode_check", sql`${table3.chainMode} IN ('off', 'forward', 'bidirectional')`)
   }));
+  whatsappTemplates = pgTable("whatsapp_templates", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    instanceId: uuid("instance_id").notNull().references(() => instances.id, { onDelete: "cascade" }),
+    metaId: varchar("meta_id", { length: 64 }),
+    wabaId: varchar("waba_id", { length: 64 }).notNull(),
+    name: varchar("name", { length: 255 }).notNull(),
+    language: varchar("language", { length: 16 }).notNull().default("pt_BR"),
+    category: varchar("category", { length: 32 }).notNull(),
+    status: varchar("status", { length: 32 }).notNull().default("PENDING"),
+    components: jsonb("components").$type(),
+    variableMapping: jsonb("variable_mapping").$type(),
+    rejectionReason: text("rejection_reason"),
+    qualityScore: varchar("quality_score", { length: 16 }),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+  }, (t) => ({
+    instanceIdx: index("idx_wa_tpl_instance").on(t.instanceId),
+    instanceNameLangUnique: uniqueIndex("idx_wa_tpl_instance_name_lang").on(t.instanceId, t.name, t.language),
+    statusIdx: index("idx_wa_tpl_status").on(t.status)
+  }));
   persons = pgTable("persons", {
     id: uuid("id").primaryKey().defaultRandom(),
     displayName: varchar("display_name", { length: 255 }),
@@ -127312,7 +127652,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260729.3",
+  version: "2.260730.1",
   description: "LLM-optimized CLI for Omni",
   type: "module",
   bin: {
@@ -127373,6 +127713,7 @@ var package_default = {
     "@omni/channel-slack": "workspace:*",
     "@omni/channel-telegram": "workspace:*",
     "@omni/channel-whatsapp": "workspace:*",
+    "@omni/channel-whatsapp-cloud": "workspace:*",
     "@omni/core": "workspace:*",
     "@omni/sdk": "workspace:*",
     "@types/node": "^22.10.3",
@@ -135169,10 +135510,45 @@ function createInstancesCommand() {
       error(`Failed to request pairing code: ${message}`);
     }
   });
-  instances.command("connect <id>").description("Connect an instance").option("--force-new-qr", "Force generation of new QR code").option("--token <token>", "Discord bot token (for Discord instances)").option("--twilio-account-sid <sid>", "Twilio Account SID").option("--twilio-auth-token <token>", "Twilio Auth Token").option("--twilio-from <address>", "Twilio WhatsApp sender address (whatsapp:+E164)").option("--twilio-messaging-service-sid <sid>", "Twilio Messaging Service SID").option("--twilio-status-callback-url <url>", "Twilio outbound status callback URL").option("--twilio-webhook-url <url>", "Public Twilio webhook URL for signature validation").option("--twilio-validate-signature", "Validate X-Twilio-Signature on webhooks").option("--no-twilio-validate-signature", "Disable X-Twilio-Signature validation").action(async (rawId, options) => {
+  instances.command("connect <id>").description("Connect an instance").option("--force-new-qr", "Force generation of new QR code").option("--token <token>", "Discord bot token (for Discord instances)").option("--twilio-account-sid <sid>", "Twilio Account SID").option("--twilio-auth-token <token>", "Twilio Auth Token").option("--twilio-from <address>", "Twilio WhatsApp sender address (whatsapp:+E164)").option("--twilio-messaging-service-sid <sid>", "Twilio Messaging Service SID").option("--twilio-status-callback-url <url>", "Twilio outbound status callback URL").option("--twilio-webhook-url <url>", "Public Twilio webhook URL for signature validation").option("--twilio-validate-signature", "Validate X-Twilio-Signature on webhooks").option("--no-twilio-validate-signature", "Disable X-Twilio-Signature validation").option("--access-token <token>", "WhatsApp Cloud (Meta) access token \u2014 pair with --phone-number-id + --waba-id").option("--phone-number-id <id>", "WhatsApp Cloud phone_number_id (Graph API id, not E.164)").option("--waba-id <id>", "WhatsApp Business Account id (WABA id)").option("--meta-app-id <id>", "Optional override for META_APP_ID (when the tenant owns its own Meta App)").option("--meta-business-id <id>", "Optional Meta Business Manager id").action(async (rawId, options) => {
     const client = getClient();
     try {
       const id = await resolveInstanceId(rawId);
+      const wantsWhatsAppCloud = options.accessToken && options.phoneNumberId && options.wabaId;
+      if (wantsWhatsAppCloud) {
+        const instance = await client.instances.get(id);
+        if (instance.channel !== "whatsapp-cloud") {
+          error(`Instance ${id} is not a whatsapp-cloud instance (channel=${instance.channel}). --access-token/--phone-number-id/--waba-id only apply to whatsapp-cloud.`);
+          return;
+        }
+        const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_config(), exports_config));
+        const cfg = loadConfig2();
+        const baseUrl = cfg.apiUrl ?? "http://localhost:8882";
+        const apiKey = cfg.apiKey ?? "";
+        const resp = await fetch(`${baseUrl}/api/v2/instances/${id}/whatsapp-cloud/connect`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json", "x-api-key": apiKey },
+          body: JSON.stringify({
+            accessToken: options.accessToken,
+            phoneNumberId: options.phoneNumberId,
+            wabaId: options.wabaId,
+            appId: options.metaAppId,
+            businessId: options.metaBusinessId
+          })
+        });
+        if (!resp.ok) {
+          const err = await resp.json().catch(() => ({}));
+          error(`Failed to connect: ${err?.error?.message ?? `HTTP ${resp.status}`}`);
+          return;
+        }
+        const result2 = await resp.json();
+        success("Instance connected via WhatsApp Cloud (manual)", {
+          status: result2.data?.status ?? "connected",
+          displayPhoneNumber: result2.data?.displayPhoneNumber ?? null,
+          qualityRating: result2.data?.qualityRating ?? null
+        });
+        return;
+      }
       const result = await client.instances.connect(id, {
         forceNewQr: options.forceNewQr,
         token: options.token,

package/dist/sdk/types.generated.d.ts

@@ -2852,6 +2852,18 @@ export interface components {
             text: string;
             /** @description Message ID to reply to */
             replyTo?: string;
+            /** @description Inline buttons — mapped natively per channel (WhatsApp Cloud: up to 3 reply buttons, 4-10 become a list; Telegram: inline keyboard) */
+            buttons?: {
+                /** @description Button label */
+                text: string;
+                /** @description Callback payload (reply button / list row id) */
+                data?: string;
+                /**
+                 * Format: uri
+                 * @description Link button URL (mutually exclusive with data)
+                 */
+                url?: string;
+            }[];
         };
         TTSVoice: {
             /** @description ElevenLabs voice ID */
@@ -7401,6 +7413,18 @@ export interface operations {
                     text: string;
                     /** @description Message ID to reply to */
                     replyTo?: string;
+                    /** @description Inline buttons — mapped natively per channel (WhatsApp Cloud: up to 3 reply buttons, 4-10 become a list; Telegram: inline keyboard) */
+                    buttons?: {
+                        /** @description Button label */
+                        text: string;
+                        /** @description Callback payload (reply button / list row id) */
+                        data?: string;
+                        /**
+                         * Format: uri
+                         * @description Link button URL (mutually exclusive with data)
+                         */
+                        url?: string;
+                    }[];
                 };
             };
         };