@hed-hog/core 0.0.398 → 0.0.400

package/src/whatsapp-sender/whatsapp-sender.service.ts

@@ -35,11 +35,27 @@ export type WhatsappSendInput = {
 };
 
 type ResolvedProfile = {
+  id: number;
   slug: string;
   providerSlug: string;
   config: Record<string, unknown>;
 };
 
+/**
+ * Erro de envio classificado: `retryable` diz se tentar de novo pode dar
+ * resultado diferente. Um HTTP 4xx da Graph API (id inexistente, sem
+ * permissão, token ruim) não muda em cinco minutos; um 5xx ou falha de rede
+ * pode ser uma instabilidade passageira do provedor.
+ */
+export class WhatsappSendError extends BadRequestException {
+  constructor(
+    message: string,
+    public readonly retryable: boolean,
+  ) {
+    super(message);
+  }
+}
+
 /**
  * Envio de WhatsApp usando um perfil de integração escolhido pelo usuário.
  *
@@ -92,6 +108,22 @@ export class WhatsappSenderService {
     }
   }
 
+  /**
+   * Identidade do perfil que o `send` usaria, sem o `config`.
+   *
+   * Quem envia pelo provider oficial precisa dizer por qual número a mensagem
+   * sai, e cada módulo guarda esse id no próprio cadastro. Para achar o cadastro
+   * certo é preciso saber qual perfil foi resolvido — inclusive quando o slug
+   * veio vazio e a escolha coube a este serviço. O `config` fica de fora de
+   * propósito: é onde moram `access_token` e `app_secret`.
+   */
+  async describeProfile(
+    profileSlug?: string,
+  ): Promise<{ id: number; slug: string; providerSlug: string }> {
+    const { id, slug, providerSlug } = await this.resolveProfile(profileSlug);
+    return { id, slug, providerSlug };
+  }
+
   /**
    * Normaliza o destino: número vira só dígitos, id de grupo passa intacto
    * (grupos do WhatsApp têm sufixo `@g.us`, que seria destruído por um strip).
@@ -153,6 +185,7 @@ export class WhatsappSenderService {
     }
 
     return {
+      id: profile.id,
       slug: profile.slug,
       providerSlug: String((profile as any).integration_provider?.slug ?? ''),
       config: ((profile.config ?? {}) as Record<string, unknown>),
@@ -226,6 +259,19 @@ export class WhatsappSenderService {
   ): Promise<void> {
     const cfg = buildWhatsappOfficialConfigFromIntegration(profile.config);
 
+    // A Cloud API da Meta não envia para grupo — não há endpoint para isso. Sem
+    // esta guarda o `normalizeTarget(..., 'phone')` logo abaixo arrancaria o
+    // sufixo `@g.us` e a Graph API receberia o id do grupo como se fosse um
+    // telefone: ou erro genérico de número inválido, ou (pior) entrega a um
+    // número que por acaso exista. `retryable: false` porque trocar de provider
+    // é decisão de configuração, não instabilidade.
+    if (input.targetType === 'group') {
+      throw new WhatsappSendError(
+        `Perfil de integração "${profile.slug}" usa a Cloud API oficial da Meta, que não envia mensagem para grupo. Use um perfil evolution-api para esse destino.`,
+        false,
+      );
+    }
+
     if (!cfg.accessToken) {
       throw new BadRequestException(
         `Perfil de WhatsApp "${profile.slug}" está sem access_token.`,
@@ -290,17 +336,24 @@ export class WhatsappSenderService {
 
     if (!response.ok) {
       const payload = (await response.json().catch(() => ({}))) as {
-        error?: { message?: string };
+        error?: { message?: string; code?: number };
       };
 
-      throw new BadRequestException(
+      // Código documentado pela Meta para "business-initiated message fora da
+      // janela de 24h sem template" (re-engagement). Outros 4xx (id inválido,
+      // sem permissão, token ruim) não têm nada a ver com template e não
+      // devem exibir essa dica.
+      const isReengagementWindowError = payload?.error?.code === 131047;
+
+      throw new WhatsappSendError(
         `WhatsApp recusou o envio (HTTP ${response.status}): ${
           payload?.error?.message ?? 'sem detalhe'
         }${
-          input.template?.name
-            ? ''
-            : ' — sem template configurado, a entrega só funciona na janela de 24h'
+          !input.template?.name && isReengagementWindowError
+            ? ' — sem template configurado, a entrega só funciona na janela de 24h'
+            : ''
         }`,
+        response.status >= 500,
       );
     }
   }