Notificação - Mensagens

O Notificação é o serviço de mensagens multicanal do Mangati Cloud Suite. Envia SMS, WhatsApp e e-mail usando provedores de transporte configuráveis, com cobrança por créditos e gestão de templates.

Conceitos Principais

Canais

Canal	Descrição
WhatsApp	Mensagens via WhatsApp Business
SMS	Mensagens de texto via operadora
E-mail	E-mail HTML/texto

Transportes

Cada canal pode ser configurado com um ou mais provedores de transporte:

Transporte	Canal	Descrição
WhatsApp Cloud API	WhatsApp	API oficial da Meta
WppConnect	WhatsApp	Bridge open-source do WhatsApp Web
EvolutionAPI	WhatsApp	API WhatsApp auto-hospedada
Amazon SNS	SMS	AWS Simple Notification Service
Amazon SES	E-mail	AWS Simple Email Service
SMTP	E-mail	Qualquer servidor SMTP
Google SMTP	E-mail	Gmail SMTP
Resend	E-mail	API de e-mail Resend

Templates

Os Templates definem a estrutura da mensagem com variáveis nomeadas. Exemplo:

Template: "lembrete_agendamento"
Conteúdo: "Olá {{nome}}, lembrete do seu agendamento em {{data}} às {{hora}}."
Canal: WhatsApp

As variáveis são preenchidas no momento do envio.

Créditos

A entrega de mensagens usa um sistema de créditos:

• Cada organização possui um saldo de créditos
• Cada mensagem custa um número fixo de créditos (varia por canal)
• Créditos são comprados via Mangati Cloud / Stripe

Os créditos são debitados atomicamente por mensagem. Entregas com falha não são cobradas.

Entrega Assíncrona

As mensagens são enfileiradas via Symfony Messenger e processadas de forma assíncrona. Ou seja, POST /api/notifications retorna imediatamente após o enfileiramento - a entrega acontece em segundo plano.

Guia do Operador

Configurar um Transporte

1. Vá em Admin → Transportes de Mensagem
2. Clique em Novo Transporte
3. Selecione o canal (WhatsApp, SMS, E-mail)
4. Selecione o provedor e informe as credenciais
5. Marque como Ativo

Criar um Template

1. Vá em Templates → Novo
2. Informe o nome do template (usado nas chamadas de API)
3. Selecione o canal
4. Escreva o conteúdo usando para os marcadores
5. Salve

Visualizar Mensagens

A página Mensagens exibe todas as mensagens enviadas com status e resultados de entrega. Filtre por data, canal, status.

Gerenciar Créditos

• Créditos → Saldo: saldo atual de créditos
• Créditos → Comprar: comprar créditos via Stripe
• Créditos → Histórico: registro de transações

Testar um Template

1. Vá em Mensagens → Enviar Teste
2. Selecione o template e preencha as variáveis
3. Informe o telefone/e-mail do destinatário
4. Envie e verifique a entrega

Padrão de Integração

O padrão típico de integração com o NovoSGA:

1. Senha encerrada no NovoSGA
2. Avaliação cria uma avaliação e obtém a chave de link
3. Seu serviço chama POST /api/notifications com o link de avaliação
4. O cidadão recebe um WhatsApp/SMS com o link para avaliar o atendimento