# Campaigns

- Tipo: Core/Extension Vtiger
- Criticidad: Media
- Ubicacion: `admin/modules/Campaigns/`
- Proposito: Modulo nativo Vtiger de campanas, extendido dentro del menu Marketing para Customer Engagement Fase 1.
- Ultima actualizacion: 2026-06-27

## Archivos clave

- `modules/Campaigns/Campaigns.php`
- `modules/Campaigns/models/RelationListView.php`
- `modules/Campaigns/models/ListView.php`
- `modules/Campaigns/models/Relation.php`
- `modules/Campaigns/models/Module.php`
- `modules/Campaigns/models/Record.php`
- `modules/Campaigns/views/Detail.php`
- `modules/Campaigns/views/RelatedList.php`
- `modules/Campaigns/views/Marketing.php`
- `modules/Campaigns/views/MarketingTimeline.php`
- `modules/Campaigns/actions/DetailAjax.php`
- `modules/Campaigns/actions/RelationAjax.php`
- `modules/Campaigns/actions/SaveMarketingTemplate.php`
- `modules/Campaigns/actions/SaveAudience.php`
- `modules/Campaigns/actions/QueueCampaign.php`
- `modules/Campaigns/actions/TrackEvent.php`
- `modules/Campaigns/services/MarketingRepository.php`
- `modules/Campaigns/adapters/MarketingMailAdapter.php`
- `modules/Campaigns/adapters/NullMailAdapter.php`

## Customer Engagement Fase 1

- Campanas: configuracion de asunto, remitente, template, audiencia, programacion y estado.
- Templates: editor por bloques permitidos, sin HTML libre.
- Audiences: segmentacion dinamica basada en Accounts y Contacts.
- Email Queue: cola desacoplada de envio.
- Tracking: aperturas, clicks, rebotes, bajas y respuestas asociadas a Contact.
- Timeline: widget disponible en detalle de Accounts y Contacts.
- Analytics: resumen basico de campanas, cola y eventos.

## Pendiente

- Proveedores reales de envio: SMTP, SES, Mailgun, Resend, SendGrid, Postmark, Brevo.
- WhatsApp, SMS, Automation, Journey Builder, AI Campaign Builder, A/B Testing y Lead Scoring.

## Reglas

No modificar este modulo sin revisar `architecture.md`, `database.md`, `security.md`, `performance.md`, `known_issues.md` y `change_log.md`.