n8n 2.46.3 → 2.47.0

package/dist/modules/agents/integrations/platforms/whatsapp/whatsapp-credential-check.service.d.ts

@@ -1,16 +1,21 @@
-import type { WhatsAppCredentialCheck } from '@n8n/api-types';
+import type { WhatsAppCredentialCheck, WhatsAppMetaStatus } from '@n8n/api-types';
 import { Logger } from '@n8n/backend-common';
 import { OutboundHttp } from '@n8n/backend-network';
 import { AgentsConfig } from '@n8n/config';
 import type { User } from '@n8n/db';
 import { AgentCredentialLookupService } from '../../agent-credential-lookup.service';
+export declare const GRAPH_API_BASE_URL = "https://graph.facebook.com/v25.0";
 export declare class WhatsAppCredentialCheckService {
     private readonly credentialLookup;
     private readonly outboundHttp;
     private readonly logger;
     private readonly agentsConfig;
+    private readonly metaStatusCache;
+    private readonly metaStatusInFlight;
     constructor(credentialLookup: AgentCredentialLookupService, outboundHttp: OutboundHttp, logger: Logger, agentsConfig: AgentsConfig);
     check(user: User, projectId: string, credentialId: string): Promise<WhatsAppCredentialCheck>;
+    getMetaStatus(user: User, projectId: string, credentialId: string): Promise<WhatsAppMetaStatus>;
+    private readMetaStatus;
     private tokenExpiry;
     private refused;
     private get;

package/dist/modules/agents/integrations/platforms/whatsapp/whatsapp-credential-check.service.js

@@ -9,7 +9,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WhatsAppCredentialCheckService = void 0;
+exports.WhatsAppCredentialCheckService = exports.GRAPH_API_BASE_URL = void 0;
 const backend_common_1 = require("@n8n/backend-common");
 const backend_network_1 = require("@n8n/backend-network");
 const config_1 = require("@n8n/config");
@@ -17,21 +17,27 @@ const di_1 = require("@n8n/di");
 const errors_1 = require("@n8n/errors");
 const ensure_error_1 = require("@n8n/utils/errors/ensure-error");
 const is_record_1 = require("@n8n/utils/is-record");
+const lru_cache_1 = require("@n8n/utils/lru-cache");
 const sanitize_error_detail_1 = require("@n8n/utils/redaction/sanitize-error-detail");
 const node_crypto_1 = require("node:crypto");
 const agent_credential_lookup_service_1 = require("../../agent-credential-lookup.service");
 const integration_helpers_1 = require("../../integration-helpers");
+const whatsapp_meta_status_1 = require("./whatsapp-meta-status");
 const WHATSAPP_CREDENTIAL_TYPE = 'whatsAppBotApi';
-const GRAPH_API_BASE_URL = 'https://graph.facebook.com/v25.0';
+exports.GRAPH_API_BASE_URL = 'https://graph.facebook.com/v25.0';
 const TEMPORARY_TOKEN_WINDOW_MS = 48 * 60 * 60 * 1000;
 const CHECK_TIMEOUT_MS = 30_000;
 const MAX_LOGGED_ERROR_LENGTH = 500;
+const META_STATUS_CACHE_TTL_MS = 30_000;
+const META_STATUS_CACHE_SIZE = 200;
 let WhatsAppCredentialCheckService = class WhatsAppCredentialCheckService {
     constructor(credentialLookup, outboundHttp, logger, agentsConfig) {
         this.credentialLookup = credentialLookup;
         this.outboundHttp = outboundHttp;
         this.logger = logger;
         this.agentsConfig = agentsConfig;
+        this.metaStatusCache = new lru_cache_1.LruCache(META_STATUS_CACHE_SIZE);
+        this.metaStatusInFlight = new Map();
     }
     async check(user, projectId, credentialId) {
         const data = await this.credentialLookup.decryptForUser(user, projectId, credentialId, WHATSAPP_CREDENTIAL_TYPE);
@@ -86,6 +92,74 @@ let WhatsAppCredentialCheckService = class WhatsAppCredentialCheckService {
             return { status: 'failed', reason: 'unreachable' };
         }
     }
+    async getMetaStatus(user, projectId, credentialId) {
+        const data = await this.credentialLookup.decryptForUser(user, projectId, credentialId, WHATSAPP_CREDENTIAL_TYPE);
+        if (!data)
+            throw new errors_1.NotFoundError(`WhatsApp credential "${credentialId}" not found`);
+        const accessToken = (0, integration_helpers_1.stringProperty)(data, 'accessToken')?.trim();
+        const phoneNumberId = (0, integration_helpers_1.stringProperty)(data, 'phoneNumberId')?.trim();
+        const businessAccountId = (0, integration_helpers_1.stringProperty)(data, 'businessAccountId')?.trim();
+        const appSecret = (0, integration_helpers_1.stringProperty)(data, 'appSecret')?.trim();
+        if (!accessToken || !phoneNumberId || !businessAccountId || !appSecret) {
+            return { state: 'unknown' };
+        }
+        const key = `${credentialId}:${phoneNumberId}:${businessAccountId}`;
+        const cached = this.metaStatusCache.get(key);
+        if (cached && cached.expiresAt > Date.now())
+            return cached.status;
+        const inFlight = this.metaStatusInFlight.get(key);
+        if (inFlight)
+            return await inFlight;
+        const read = this.readMetaStatus({ accessToken, phoneNumberId, businessAccountId, appSecret })
+            .then((status) => {
+            if (status.state !== 'unknown') {
+                this.metaStatusCache.set(key, {
+                    expiresAt: Date.now() + META_STATUS_CACHE_TTL_MS,
+                    status,
+                });
+            }
+            return status;
+        })
+            .finally(() => this.metaStatusInFlight.delete(key));
+        this.metaStatusInFlight.set(key, read);
+        return await read;
+    }
+    async readMetaStatus(credential) {
+        const { accessToken, phoneNumberId, businessAccountId, appSecret } = credential;
+        const proof = (0, node_crypto_1.createHmac)('sha256', appSecret).update(accessToken).digest('hex');
+        const get = async (path, qs) => await this.get(path, accessToken, { ...qs, appsecret_proof: proof });
+        try {
+            const [phone, account] = await Promise.all([
+                get(`/${encodeURIComponent(phoneNumberId)}`, {
+                    fields: 'status,name_status,new_name_status,messaging_limit_tier,verified_name,display_phone_number',
+                }),
+                get(`/${encodeURIComponent(businessAccountId)}`, {
+                    fields: 'business_verification_status',
+                }).catch(() => undefined),
+            ]);
+            if (phone.statusCode !== 200)
+                return { state: 'unknown' };
+            return {
+                state: (0, whatsapp_meta_status_1.resolveWhatsAppMetaState)({
+                    numberStatus: (0, integration_helpers_1.stringProperty)(phone.body, 'status'),
+                    nameStatus: (0, integration_helpers_1.stringProperty)(phone.body, 'name_status'),
+                    newNameStatus: (0, integration_helpers_1.stringProperty)(phone.body, 'new_name_status'),
+                    messagingLimitTier: (0, integration_helpers_1.stringProperty)(phone.body, 'messaging_limit_tier'),
+                    businessVerificationStatus: account?.statusCode === 200
+                        ? (0, integration_helpers_1.stringProperty)(account.body, 'business_verification_status')
+                        : undefined,
+                }),
+                displayName: (0, integration_helpers_1.stringProperty)(phone.body, 'verified_name'),
+                displayPhoneNumber: (0, integration_helpers_1.stringProperty)(phone.body, 'display_phone_number'),
+            };
+        }
+        catch (error) {
+            this.logger.debug('[WhatsAppCredentialCheck] Could not read the Meta status', {
+                error: (0, sanitize_error_detail_1.sanitizeErrorDetail)((0, ensure_error_1.ensureError)(error).message, MAX_LOGGED_ERROR_LENGTH),
+            });
+            return { state: 'unknown' };
+        }
+    }
     async tokenExpiry(accessToken, proof) {
         try {
             const response = await this.get('/debug_token', accessToken, {
@@ -115,7 +189,7 @@ let WhatsAppCredentialCheckService = class WhatsAppCredentialCheckService {
             .requests({ useDefaultSsrfPolicy: 'unsafe' })
             .request({
             method: 'GET',
-            url: `${GRAPH_API_BASE_URL}${path}`,
+            url: `${exports.GRAPH_API_BASE_URL}${path}`,
             qs,
             headers: { Authorization: `Bearer ${accessToken}` },
             json: true,

package/dist/modules/agents/integrations/platforms/whatsapp/whatsapp-credential-check.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"whatsapp-credential-check.service.js","sourceRoot":"","sources":["../../../../../../src/modules/agents/integrations/platforms/whatsapp/whatsapp-credential-check.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"whatsapp-credential-check.service.js","sourceRoot":"","sources":["../../../../../../src/modules/agents/integrations/platforms/whatsapp/whatsapp-credential-check.service.ts"],"names":[],"mappings":"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"}

package/dist/modules/agents/integrations/platforms/whatsapp/whatsapp-delivery-failures.d.ts

@@ -0,0 +1,24 @@
+export declare const WHATSAPP_REENGAGEMENT_ERROR_CODE = 131047;
+export declare const DELIVERY_FAILURE_MESSAGE_ID_SUFFIX = ":delivery-failed";
+export interface WindowClosedFailure {
+    messageId: string;
+    phoneNumberId: string;
+    recipientId: string;
+    timestamp: string;
+}
+export declare function parseWindowClosedFailures(payload: unknown): WindowClosedFailure[];
+export declare function isDeliveryFailureNotice(message: {
+    id: string;
+}): boolean;
+export declare function isRecentFailure(failure: WindowClosedFailure, now?: number): boolean;
+export declare const DELIVERY_FAILURE_NOTICE: string;
+export declare const DELIVERY_FAILURE_CHAT_NOTICE: string;
+export declare class DeliveryFailureRecoveryLimiter {
+    private readonly windowMs;
+    private readonly maxRecoveries;
+    private readonly maxTrackedMessageIds;
+    private readonly recoveryTimes;
+    private readonly seenMessageIds;
+    constructor(windowMs: number, maxRecoveries: number, maxTrackedMessageIds?: number);
+    tryAcquire(failure: WindowClosedFailure, now?: number): boolean;
+}

package/dist/modules/agents/integrations/platforms/whatsapp/whatsapp-delivery-failures.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryFailureRecoveryLimiter = exports.DELIVERY_FAILURE_CHAT_NOTICE = exports.DELIVERY_FAILURE_NOTICE = exports.DELIVERY_FAILURE_MESSAGE_ID_SUFFIX = exports.WHATSAPP_REENGAGEMENT_ERROR_CODE = void 0;
+exports.parseWindowClosedFailures = parseWindowClosedFailures;
+exports.isDeliveryFailureNotice = isDeliveryFailureNotice;
+exports.isRecentFailure = isRecentFailure;
+const is_record_1 = require("@n8n/utils/is-record");
+exports.WHATSAPP_REENGAGEMENT_ERROR_CODE = 131047;
+exports.DELIVERY_FAILURE_MESSAGE_ID_SUFFIX = ':delivery-failed';
+function parseWindowClosedFailures(payload) {
+    const failures = [];
+    if (!(0, is_record_1.isRecord)(payload) || !Array.isArray(payload.entry))
+        return failures;
+    for (const entry of payload.entry) {
+        if (!(0, is_record_1.isRecord)(entry) || !Array.isArray(entry.changes))
+            continue;
+        for (const change of entry.changes) {
+            if (!(0, is_record_1.isRecord)(change) || change.field !== 'messages' || !(0, is_record_1.isRecord)(change.value))
+                continue;
+            const { value } = change;
+            const phoneNumberId = (0, is_record_1.isRecord)(value.metadata) ? value.metadata.phone_number_id : undefined;
+            if (typeof phoneNumberId !== 'string' || !Array.isArray(value.statuses))
+                continue;
+            for (const status of value.statuses) {
+                if (!(0, is_record_1.isRecord)(status) || status.status !== 'failed')
+                    continue;
+                const { id, recipient_id: recipientId, timestamp, errors } = status;
+                if (typeof id !== 'string' || typeof recipientId !== 'string')
+                    continue;
+                const windowClosed = Array.isArray(errors) &&
+                    errors.some((error) => (0, is_record_1.isRecord)(error) && error.code === exports.WHATSAPP_REENGAGEMENT_ERROR_CODE);
+                if (!windowClosed)
+                    continue;
+                failures.push({
+                    messageId: id,
+                    phoneNumberId,
+                    recipientId,
+                    timestamp: typeof timestamp === 'string' ? timestamp : String(Math.floor(Date.now() / 1000)),
+                });
+            }
+        }
+    }
+    return failures;
+}
+const MAX_FAILURE_AGE_MS = 15 * 60 * 1000;
+function isDeliveryFailureNotice(message) {
+    return message.id.endsWith(exports.DELIVERY_FAILURE_MESSAGE_ID_SUFFIX);
+}
+function isRecentFailure(failure, now = Date.now()) {
+    const reportedAtMs = Number(failure.timestamp) * 1000;
+    return Number.isFinite(reportedAtMs) && now - reportedAtMs <= MAX_FAILURE_AGE_MS;
+}
+exports.DELIVERY_FAILURE_NOTICE = '[WhatsApp delivery notice. The customer did not write this message.] ' +
+    'Your last WhatsApp message to this customer was not delivered. ' +
+    'More than 24 hours have passed since the customer last replied, so WhatsApp refuses free-form messages. ' +
+    'Call list_templates and choose a template that fits what you wanted to say. ' +
+    'Then send it with send_template. Use only facts you know as placeholder values. ' +
+    'If no template fits, do not send one. ' +
+    'Do not write a normal reply to the customer, because it cannot be delivered. ' +
+    'End this turn with the do_not_respond action. ' +
+    'If no template fit, set input.reason to "not delivered, no suitable template".';
+exports.DELIVERY_FAILURE_CHAT_NOTICE = '[WhatsApp delivery notice. The customer did not write this message.] ' +
+    'Your last WhatsApp message to the customer was not delivered. ' +
+    'More than 24 hours have passed since the customer last replied, so WhatsApp refuses free-form messages. ' +
+    'Tell the user that the message was not delivered. ' +
+    'Then call list_templates. If an approved template fits what you wanted to say, send it with send_template and tell the user. ' +
+    'Use only facts you know as placeholder values. ' +
+    'If no template fits, do not send one. Tell the user that the customer cannot be reached until they message again.';
+class DeliveryFailureRecoveryLimiter {
+    constructor(windowMs, maxRecoveries, maxTrackedMessageIds = 1000) {
+        this.windowMs = windowMs;
+        this.maxRecoveries = maxRecoveries;
+        this.maxTrackedMessageIds = maxTrackedMessageIds;
+        this.recoveryTimes = new Map();
+        this.seenMessageIds = new Set();
+    }
+    tryAcquire(failure, now = Date.now()) {
+        if (this.seenMessageIds.has(failure.messageId))
+            return false;
+        this.seenMessageIds.add(failure.messageId);
+        if (this.seenMessageIds.size > this.maxTrackedMessageIds) {
+            const oldest = this.seenMessageIds.values().next();
+            if (!oldest.done)
+                this.seenMessageIds.delete(oldest.value);
+        }
+        const threadKey = `${failure.phoneNumberId}:${failure.recipientId}`;
+        const recent = (this.recoveryTimes.get(threadKey) ?? []).filter((time) => now - time < this.windowMs);
+        if (recent.length >= this.maxRecoveries) {
+            this.recoveryTimes.set(threadKey, recent);
+            return false;
+        }
+        this.recoveryTimes.set(threadKey, [...recent, now]);
+        return true;
+    }
+}
+exports.DeliveryFailureRecoveryLimiter = DeliveryFailureRecoveryLimiter;
+//# sourceMappingURL=whatsapp-delivery-failures.js.map

package/dist/modules/agents/integrations/platforms/whatsapp/whatsapp-delivery-failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-delivery-failures.js","sourceRoot":"","sources":["../../../../../../src/modules/agents/integrations/platforms/whatsapp/whatsapp-delivery-failures.ts"],"names":[],"mappings":"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"}

package/dist/modules/agents/integrations/platforms/whatsapp/whatsapp-integration.d.ts

@@ -1,10 +1,15 @@
-import { type AgentIntegrationConfig, type RichCardComponentType } from '@n8n/api-types';
+import { type AgentIntegrationConfig, type AgentIntegrationDisconnectWarning, type RichCardComponentType } from '@n8n/api-types';
 import { Logger } from '@n8n/backend-common';
+import { OutboundHttp } from '@n8n/backend-network';
+import type { ActionEvent, Message } from 'chat';
 import { InstanceSettings } from 'n8n-core';
 import { AgentRepository } from '../../../repositories/agent.repository';
-import { AgentChatIntegration, type AgentChannelPreconditionContext, type AgentIntegrationRemovalContext, type AgentChatIntegrationContext, type ActionDecisionMessageParams, type BridgeMessageContextParams, type BridgeResumeExecutionContext, type UnauthenticatedWebhookContext, type UnauthenticatedWebhookResponse } from '../../agent-chat-integration';
+import { AgentChatIntegration, type AgentChannelPreconditionContext, type AgentIntegrationRemovalContext, type AgentChatIntegrationContext, type ActionDecisionMessageParams, type PlatformActionParams, type PlatformContextQueryParams, type BridgeMessageContextParams, type BridgeResumeExecutionContext, type UnauthenticatedWebhookContext, type UnauthenticatedWebhookResponse } from '../../agent-chat-integration';
 import { ChannelRateLimitGuard } from '../../channel-rate-limit.guard';
 import { type NormalizeComponentsContext, type SuspendComponent } from '../../component-mapper';
+import type { IntegrationActionResult, ReplyExpectation } from '../../integration-tool-types';
+import { WhatsAppOptionPagesStore } from './whatsapp-option-pages.store';
+import { WhatsAppSetupTelemetryService } from './whatsapp-setup-telemetry.service';
 import { WhatsAppWebhookVerificationStore } from './whatsapp-webhook-verification.store';
 import type { DecodedThread, OriginInput } from '../../integration-origin-support';
 export declare class WhatsAppIntegration extends AgentChatIntegration {
@@ -13,6 +18,9 @@ export declare class WhatsAppIntegration extends AgentChatIntegration {
     private readonly instanceSettings;
     private readonly channelRateLimitGuard;
     private readonly webhookVerification;
+    private readonly outboundHttp;
+    private readonly optionPages;
+    private readonly setupTelemetry;
     readonly type = "whatsapp";
     readonly credentialTypes: string[];
     readonly displayLabel = "WhatsApp";
@@ -24,15 +32,19 @@ export declare class WhatsAppIntegration extends AgentChatIntegration {
         useNodeToolWhen: string[];
     };
     readonly supportedComponents: readonly RichCardComponentType[];
+    readonly contextToolDefinitions: import("../../integration-tool-types").IntegrationContextQueryDefinition[];
     readonly actionToolDefinitions: import("../../integration-tool-types").IntegrationActionDefinition[];
     readonly actionToolGuidance: string[];
     readonly disableStreaming = true;
     readonly deleteActionMessageBeforeResume = false;
     readonly defaultSessionIdleTimeoutMinutes = 30;
-    constructor(logger: Logger, agentRepository: AgentRepository, instanceSettings: InstanceSettings, channelRateLimitGuard: ChannelRateLimitGuard, webhookVerification: WhatsAppWebhookVerificationStore);
+    constructor(logger: Logger, agentRepository: AgentRepository, instanceSettings: InstanceSettings, channelRateLimitGuard: ChannelRateLimitGuard, webhookVerification: WhatsAppWebhookVerificationStore, outboundHttp: OutboundHttp, optionPages: WhatsAppOptionPagesStore, setupTelemetry: WhatsAppSetupTelemetryService);
+    executeContextQuery(params: PlatformContextQueryParams): Promise<unknown>;
+    executeAction(params: PlatformActionParams): Promise<IntegrationActionResult | undefined>;
     assertStartupPreconditions(ctx: AgentChannelPreconditionContext): Promise<void>;
     onBeforeConnect(ctx: AgentChatIntegrationContext): Promise<void>;
-    onRemove(ctx: AgentIntegrationRemovalContext): Promise<undefined>;
+    onRemove(ctx: AgentIntegrationRemovalContext): Promise<AgentIntegrationDisconnectWarning | undefined>;
+    private lookUpDisplayPhoneNumber;
     handleUnauthenticatedWebhook(context: UnauthenticatedWebhookContext): UnauthenticatedWebhookResponse | undefined;
     createResumeExecutionContext(params: {
         thread: BridgeMessageContextParams['thread'];
@@ -44,8 +56,20 @@ export declare class WhatsAppIntegration extends AgentChatIntegration {
     buildOriginDraft(_input: OriginInput, decoded: DecodedThread): import("../../integration-origin-support").OriginDraft;
     resolveEpisodicScope(): null;
     createAdapter(ctx: AgentChatIntegrationContext): Promise<unknown>;
+    getFailedSendReport(message: Message<unknown>): {
+        messageId: string;
+        chatNotice: string;
+    } | undefined;
+    getReplyExpectation({ message }: {
+        message: Message<unknown>;
+    }): ReplyExpectation;
     formatActionDecisionMessage({ approved, selectedLabel, user, }: ActionDecisionMessageParams): string;
-    normalizeComponents(components: SuspendComponent[], context: NormalizeComponentsContext): SuspendComponent[];
+    normalizeComponents(components: SuspendComponent[], context: NormalizeComponentsContext): Promise<SuspendComponent[]>;
+    private foldButtonsIntoSelect;
+    private createTemplateFetcher;
+    private paginateSelect;
+    private buildMoreOption;
+    claimAction(event: ActionEvent): Promise<boolean>;
     private createAdapterLogger;
     private extractAccessToken;
     private extractPhoneNumberId;