adding

apps/messaging/api/views.py

@@ -10,7 +10,13 @@ from apps.banker.models import ContactGroup
 from apps.billing.permissions import HasActiveFeature
 from apps.messaging.models import BulkMessage, MessageRecipient
 
-from .serializers import BulkMessageSerializer, SendBulkMessageSerializer
+from apps.billing.forms import normalize_iran_phone
+
+from .serializers import (
+    BulkMessageSerializer,
+    ContactMessageHistorySerializer,
+    SendBulkMessageSerializer,
+)
 from .services import BulkMessageService
 
 
@@ -90,3 +96,34 @@ class ConfirmManualSendView(APIView):
         except MessageRecipient.DoesNotExist:
             raise NotFound("گیرنده یافت نشد.")
         return Response({"success": True, "status": recipient.status})
+
+
+class ContactMessageHistoryView(APIView):
+    """تاریخچه‌ی پیام‌های فرستاده‌شده به یک شماره.
+
+    چرا بر اساس *شماره* و نه شناسه‌ی مخاطب: صفحه‌ی «مشتریان» و «مخاطبین»
+    دو موجودیتِ جدا هستند و کاربر انتظار دارد روی پروفایلِ مشتری هم ببیند
+    چه پیامی برایش رفته. شماره تنها چیزی است که این دو را به هم وصل
+    می‌کند، پس با شماره‌ی نرمال‌شده جستجو می‌کنیم.
+    """
+
+    permission_classes = [IsAuthenticated]
+
+    def get(self, request):
+        raw = request.query_params.get("phone", "") or ""
+        phone = normalize_iran_phone(raw)
+        if not phone:
+            raise ValidationError({"phone": "شماره لازم است."})
+
+        # ارقامِ ذخیره‌شده ممکن است با ۰ یا +۹۸ باشند؛ روی چند شکل تطبیق
+        # می‌دهیم تا تاریخچه به‌خاطر تفاوتِ قالبِ شماره گم نشود.
+        variants = {phone, phone.lstrip("0"), "+98" + phone.lstrip("0"), "98" + phone.lstrip("0")}
+        rows = (
+            MessageRecipient.objects.filter(
+                bulk_message__user=request.user,
+                contact__phone__in=variants,
+            )
+            .select_related("bulk_message")
+            .order_by("-bulk_message__created_at", "-id")[:100]
+        )
+        return Response(ContactMessageHistorySerializer(rows, many=True).data)