Add whatsapp feature

2025-11-13 16:01:08 +01:00
parent d7df2b0853
commit 9bc048d360
74 changed files with 9765 additions and 533 deletions
--- a/services/notification/app/models/init.py
+++ b/services/notification/app/models/init.py
@@ -23,7 +23,12 @@ from .notifications import (
 )
 from .templates import (
    EmailTemplate,
+)
+from .whatsapp_messages import (
    WhatsAppTemplate,
+    WhatsAppMessage,
+    WhatsAppMessageStatus,
+    WhatsAppMessageType,
 )

 # List all models for easier access
@@ -37,5 +42,8 @@ __all__ = [
    "NotificationLog",
    "EmailTemplate",
    "WhatsAppTemplate",
+    "WhatsAppMessage",
+    "WhatsAppMessageStatus",
+    "WhatsAppMessageType",
    "AuditLog",
 ]
--- a/services/notification/app/models/templates.py
+++ b/services/notification/app/models/templates.py
@@ -48,35 +48,37 @@ class EmailTemplate(Base):
    updated_at = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)


-class WhatsAppTemplate(Base):
-    """WhatsApp-specific templates"""
-    __tablename__ = "whatsapp_templates"
-
-    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
-    tenant_id = Column(UUID(as_uuid=True), nullable=True, index=True)
-    
-    # Template identification
-    template_key = Column(String(100), nullable=False, unique=True)
-    name = Column(String(255), nullable=False)
-    
-    # WhatsApp template details
-    whatsapp_template_name = Column(String(255), nullable=False)  # Template name in WhatsApp Business API
-    whatsapp_template_id = Column(String(255), nullable=True)
-    language_code = Column(String(10), default="es")
-    
-    # Template content
-    header_text = Column(String(60), nullable=True)  # WhatsApp header limit
-    body_text = Column(Text, nullable=False)
-    footer_text = Column(String(60), nullable=True)  # WhatsApp footer limit
-    
-    # Template parameters
-    parameter_count = Column(Integer, default=0)
-    parameters = Column(JSON, nullable=True)  # Parameter definitions
-    
-    # Status
-    approval_status = Column(String(20), default="pending")  # pending, approved, rejected
-    is_active = Column(Boolean, default=True)
-    
-    # Timestamps
-    created_at = Column(DateTime, default=datetime.utcnow)
-    updated_at = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+# NOTE: WhatsAppTemplate has been moved to app/models/whatsapp_messages.py
+# This old definition is commented out to avoid duplicate table definition errors
+# class WhatsAppTemplate(Base):
+#     """WhatsApp-specific templates"""
+#     __tablename__ = "whatsapp_templates"
+#
+#     id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+#     tenant_id = Column(UUID(as_uuid=True), nullable=True, index=True)
+#
+#     # Template identification
+#     template_key = Column(String(100), nullable=False, unique=True)
+#     name = Column(String(255), nullable=False)
+#
+#     # WhatsApp template details
+#     whatsapp_template_name = Column(String(255), nullable=False)  # Template name in WhatsApp Business API
+#     whatsapp_template_id = Column(String(255), nullable=True)
+#     language_code = Column(String(10), default="es")
+#
+#     # Template content
+#     header_text = Column(String(60), nullable=True)  # WhatsApp header limit
+#     body_text = Column(Text, nullable=False)
+#     footer_text = Column(String(60), nullable=True)  # WhatsApp footer limit
+#
+#     # Template parameters
+#     parameter_count = Column(Integer, default=0)
+#     parameters = Column(JSON, nullable=True)  # Parameter definitions
+#
+#     # Status
+#     approval_status = Column(String(20), default="pending")  # pending, approved, rejected
+#     is_active = Column(Boolean, default=True)
+#
+#     # Timestamps
+#     created_at = Column(DateTime, default=datetime.utcnow)
+#     updated_at = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
--- a/services/notification/app/models/whatsapp_messages.py
+++ b/services/notification/app/models/whatsapp_messages.py
@@ -0,0 +1,135 @@
+# ================================================================
+# services/notification/app/models/whatsapp_messages.py
+# ================================================================
+"""
+WhatsApp message tracking models for WhatsApp Business Cloud API
+"""
+
+from sqlalchemy import Column, String, Text, Boolean, DateTime, JSON, Enum, Integer
+from sqlalchemy.dialects.postgresql import UUID
+from datetime import datetime
+import uuid
+import enum
+
+from shared.database.base import Base
+
+
+class WhatsAppMessageStatus(enum.Enum):
+    """WhatsApp message delivery status"""
+    PENDING = "pending"
+    SENT = "sent"
+    DELIVERED = "delivered"
+    READ = "read"
+    FAILED = "failed"
+
+
+class WhatsAppMessageType(enum.Enum):
+    """WhatsApp message types"""
+    TEMPLATE = "template"
+    TEXT = "text"
+    IMAGE = "image"
+    DOCUMENT = "document"
+    INTERACTIVE = "interactive"
+
+
+class WhatsAppMessage(Base):
+    """Track WhatsApp messages sent via Cloud API"""
+    __tablename__ = "whatsapp_messages"
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    tenant_id = Column(UUID(as_uuid=True), nullable=False, index=True)
+    notification_id = Column(UUID(as_uuid=True), nullable=True, index=True)  # Link to notification if exists
+
+    # Message identification
+    whatsapp_message_id = Column(String(255), nullable=True, index=True)  # WhatsApp's message ID
+
+    # Recipient details
+    recipient_phone = Column(String(20), nullable=False, index=True)  # E.164 format
+    recipient_name = Column(String(255), nullable=True)
+
+    # Message details
+    message_type = Column(Enum(WhatsAppMessageType), nullable=False)
+    status = Column(Enum(WhatsAppMessageStatus), default=WhatsAppMessageStatus.PENDING, index=True)
+
+    # Template details (for template messages)
+    template_name = Column(String(255), nullable=True)
+    template_language = Column(String(10), default="es")
+    template_parameters = Column(JSON, nullable=True)  # Template variable values
+
+    # Message content (for non-template messages)
+    message_body = Column(Text, nullable=True)
+    media_url = Column(String(512), nullable=True)
+
+    # Delivery tracking
+    sent_at = Column(DateTime, nullable=True)
+    delivered_at = Column(DateTime, nullable=True)
+    read_at = Column(DateTime, nullable=True)
+    failed_at = Column(DateTime, nullable=True)
+
+    # Error tracking
+    error_code = Column(String(50), nullable=True)
+    error_message = Column(Text, nullable=True)
+
+    # Provider response
+    provider_response = Column(JSON, nullable=True)
+
+    # Additional data (renamed from metadata to avoid SQLAlchemy reserved word)
+    additional_data = Column(JSON, nullable=True)  # Additional context (PO number, order ID, etc.)
+
+    # Conversation tracking
+    conversation_id = Column(String(255), nullable=True, index=True)  # WhatsApp conversation ID
+    conversation_category = Column(String(50), nullable=True)  # business_initiated, user_initiated
+
+    # Timestamps
+    created_at = Column(DateTime, default=datetime.utcnow, index=True)
+    updated_at = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+
+class WhatsAppTemplate(Base):
+    """Store WhatsApp message templates metadata"""
+    __tablename__ = "whatsapp_templates"
+
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    tenant_id = Column(UUID(as_uuid=True), nullable=True, index=True)  # Null for system templates
+
+    # Template identification
+    template_name = Column(String(255), nullable=False, index=True)  # Name in WhatsApp
+    template_key = Column(String(100), nullable=False, unique=True)  # Internal key
+    display_name = Column(String(255), nullable=False)
+    description = Column(Text, nullable=True)
+    category = Column(String(50), nullable=False)  # MARKETING, UTILITY, AUTHENTICATION
+
+    # Template configuration
+    language = Column(String(10), default="es")
+    status = Column(String(20), default="PENDING")  # PENDING, APPROVED, REJECTED
+
+    # Template structure
+    header_type = Column(String(20), nullable=True)  # TEXT, IMAGE, DOCUMENT, VIDEO
+    header_text = Column(String(60), nullable=True)
+    body_text = Column(Text, nullable=False)
+    footer_text = Column(String(60), nullable=True)
+
+    # Parameters
+    parameters = Column(JSON, nullable=True)  # List of parameter definitions
+    parameter_count = Column(Integer, default=0)
+
+    # Buttons (for interactive templates)
+    buttons = Column(JSON, nullable=True)
+
+    # Metadata
+    is_active = Column(Boolean, default=True)
+    is_system = Column(Boolean, default=False)
+
+    # Usage tracking
+    sent_count = Column(Integer, default=0)
+    last_used_at = Column(DateTime, nullable=True)
+
+    # WhatsApp metadata
+    whatsapp_template_id = Column(String(255), nullable=True)
+    approved_at = Column(DateTime, nullable=True)
+    rejected_at = Column(DateTime, nullable=True)
+    rejection_reason = Column(Text, nullable=True)
+
+    # Timestamps
+    created_at = Column(DateTime, default=datetime.utcnow)
+    updated_at = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)