@rodrigobeber/patoai-dtos 4.8.23 → 4.8.25

package/dist/alert/alert-type.enum.d.ts

@@ -7,7 +7,9 @@ export declare enum AlertTypeEnum {
     SCHEDULE_CANCELED = "schedule_canceled",
     DAILY_DIGEST = "daily_digest",
     HANDOFF = "handoff",
-    FOLLOWUP_FAILURE = "followup_failure"
+    FOLLOWUP_FAILURE = "followup_failure",
+    /** Canal degradado: qualidade caindo, template pausado, tier rebaixado. */
+    CHANNEL_QUALITY = "channel_quality"
 }
 /** Alertas que PODEM ser entregues por WhatsApp (os demais = só e-mail). */
 export declare const WHATSAPP_ELIGIBLE_ALERTS: readonly AlertTypeEnum[];

package/dist/alert/alert-type.enum.js

@@ -12,6 +12,8 @@ var AlertTypeEnum;
     AlertTypeEnum["DAILY_DIGEST"] = "daily_digest";
     AlertTypeEnum["HANDOFF"] = "handoff";
     AlertTypeEnum["FOLLOWUP_FAILURE"] = "followup_failure";
+    /** Canal degradado: qualidade caindo, template pausado, tier rebaixado. */
+    AlertTypeEnum["CHANNEL_QUALITY"] = "channel_quality";
 })(AlertTypeEnum || (exports.AlertTypeEnum = AlertTypeEnum = {}));
 /** Alertas que PODEM ser entregues por WhatsApp (os demais = só e-mail). */
 exports.WHATSAPP_ELIGIBLE_ALERTS = [
@@ -30,7 +32,8 @@ exports.WHATSAPP_ELIGIBLE_ALERTS = [
 exports.DEFAULT_ENABLED_ALERTS = [
     AlertTypeEnum.WHATSAPP_HEALTH,
     AlertTypeEnum.SUBSCRIPTION,
-    AlertTypeEnum.LOW_CREDITS
+    AlertTypeEnum.LOW_CREDITS,
+    AlertTypeEnum.CHANNEL_QUALITY
 ];
 /** Alertas que só existem/avaliam quando a crew tem agenda ativa. */
 exports.AGENDA_REQUIRED_ALERTS = [

package/dist/support/lab-action-catalog.js

@@ -157,3 +157,91 @@ exports.LAB_ACTIONS.push({
             description: 'Não = ignora imagens; Extrai significado = outra IA descreve a imagem; Análise direta = o próprio agente olha a imagem.',
         }],
 });
+// ── Onda 3: Atendimento Humano, Reengajamento e Lembretes ──────────────────────────────────────
+// Três áreas que a Oráculo NÃO enxerga sem abrir a seção por ferramenta (nenhuma está em
+// CHAT_CONFIG_SECTIONS), mas que respondem ao que o dono mais pergunta: "por que insistiu 3 vezes?",
+// "não manda mensagem de madrugada", "desliga a transferência para humano".
+//
+// ⚠️ NOME DO PARÂMETRO = a chave que o frontend LÊ (WebChatCrewDto / WebChatHandoffDto), não a chave do
+// corpo do endpoint. O "mudou desde a proposta" compara `currentValues[param]` com `beforeRaw`, então um
+// nome que não existe na leitura marcaria TODA proposta como desatualizada. Quem traduz para o corpo é o
+// applier do frontend (ex.: `followUpDayStartTime` -> `dayStartTime`).
+//
+// ⚠️ HORÁRIO: o banco guarda UTC, a tela e o dono falam Brasília. O modelo propõe em Brasília; a
+// conversão acontece UMA vez, na materialização. Errar isto desloca todo envio em 3h — e os dois lados
+// continuam parecendo certos na tela.
+const ATENDIMENTO_DIST = 'Configurações → Atendimento Humano → Distribuição';
+const ATENDIMENTO_MSG = 'Configurações → Atendimento Humano → Mensagem ao Transferir';
+const USUARIOS = 'Configurações → Usuários → Opções Gerais';
+const REENGAJAMENTO = 'Configurações → Reengajamento → Opções Gerais';
+const LEMBRETES = 'Configurações → Agenda → Lembretes e confirmações';
+/** DISTRIBUTION_LABELS (DistributionCard). */
+const DISTRIBUTION = [
+    { value: 'no', label: 'Nunca atribuir' },
+    { value: 'keep', label: 'Não atribuir, mas manter responsável' },
+    { value: 'rotation', label: 'Sempre em rodízio' },
+    { value: 'rotation-keep', label: 'Rodízio com responsável fixo' },
+];
+/** FOLLOW_UP_MODE_LABELS (ReengajamentoOpcoesGeraisPage). */
+const FOLLOW_UP_MODE = [
+    { value: 'off', label: 'Nunca fazer follow-up' },
+    { value: 'normal', label: 'Sim, sem repetir' },
+    { value: 'full', label: 'Sim, reiniciar após o lead responder' },
+];
+/** REMINDER_MODE_LABELS (ReminderOptionsCard). */
+const REMINDER_MODE = [
+    { value: 'on', label: 'Ligado' },
+    { value: 'off', label: 'Desligado' },
+];
+// Janela comercial de envio: começo e fim mudam JUNTOS, numa única chamada de endpoint — a invariante
+// "uma ação = uma chamada" continua valendo, é a ação que tem dois campos.
+function timeWindow(id, prefix, title, path, summary, oQue) {
+    const hora = (suffix) => ({
+        name: `${prefix}Day${suffix}Time`,
+        kind: 'time', required: true,
+        label: `${suffix === 'Start' ? 'Enviar a partir de' : 'Enviar até'} (horário de Brasília)`,
+        description: `${suffix === 'Start' ? 'Hora em que o agente pode COMEÇAR' : 'Hora em que o agente PARA'} de ${oQue}, no horário de Brasília, formato HH:MM.`,
+    });
+    return {
+        id, op: 'update', render: 'field', title, path, summary,
+        reversible: 'tela', undoHint: REEDITAVEL(path),
+        params: [hora('Start'), hora('End')],
+    };
+}
+exports.LAB_ACTIONS.push(Object.assign(Object.assign({}, toggle('handoff.escalate', 'escalate', 'Habilitar escalonamentos', USUARIOS, 'Ligar/desligar a IA poder transferir a conversa para um atendente humano.', 'Ligado = a IA transfere para atendente humano conforme as regras de Atendimento Humano. Desligado = ela nunca transfere.')), { impactHint: 'Desligar tira do menu toda a área de Atendimento Humano.' }), toggle('handoff.message', 'active', 'Mensagem ao transferir', ATENDIMENTO_MSG, 'Ligar/desligar o aviso ao lead quando a conversa passa para um atendente humano.', 'Ligado = o lead recebe uma mensagem avisando que vai falar com uma pessoa. Desligado = a transferência é silenciosa.'), {
+    id: 'handoff.distribution',
+    op: 'update', render: 'field',
+    title: 'Distribuição de conversas',
+    path: ATENDIMENTO_DIST,
+    summary: 'Mudar como as conversas transferidas são atribuídas aos atendentes.',
+    reversible: 'tela', undoHint: REEDITAVEL(ATENDIMENTO_DIST),
+    params: [{
+            name: 'dist', kind: 'enum', required: true, options: DISTRIBUTION,
+            label: 'Distribuição de conversas',
+            description: 'Rodízio reparte as conversas entre os atendentes; "manter responsável" faz o lead voltar sempre para quem já o atendeu.',
+        }],
+}, {
+    id: 'followUp.mode',
+    op: 'update', render: 'field',
+    title: 'Modo de reengajamento',
+    path: REENGAJAMENTO,
+    summary: 'Ligar/desligar o reengajamento (follow-up) ou mudar se ele reinicia quando o lead responde.',
+    reversible: 'tela', undoHint: REEDITAVEL(REENGAJAMENTO),
+    params: [{
+            name: 'followUp', kind: 'enum', required: true, options: FOLLOW_UP_MODE,
+            label: 'Modo de reengajamento',
+            description: 'Reengajamento é o agente voltar a falar com quem parou de responder. "Reiniciar" faz o ciclo começar de novo cada vez que o lead responde.',
+        }],
+}, toggle('followUp.semantics', 'followUpSemantics', 'Enviar follow-ups semanticamente', REENGAJAMENTO, 'Ligar/desligar o agente escrever o follow-up na hora em vez de mandar o texto fixo.', 'Ligado = a IA escreve o follow-up a partir da conversa. Desligado = envia o texto configurado, igual para todos.'), timeWindow('followUp.window', 'followUp', 'Horário de envio do reengajamento', REENGAJAMENTO, 'Ajustar a faixa de horário em que o agente pode enviar follow-up (ex.: não mandar de madrugada).', 'mandar follow-up'), {
+    id: 'reminder.mode',
+    op: 'update', render: 'field',
+    title: 'Lembretes de agendamento',
+    path: LEMBRETES,
+    summary: 'Ligar/desligar os lembretes de reunião agendada.',
+    reversible: 'tela', undoHint: REEDITAVEL(LEMBRETES),
+    params: [{
+            name: 'reminderMode', kind: 'enum', required: true, options: REMINDER_MODE,
+            label: 'Lembretes de agendamento',
+            description: 'Chave mestra dos lembretes: desligada, nenhuma regra de lembrete dispara.',
+        }],
+}, timeWindow('reminder.window', 'reminder', 'Horário de envio dos lembretes', LEMBRETES, 'Ajustar a faixa de horário em que os lembretes de reunião podem ser enviados.', 'mandar lembrete'));

package/dist/uh/index.d.ts

@@ -16,3 +16,5 @@ export * from './send-buttons.dto';
 export * from './message-status.dto';
 export * from './telegram.dto';
 export * from './whatsapp-error-code.enum';
+export * from './rpc-error.dto';
+export * from './waba-event.dto';

package/dist/uh/index.js

@@ -32,3 +32,5 @@ __exportStar(require("./send-buttons.dto"), exports);
 __exportStar(require("./message-status.dto"), exports);
 __exportStar(require("./telegram.dto"), exports);
 __exportStar(require("./whatsapp-error-code.enum"), exports);
+__exportStar(require("./rpc-error.dto"), exports);
+__exportStar(require("./waba-event.dto"), exports);

package/dist/uh/rpc-error.dto.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Erro de envio devolvido pelo patoai-uh via RabbitMQ.
+ *
+ * `RpcException(string)` já chega ao chamador como `{ status: 'error', message }` — este DTO é
+ * superset exato disso, então trocar a string pelo objeto não muda nada para quem só lê `message`.
+ * O que ele acrescenta é o `errorCode`: sem ele o consumidor não distingue um 131049 (limite do
+ * destinatário, basta pular o lead) de um 131048 (spam rate limit, tem que parar o canal).
+ */
+export interface UhRpcErrorDto {
+    status: 'error';
+    message: string;
+    errorCode?: number;
+    errorSubcode?: number;
+}
+/**
+ * Normaliza o erro recebido do uh. Aceita tanto o payload novo quanto a string antiga, porque
+ * durante o rolling deploy os dois formatos circulam.
+ */
+export declare function toUhError(err: any): {
+    message: string;
+    errorCode: number | null;
+};

package/dist/uh/rpc-error.dto.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toUhError = toUhError;
+/**
+ * Normaliza o erro recebido do uh. Aceita tanto o payload novo quanto a string antiga, porque
+ * durante o rolling deploy os dois formatos circulam.
+ */
+function toUhError(err) {
+    var _a, _b, _c, _d;
+    const payload = (_b = (_a = err === null || err === void 0 ? void 0 : err.error) !== null && _a !== void 0 ? _a : err === null || err === void 0 ? void 0 : err.response) !== null && _b !== void 0 ? _b : err;
+    const message = (_d = (_c = payload === null || payload === void 0 ? void 0 : payload.message) !== null && _c !== void 0 ? _c : err === null || err === void 0 ? void 0 : err.message) !== null && _d !== void 0 ? _d : 'Erro desconhecido';
+    const errorCode = typeof (payload === null || payload === void 0 ? void 0 : payload.errorCode) === 'number' ? payload.errorCode : null;
+    return { message, errorCode };
+}

package/dist/uh/waba-event.dto.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Eventos de conta/qualidade que a Meta entrega por webhook na WABA — o aviso que antecede a
+ * punição (warning → restrição temporária → account lock → desativação).
+ *
+ * A Meta só entrega esses campos "to those subscribed": além de assinar via
+ * `POST /{waba_id}/subscribed_apps`, os mesmos campos precisam estar marcados no App Dashboard.
+ */
+export declare enum WabaWebhookFieldEnum {
+    MESSAGES = "messages",
+    ACCOUNT_UPDATE = "account_update",
+    ACCOUNT_ALERTS = "account_alerts",
+    PHONE_NUMBER_QUALITY_UPDATE = "phone_number_quality_update",
+    PHONE_NUMBER_NAME_UPDATE = "phone_number_name_update",
+    ACCOUNT_REVIEW_UPDATE = "account_review_update",
+    MESSAGE_TEMPLATE_STATUS_UPDATE = "message_template_status_update",
+    MESSAGE_TEMPLATE_QUALITY_UPDATE = "message_template_quality_update",
+    TEMPLATE_CATEGORY_UPDATE = "template_category_update",
+    BUSINESS_CAPABILITY_UPDATE = "business_capability_update",
+    USER_PREFERENCES = "user_preferences"
+}
+/** Fonte única da lista assinada na Meta. Consumida pelo subscribe (crew) e pelo parser (uh). */
+export declare const WABA_SUBSCRIBED_FIELDS: readonly WabaWebhookFieldEnum[];
+export declare enum WabaEventSeverityEnum {
+    CRITICAL = "critical",
+    WARNING = "warning",
+    INFO = "info"
+}
+/**
+ * Evento normalizado pelo uh e consumido pelo crew.
+ *
+ * Viaja cru (`wabaId`/`phoneNumberId`, não `idChannel`) porque o uh não tem tabela de canal —
+ * a resolução canal→crew é do crew.
+ */
+export interface WabaEventDto {
+    wabaId: string;
+    phoneNumberId?: string;
+    displayPhoneNumber?: string;
+    field: WabaWebhookFieldEnum | string;
+    event?: string;
+    severity: WabaEventSeverityEnum;
+    reason?: string;
+    /** GREEN | YELLOW | RED */
+    quality?: string;
+    /** TIER_250 | TIER_1K | TIER_10K | TIER_100K | TIER_UNLIMITED */
+    currentLimit?: string;
+    banState?: string;
+    /** `restriction_info[].expiration` — quando a restrição temporária expira. */
+    restrictedUntil?: Date;
+    templateName?: string;
+    description?: string;
+    at: Date;
+    /** `change.value` inteiro: campo novo da Meta não pode se perder por falta de mapeamento. */
+    raw: unknown;
+}

package/dist/uh/waba-event.dto.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WabaEventSeverityEnum = exports.WABA_SUBSCRIBED_FIELDS = exports.WabaWebhookFieldEnum = void 0;
+/**
+ * Eventos de conta/qualidade que a Meta entrega por webhook na WABA — o aviso que antecede a
+ * punição (warning → restrição temporária → account lock → desativação).
+ *
+ * A Meta só entrega esses campos "to those subscribed": além de assinar via
+ * `POST /{waba_id}/subscribed_apps`, os mesmos campos precisam estar marcados no App Dashboard.
+ */
+var WabaWebhookFieldEnum;
+(function (WabaWebhookFieldEnum) {
+    WabaWebhookFieldEnum["MESSAGES"] = "messages";
+    WabaWebhookFieldEnum["ACCOUNT_UPDATE"] = "account_update";
+    WabaWebhookFieldEnum["ACCOUNT_ALERTS"] = "account_alerts";
+    WabaWebhookFieldEnum["PHONE_NUMBER_QUALITY_UPDATE"] = "phone_number_quality_update";
+    WabaWebhookFieldEnum["PHONE_NUMBER_NAME_UPDATE"] = "phone_number_name_update";
+    WabaWebhookFieldEnum["ACCOUNT_REVIEW_UPDATE"] = "account_review_update";
+    WabaWebhookFieldEnum["MESSAGE_TEMPLATE_STATUS_UPDATE"] = "message_template_status_update";
+    WabaWebhookFieldEnum["MESSAGE_TEMPLATE_QUALITY_UPDATE"] = "message_template_quality_update";
+    WabaWebhookFieldEnum["TEMPLATE_CATEGORY_UPDATE"] = "template_category_update";
+    WabaWebhookFieldEnum["BUSINESS_CAPABILITY_UPDATE"] = "business_capability_update";
+    WabaWebhookFieldEnum["USER_PREFERENCES"] = "user_preferences";
+})(WabaWebhookFieldEnum || (exports.WabaWebhookFieldEnum = WabaWebhookFieldEnum = {}));
+/** Fonte única da lista assinada na Meta. Consumida pelo subscribe (crew) e pelo parser (uh). */
+exports.WABA_SUBSCRIBED_FIELDS = [
+    WabaWebhookFieldEnum.MESSAGES,
+    WabaWebhookFieldEnum.ACCOUNT_UPDATE,
+    WabaWebhookFieldEnum.ACCOUNT_ALERTS,
+    WabaWebhookFieldEnum.PHONE_NUMBER_QUALITY_UPDATE,
+    WabaWebhookFieldEnum.PHONE_NUMBER_NAME_UPDATE,
+    WabaWebhookFieldEnum.ACCOUNT_REVIEW_UPDATE,
+    WabaWebhookFieldEnum.MESSAGE_TEMPLATE_STATUS_UPDATE,
+    WabaWebhookFieldEnum.MESSAGE_TEMPLATE_QUALITY_UPDATE,
+    WabaWebhookFieldEnum.TEMPLATE_CATEGORY_UPDATE,
+    WabaWebhookFieldEnum.BUSINESS_CAPABILITY_UPDATE,
+    WabaWebhookFieldEnum.USER_PREFERENCES
+];
+var WabaEventSeverityEnum;
+(function (WabaEventSeverityEnum) {
+    WabaEventSeverityEnum["CRITICAL"] = "critical";
+    WabaEventSeverityEnum["WARNING"] = "warning";
+    WabaEventSeverityEnum["INFO"] = "info";
+})(WabaEventSeverityEnum || (exports.WabaEventSeverityEnum = WabaEventSeverityEnum = {}));

package/dist/uh/whatsapp-error-code.enum.d.ts

@@ -17,7 +17,17 @@ export declare enum WhatsAppErrorCodeEnum {
     /** This message was not delivered to maintain healthy ecosystem engagement. */
     HEALTHY_ECOSYSTEM = 131049,
     /** Recipient opted out of marketing messages */
-    MARKETING_OPT_OUT = 131050
+    MARKETING_OPT_OUT = 131050,
+    /**
+     * Business portfolio pacing: o portfolio esta sob revisao e a Meta derrubou o lote.
+     *
+     * A referencia de erros da Meta ainda descreve 135000 como "unknown error with your request
+     * parameters" — a doc de portfolio pacing e que revela o significado real (o codigo era 132015
+     * ate ~mai/2026 e foi trocado sem entrada no changelog). Tratar como erro de parametro leva ao
+     * conselho errado ("revise a sintaxe do template") e a retentativa, que a Meta pune desde
+     * abr/2026. Recorrente em template que ja funcionava = conta marcada: PARAR o funil.
+     */
+    PORTFOLIO_PACING = 135000
 }
 /**
  * Rejeições em que NÃO adianta reenviar para o mesmo número.

package/dist/uh/whatsapp-error-code.enum.js

@@ -23,6 +23,16 @@ var WhatsAppErrorCodeEnum;
     WhatsAppErrorCodeEnum[WhatsAppErrorCodeEnum["HEALTHY_ECOSYSTEM"] = 131049] = "HEALTHY_ECOSYSTEM";
     /** Recipient opted out of marketing messages */
     WhatsAppErrorCodeEnum[WhatsAppErrorCodeEnum["MARKETING_OPT_OUT"] = 131050] = "MARKETING_OPT_OUT";
+    /**
+     * Business portfolio pacing: o portfolio esta sob revisao e a Meta derrubou o lote.
+     *
+     * A referencia de erros da Meta ainda descreve 135000 como "unknown error with your request
+     * parameters" — a doc de portfolio pacing e que revela o significado real (o codigo era 132015
+     * ate ~mai/2026 e foi trocado sem entrada no changelog). Tratar como erro de parametro leva ao
+     * conselho errado ("revise a sintaxe do template") e a retentativa, que a Meta pune desde
+     * abr/2026. Recorrente em template que ja funcionava = conta marcada: PARAR o funil.
+     */
+    WhatsAppErrorCodeEnum[WhatsAppErrorCodeEnum["PORTFOLIO_PACING"] = 135000] = "PORTFOLIO_PACING";
 })(WhatsAppErrorCodeEnum || (exports.WhatsAppErrorCodeEnum = WhatsAppErrorCodeEnum = {}));
 /**
  * Rejeições em que NÃO adianta reenviar para o mesmo número.

package/dist/webchat/crew/webchat-channel.dto.d.ts

@@ -15,3 +15,17 @@ export interface WebChatChannelDto {
     bmLegacy?: boolean;
     dev?: boolean;
 }
+/** Um aviso de enforcement/qualidade da Meta (alert.channel_event), para a timeline do canal. */
+export interface WebChatChannelEventDto {
+    id: string;
+    field: string;
+    event?: string;
+    severity: string;
+    reason?: string;
+    quality?: string;
+    tier?: string;
+    templateName?: string;
+    description?: string;
+    restrictedUntil?: string;
+    eventAt: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rodrigobeber/patoai-dtos",
-  "version": "4.8.23",
+  "version": "4.8.25",
   "description": "Data Transfer Objects for PatoAI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",