Central de Ajuda Quaza Provedores

Comunicação (PT)

Comunicação — Quaza

Comunicação — Email, SMS, WhatsApp e Campanhas

El módulo Comunicação centraliza todo envío de mensajes de Quaza a os clientes: avisos de vencimiento, boletos, notificações de OS, campañas de marketing, recordatorios de aniversário, propagandas y templates de WhatsApp.

Cubre tres canales (Email, SMS, WhatsApp) y tres usos típicos:
  • Transaccional — disparado por evento (vencimiento, OS creada, boleto)
  • Campaña — envío masivo a segmento de clientes (promoción, comunicado, aviso urgente)
  • Notificación interna — alerta dentro de Quaza para operadores (campana en la parte superior)
Nesta wiki:

Visão geral — fluxo de envío

┌──────────────────────────────────────────────────────────────────────┐ │ GATILLO | CANAL | CONFIGURACIÓN | DESTINO │ ├──────────────────────────────────────────────────────────────────────┤ │ Evento automático | Email | SMTP | Cliente │ │ (vencimiento, OS, | SMS | Gateway SMS | (registro │ │ boleto gerada) | WhatsApp | Meta/Z-API/Blip | Cliente) │ │ ↓ | | | │ │ Tarefa (cron) | | | │ │ ↓ | | | │ │ Template aplicada | ─ ou ─ | | │ │ ↓ | | | │ │ Envío vía gateway | | | │ └──────────────────────────────────────────────────────────────────────┘ ┌────────────────────┐ │ CAMPAÑA │ envío masivo │ (Selección + Modelo) │ al segmento └────────────────────┘ ↓ Operador elige filtros (ej: activos do plan X, en AS, hace 90 días) ↓ Sistema gera cola con N destinatarios ↓ Cron procesa en lote
Quaza no envía directo: él orquesta. Cada mensaje real sale por el gateway externo contratado: SMTP (Gmail, AWS SES, propio servidor), gateway SMS (DisparoPRO, HotMobile, KingSMS, SMS Massivo AR — Paraguai/Argentina), API de WhatsApp (Meta Business, Z-API, Blip). Quaza solo envía a la cola — el gateway entrega.

Glossário

Termo Significado
Template / Modelo Mensaje pre-formateado con variables ({nome}, {valor}). Permite envío masivo personalizado.
Campaña Envío masivo de mensaje (template) para un segmento de clientes (selección).
Selección Filtro/segmento que define quién recibirá el mensaje. Pode ser por carteira, plan, situación, ciudad, etc.
Opt-out Cliente que pidió no recibir mensajes. Há que respetar (regulación + Ley de protección de datos).
Tasa de entrega % de mensajes efectivamente entregados vs enviados. Email suele tener 98%, SMS 95%, WhatsApp 99%.
Bounce Email rechazado (casilla llena, dirección inválida, anti-spam). Soft bounce = temporal; hard bounce = permanente.
HSM (WhatsApp) Highly Structured Message. Template de WhatsApp aprobada por Meta — única forma de enviar mensaje proactivo a cliente que no conversó en 24h.
Ventana 24h (WhatsApp) Tras el cliente enviar mensaje, tienes 24h para responder con mensaje libre. Después, solo HSM.
SMTP Simple Mail Transfer Protocol. Estándar para envío de email. Quaza usa SMTP de terceros para enviar.
Webhook Callback HTTP que el gateway dispara a Quaza informando entrega/lectura/respuesta.
Remitente / Short code Nome/número que aparece al cliente como origen. SMS tem short code (ej: 28028); WhatsApp tem número Business; Email tem dominio.

1. Campaña (envío masivo)

Caminho: Comunicação → Campaña

Lista todas as campañas que Quaza ejecutó o está ejecutando. Incluye envíos automáticos disparados por tarefas (cron) y campañas manuales creadas por marketing.

Columnas

Columna O que mostra
Número ID interno da campaña
Tarefa O que tarefa originó (o "Manual" si la creó el operador)
Forma de Envío Email / SMS / WhatsApp
Estado Sin envíos | En procesamiento | Concluida | Falla en os envíos
Cantidad Total de destinatarios (mensajes enviados)
Tipo de Campaña Estándar / Aniversário / Aviso Vencimiento / etc.
Status da Campaña Habilitado / Desabilitado
"Falla en os envíos" significa que la campaña corrió pero algunos destinatarios no recibieron. No te asustes — pode ser número inválido, bounce, opt-out. Abre la campaña y verifica la lista de errores. Reenvío manual pode hacerse si es necesario.

Sub-listados dentro da campaña

  • Destinatarios — quién recibió (status individual)
  • Errores — quién no recibió y por que
  • Mensaje — contenido enviado

2. Selección

Caminho: Comunicação → Selección

Tela donde el operador crea el segmento que recibirá el mensaje. Usa el sistema de filtros de Quaza para encontrar os clientes que encajan.

Como usar

  1. 1Clicar en Opciones → Filtros
  2. 2Definir criterios: situación=Activo, plan=100MB, ciudad=Asunción, etc.
  3. 3Visualizar previa (cuántos clientes coinciden con el filtro)
  4. 4Elegir canal (Email / SMS / WhatsApp)
  5. 5Elegir template o escribir mensaje libre
  6. 6Disparar campanha (cria registro em Campaña pra acompanhar)
Sempre haz uma prueba pequeña antes: filtre por 1 cliente (você mesmo se possível), envie, valide o template/links. Só depois dispare pra base inteira. Mensaje errada pra 5000 clientes é estragar o canal e gerar volume de reclamações no atendimento.

3. Notificación interna

Caminho: Comunicação → Notificación

Mensajes internos que aparecen en la campana superior de Quaza para usuários. Origen: tarefas automáticas (cron) o eventos do sistema. No va al cliente final.

Quando el sistema crea notificación

Gatillo Exemplo
Cliente nuevo agregado "BÔNUS - Cliente Exemplo agregado" (vendedor ganó bono)
OS creada "ATENCIÓN - Notificación de creación"
Tarefa concluída "Backups realizados el 18/02/2025"
Anomalía detectada "Error de conexión en concentrador" / "Lectura de caídas frecuentes"
Importación "Importación do retorno" / "Término do processamento de retorno"
Visualizado = Sim/Não: la notificación queda acumulada en la campana hasta que el usuário abra. Marcar como visualizada cero el contador. Útil para equipo que precisa garantizar que alguien vio uma anomalía (ej: técnico precisa marcar visualizado en as caídas frecuentes).

4. Configuração Email (SMTP)

Caminho: Comunicação → Configuração (Email)

Credenciales SMTP que Quaza usa para enviar emails. Soporta múltiples servidores (principal + backup).

Campos importantes

Campo O que é
Servidor (SMTP) Host do servidor de email (ej: smtp.gmail.com, mail.empresa.com.br)
Puerto 465 (SSL) / 587 (TLS) / 25 (sin criptografía — no uses)
Usuário / Senha Conta de envío (geralmente noreply@dominio)
Protocolo TLS / SSL / Ninguno
Principal Sim/Não. Quaza usa el "Principal" primero. Si falla, intenta os otros por orden
Orden Secuencia de fallback (1, 2, 3)
Remitente "De" que aparece pra cliente. Geralmente "Provedor "
Senha de app vs senha normal (Gmail): Gmail/Google Workspace no acepta senha normal hace años. Precisas criar senha de aplicación en myaccount.google.com → Seguridad → Senhas de app. Guarda esa senha de 16 caracteres en el campo Senha de Quaza.

5. Configuração SMS

Caminho: Comunicação → Configuração (SMS)

Credenciales de os gateways de SMS contratados.

Campos

Campo O que é
Servidor Gateway elegido (HotMobile - Short, DisparoPRO - Short, KingSMS, etc.)
Usuário / Senha / API Key Credenciales proporcionadas por el gateway
Remitente Nome que aparece como origen (hasta 11 caracteres en SMS short code)
Max. Crédito Límite de crédito a consumir por mensaje (protección)
Saldo Mínimo Cuando el saldo caiga por debajo, gera alerta (avisa antes de terminar)
Principal Mismo concepto do Email — Sim = primera opción
"Urgente" vs normal: algunos gateways ofrecen rutas premium (entrega más rápida + mayor tasa de éxito) por mayor precio. Usa el gateway "Urgente" para avisos críticos (caída de red, vencimiento inminente) y el normal para propaganda.

6. Configuração WhatsApp

Caminho: Comunicação → Configuração (WhatsApp)

Credenciales de la(s) API(s) de WhatsApp contratada(s). Soporta Meta Business (oficial), Z-API y Blip.

Integraciones soportadas

Integración Quando usar Límites
Meta business Oficial, recomendado. Soporta templates HSM, número Business verificado. Templates requieren aprobación Meta. Cobrança por conversación iniciada.
Z-API Alternativa no oficial. Usa WhatsApp Web en el servidor. Pode tener ban si Meta detecta. Bueno para pruebas.
Blip Plataforma BR — atiende grandes contas con chatbot. Caro. Enfoca en flujos complejos.
Z-API y similares son alto riesgo — Meta pode prohibir el número sin aviso (pierde histórico + ID do número). Usa solo para prueba o contas secundarias. En producción/oficial: Meta Business con número dedicado.

7. WhatsApp Template

Caminho: Comunicação → Template (WhatsApp)

Lista as templates HSM registradas (aprobadas por Meta) que Quaza pode disparar fuera da ventana de 24h.

Campos

Campo O que é
Modelo Nome interno da template
Función Para que sirve: Aniversário / Propaganda / Aviso Vencimiento / Cobrança
Enviar Enlace Financiero Sim = template incluye botón "Pagar ahora" con enlace corto
Template Estándar Sim = é o usado por default pra essa Función
Asunto Identificador adicional

Variables disponibles en templates

Variable Sustituida por
{nome} Nome do cliente
{vencimento} Fecha de vencimiento da fatura
{valor} Valor a pagar formateado
{boleto} Enlace corto a boleto/QR
{plano} Plan contratado
{linha_digitavel} Linha digitable da boleto
Aprobación Meta demora 1-24h. Crea template en Quaza → automáticamente envía para aprobación en Meta → Meta valida (categoría, contenido, variables) → status cambia a "Aprobado". Templates con promesa exagerada o lenguaje genérico son rechazadas — sé específico.

8. WhatsApp Envío

Caminho: Comunicação → Envío de WhatsApp

Historial de todos os WhatsApps enviados por Quaza — manual o automático.

Columnas

Columna O que mostra
Cliente Destinatario (con enlace a ficha)
WhatsApp Configuração De que número Business salió
Campaña Campaña originadora (se massa)
Fecha de Envío Timestamp do envío (no da lectura)
Estado Enviado / Falla / Bloqueado / En cola
Alterador Quién disparó (Usuário 1 = sistema/cron, Usuário X = operador específico)
Estado "Enviado" ≠ "Leído": Quaza marca como Enviado cuando WhatsApp aceptó. Quién fue leído depende do webhook que el gateway retorna. Si quieres ver leído/entregado, abre el envío individual.

9. Etiqueta (de chat)

Caminho: Comunicação → Etiquetas

Etiquetas coloridas usadas en el módulo Chat (si está activo) para clasificar conversaciones (lead caliente, suporte, financiero, etc.).

Campo O que é
Color HEX (#FF0000, #00FF00) — visual da etiqueta
Descripción Texto da etiqueta (Lead caliente, Suporte, etc.)

Fluxos típicos passo-a-passo

Fluxo 1: Configurar SMTP nuevo (Gmail)

Passo Onde O que fazer
1 myaccount.google.com Criar Senha de Aplicación de 16 chars
2 Comunicação → Configuração (Email) → Agregar Servidor=smtp.gmail.com, Puerto=587, Protocolo=TLS
3 Continuar Usuário=tu_email@gmail.com, Senha=16 chars da Senha de Aplicación
4 Marcar Principal=Sim, Orden=1 Define como prioritario
5 Admin → Configurações Clicar en "Probar envío de email" → verifica si llegó a la bandeja de entrada
6 Si llegó al spam Configurar SPF/DKIM en el DNS do dominio + warmup gradual

Fluxo 2: Disparar campaña de promoción

Passo Onde O que fazer
1 Comunicação → Selección Abrir Opciones → Filtros
2 Filtros Situação=Activo, Plan=Plan Básico (objetivo do upsell), Ciudad=Capital, Sin OS abierta
3 Visualizar previa Confirmar cantidad (ej: 1247 clientes coinciden)
4 Prueba pequeña Filtrar solo por tu CI/CPF, disparar, validar template/enlaces
5 Voltar al filtro completo Elegir canal (WhatsApp) y template aprobada por Meta
6 Confirmar disparo Sistema cria registro em Campaña
7 Comunicação → Campaña Acompañar status (En procesamiento → Concluida). Verificar Fallas

Fluxo 3: Criar template WhatsApp HSM

Passo Onde O que fazer
1 Comunicação → Template → Agregar Definir nombre interno + función (Aviso Vencimiento)
2 Escribir cuerpo Usar variables ({nome}, {valor}, {vencimento})
3 Marcar "Enviar Enlace Financiero" Quaza agrega botón "Pagar ahora"
4 Salvar Quaza envía a Meta automáticamente
5 Esperar 1-24h Meta valida
6 Verificar status Si "Aprobado" pode usar. Si "Rechazado", ajustar texto y reenviar

Fluxo 4: Cliente reclamó que no recibió boleto

Passo Onde O que fazer
1 Atendente abre ficha do cliente Confirmar email/WhatsApp registrado
2 Comunicação → Envío WhatsApp Filtrar por idCliente — última mensaje fue quando? Estado=Enviado?
3 Si "Falla" Ver motivo: número errado, opt-out, bloqueado
4 Comunicação → Campaña Filtrar por tarefa "Aviso de vencimiento" — el cliente está en la lista?
5 Si no está Cliente está en opt-out o filtro da campaña lo excluyó (situación errada, etc.)
6 Solución Reenvio manual via Selección (1 destinatário) ou enviar boleto direto via ficha cliente

Pegadinhas frequentes

1. Email yendo al spam masivamente
Causa: domínio sem SPF/DKIM/DMARC, IP listado em RBL, conteúdo com palavras suspeitas ("grátis", "ganhe"), volume muito alto sem warmup. Solución: configure DNS, faça warmup (10 → 50 → 500 → milhares ao longo de semanas), use ferramenta tipo mail-tester.com pra checar.
2. WhatsApp prohibiendo número Business
Causa: muitas mensagens proativas sem janela 24h, conteúdo classificado como spam pelo destinatário (cliente clica "Bloquear"), enviar HSM não aprovado, conteúdo proibido (jogos, adulto). Solución: respeite janela 24h, use só HSM aprovado, mantenha taxa de reclamação < 0.1%.
3. Campaña grande travando o sistema
Disparar 50k mensajes en un clic sobrecarga el gateway + cron Quaza. Usa lote menor (5k por vez) o agenda horarios distintos. Algunas tarefas (Aviso vencimiento) ya hacen eso automáticamente en batches.
4. SMS llegando "DESCONOCIDO" al celular do cliente
Sem short code ou nome remetente cadastrado. Configure o campo "Remitente" no gateway SMS (até 11 chars). Alguns países exigem registro prévio do remetente.
5. Saldo SMS se acabó en medio da campaña
Campaña pra 5k clientes mas gateway tinha saldo pra só 2k. Mensagens param no meio — fica confuso. Solución: configure "Saldo Mínimo" alto pra ser avisado antes de acabar, e monitor periodicamente.
6. Template WhatsApp rechazada por Meta
Motivos comunes: texto demasiado genérico ("hola, tenemos novedades!"), variables sin contexto ({valor} no início), prometendo benefício sem qualificar, categoria incorreta. Solución: ler diretrizes Meta + ser específico no texto.
7. Configuração SMTP solo con "Principal=No"
Si ningún servidor está marcado Principal, Quaza no envía. Sempre ten al menos uno Principal=Sí. En multi-servidor: 1 Principal, otros como fallback ordenados.

Galeria de telas

Campanha
Campanha
Selecao
Selecao
Notificacao
Notificacao
Emailconfig
Emailconfig
Smsconfig
Smsconfig
Whatsconfig
Whatsconfig
Whatstemplate
Whatstemplate
Whatsenvio
Whatsenvio
Etiqueta
Etiqueta

Documentos relacionados

Aprofunde-se nos temas conexos:
  • Cliente — email/WhatsApp/celular registrados en la ficha son origen do envío
  • Administração — testar envio rápido pela aba Configurações; cron de campanhas em Tarefas
  • Chat — atención omnicanal en vivo (WhatsApp, bot, respuestas rápidas)
  • Portal / Área do Cliente — autoatendimento do cliente final (2da vía, OS, dependientes, recomendaciones)
  • Mapa — visualización geográfica de clientes, CTOs, postes, cables FO (georreferencia)
  • Verificações — auditoria "cliente sin boleto" usa email/WhatsApp aquí configurado
  • Painéis — alerta "Campañas com envio não concluído" linka direto pra Campaña → Errores
  • Suporte / OS — notificação automática de OS creada vai pelo canal configurado aqui
  • Mensalidade — aviso de vencimiento + boleto va por el canal definido en el contrato
  • Cobrança — boleto/QR enviado por email/WhatsApp vía template

FAQ

Puedo usar SMTP do propio servidor do provedor?

Pode — pero mantén el IP "caliente" (warmup), monitorea reputación (sender score), implementa SPF/DKIM. En volumen alto (>1000 emails/día) considera servicio dedicado (AWS SES, SendGrid, Mailgun).

Cuánto cuesta enviar SMS / WhatsApp?

Depende do gateway. Estimaciones: SMS ~Gs. 200-500 por envío; WhatsApp HSM ~Gs. 150-1000 por conversación iniciada. Conversación dentro da ventana 24h es gratis en WhatsApp.

Cliente pode optar por no recibir? Como respeto?

Sim — agrega campo opt-out en la ficha do cliente. Filtros de campaña deven excluir opt-out. Para Email es obligatorio enlace "darse de baja" en el pie (Ley de protección de datos).

Como agendar uma campaña para correr mañana a as 9h?

Crie a campanha como rascunho hoje, depois ative no horário desejado. Quaza não tem agendamento nativo de campanha — para envios recorrentes use Tarefa.

Puedo enviar imagen/PDF por WhatsApp?

Sim — templates HSM de Meta aceptan medios (imagen, PDF, video). En la template, marca la variable de tipo medio + sube el archivo. Límite: 5MB por medio.

Como veo si el email cayó en el spam do cliente?

No há forma de ver directo — Quaza solo sabe si el gateway aceptó. Indicaciones indirectas: cliente reclama, tasa de apertura cae drásticamente, enlace en el email no es clickeado. Usa mail-tester.com para evaluar configuração.

Templates poden tener botones clickeables?

Sí en WhatsApp HSM — hasta 3 botones (URL, teléfono, "hacer pago"). En SMS no se pode. En Email la mayoría de os clientes renderiza HTML con botones.