campaigns.read
Visualiza o catálogo de campanhas, banners ativos e segmentações.
Rota /campaigns
Campanhas & Comunicados.
O módulo de campanhas permite à corretora e aos administradores de RH criarem peças de engajamento, avisos de medicina preventiva e divulgações de benefícios com exibição controlada e segmentada no portal do beneficiário.
campaigns.manage
Cria, edita, deleta e publica campanhas de engajamento com banners e CTAs.
Targeting
Segmentação de Público-Alvo
Segmentação por Contratos
Direcione campanhas específicas apenas para colaboradores de um cliente contratante específico.
Filtros Demográficos
Restrinja exibições por faixa etária ou gênero (Ex: campanha de Outubro Rosa para beneficiárias acima de 40 anos).
Categorização Temática
O beneficiário pode filtrar comunicados por interesse (Bem-estar, Saúde, Prevenção) no seu painel.
Campos estruturais
Metadados da Campanha
| Campo | Payload API | Finalidade |
|---|---|---|
| Título da Campanha | title | Obrigatorio. Título de destaque exibido no banner ou card principal. |
| Descrição / Conteúdo | description | Obrigatorio. Texto descritivo ou corpo da comunicação corporativa. |
| Imagem de Capa (Banner) | imageUrl | Opcional. Banner visual associado (MIME type de imagem válido). |
| Rótulo do CTA | ctaLabel | Opcional. Texto do botão de ação (Ex: 'Acessar Rede', 'Agendar Consulta'). |
| Link do CTA (URL) | ctaUrl | Opcional. Link de destino do botão de ação (interna ou externa). |
| Categoria | category | Obrigatorio. GENERAL (Geral), HEALTH (Saúde), WELLBEING (Bem-estar), BENEFITS (Benefícios), PREVENTION (Prevenção). |
| Período de Vigência | startsAt / endsAt | Opcional. Datas de início e fim que delimitam a exibição automática da campanha. |
| Público-Alvo | audience | Obrigatorio. Objeto JSON que define os filtros de segmentação de vidas. |
Ciclo de vida
Status de Publicação (Publication Steps)
| Passo | Código Técnico | Status & Visibilidade |
|---|---|---|
| Rascunho | draft | A campanha é criada por um operador da corretora e pode ser salva livremente. |
| Marketing | marketing | Etapa de ajuste de criativos, validação de logotipo, identidade visual e redação. |
| Aprovada | approval | Liberação técnica e de compliance para a fila de publicação da plataforma. |
| Publicada | published | Disponível para visualização no Portal do Beneficiário para o público filtrado. |
Checklist de Publicação
Antes de colocar no ar
O link do CTA (URL) está completo, iniciando com http:// ou https:// caso seja externo.
As dimensões e o tamanho do banner de imagem respeitam as regras de contraste e responsividade.
As datas de início e fim da vigência cobrem corretamente o período do evento anunciado.
A segmentação do público (Audience Editor) foi validada para não exibir banners para o cliente errado.
A campanha foi movida para o status 'Publicada' para aparecer para os usuários finais.