CRM_Montzar/docs/superpowers/plans/2026-10-17-sms-campaign-people-leads.md

SMS Campaign People/Leads Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: SMS campaigns support people-only or leads-only audiences with full filters, select-all-ids, dynamic field tokens, and 50-sized create/send batches.

Architecture: Extend people/leads list filters + /ids endpoints; expand sms-campaigns create/add-recipients; personalize body via renderSmsText then tracking links; rebuild SmsCampaignsView with tabs, filters, and chunked create.

Tech Stack: NestJS/Prisma, Vue 3, @mento/shared, existing MESSAGE_AUTOMATION_FIELDS / renderSmsText.

Global Constraints

• One campaign = people XOR leads
• Select-all = all filter matches (confirm count)
• Batch size 50 for create chunks and send cron
• People province/city via company (+ addresses search)
• Dynamic tokens: {نام} {شماره} {تاریخ} {عنوان} {شرکت}
• Spec: docs/superpowers/specs/2026-10-17-sms-campaign-people-leads-design.md

---

Task 1: Shared types

• Extend CreateSmsCampaignRequest with optional leadIds; document XOR
• Add AddSmsCampaignRecipientsRequest, FilteredIdsResponse
• Export constants if needed (SMS_CAMPAIGN_CHUNK = 50)

Task 2: People filters + ids

• PeopleService.list / listIds: province, city on company; address contains
• Controller query + GET /people/ids with 50k cap

Task 3: Leads ids + region filter

• Ensure list supports region; add GET /leads/ids

Task 4: SMS campaigns API

• Create with personIds XOR leadIds (max 50 first chunk; force draft if more planned via queueNow deferred to client)
• POST :id/recipients
• Batch send 50 + renderSmsText before personalizeSmsBody

Task 5: Frontend SmsCampaignsView

• Tabs people/leads, filters, pagination, select-all via /ids
• Dynamic fields pill
• Chunked create then optional queue

Task 6: Verify

• shared build + api tsc/tests relevant; graphify update