Definição del número a ser utilizado Antes de iniciar o processo técnico, o cliente debe definir qual número será ativado en la API .
Aplicável para clientes Quaza Tecnologia
Este guia tem como objetivo orientar o proveedor em todas as etapas necessárias para lativar a API Oficial del WhatsApp (Meta), garantindo uma integracción estável e em conformidade com as regras de la Meta.
1. Definição del número a ser utilizado
Antes de iniciar o processo técnico, o cliente debe definir qual número será ativado en la API.
Regras e cuidados
-
O número puede ser móvel ou fixo.
-
Caso seja fixo, não puede haver URA ou gravacción configurada en el momento de la ativacción (a linha necesita receber a ligacción de verificacción de la Meta).
-
Caso seja móvel, o número debe receber SMS ou ligacción.
-
Em ambos os casos o número não puede estar ativo em nenhum aplicativo WhatsApp (pessoal ou Business).
⚠️ Importante:
Se o número estiver ativo em um aplicativo WhatsApp, o cliente debe desconectá-lo antes de la ativacción, pois todo o histórico de conversas será perdido.
Después a ativacción, o número ficará vinculado exclusivamente ao chat de la Quaza e não receberá chamadas via WhatsApp, apenas ligações normais de la operadora.
2. Acesso ao Meta Business (Facebook Business Manager)
O cliente necesita ter acesso total (administrador) ao Meta Business Manager de la empresa.
Acesso:
-
Link direto: https://business.facebook.com/
-
Login debe ser feito com a cuenta de administrador geral, preferencialmente o Facebook corporativo de la empresa.
3. Localizando e validando a cuenta del WhatsApp
Etapas:
-
Dentro del Meta Business, acceda o menu lateral esquerdo (parte inferior).
-
Vá em Configuraciones del negócio.
-
Clic em Cuentas > Cuentas del WhatsApp.
-
Clic em Añadir > Criar nova cuenta del WhatsApp.

Preencha o formulário conforme solicitado, garantindo que:
-
O número que será ativado esteja corretamente vinculado.
-
O nome de la empresa e endereço comercial estejam preenchidos.
-
O Business ID e o WhatsApp Business Account ID (WABA ID) estejam visíveis e anotados.
-
O domínio de la empresa esteja verificado (necessário para uso de mensagens personalizadas).

Añada um método de pago válido (cartão de crédito internacional)

4. Verificacción de la empresa
Para que a API funcione corretamente, a empresa necesita estar verificada en el Meta Business.
Exigências:
-
Informar CNPJ, Razão Social, endereço, site e telefone comercial.
-
Enviar documentos sociais (contrato social ou documento equivalente) cuando solicitado pela Meta.
-
Ter um administrador com permiso total en la cuenta.
-
Ter nome e número comerciais válidos, compatíveis com os dados oficiais.
⏱️ O prazo de aprovacción puede variar de minutos até 24h, dependendo de la Meta.
Después a integracción, a Meta iniciará automaticamente a validacción del nome exibido e de la imagem de perfil.
✅ Boas práticas para laprovacción:
-
O nome exibido debe coincidir com o CNPJ e o domínio del site de la empresa.
-
A foto de perfil debe conter o logotipo oficial, sem elementos promocionais.
-
Caso o nome en el seja aprovado, a Meta informará o motivo e o cliente deverá realizar o ajuste antes de prosseguir.
5. Ativacción del número en el sistema Quaza
Después a aprovacción de la cuenta e validacción de la Meta:
Acceda en el sistema Quaza:
Módulo: Comunicacción → Configuración de WhatsApp → Añadir WhatsApp Configuración
Preencha:
-
Nome de la configuración
-
Número vinculado
-
Dados de integracción

Em seguida, clic em “Conectar com Facebook Business”.
Isso abrirá uma nova aba para login en la cuenta Meta del administrador geral (pessoa física).
➡️ Os campos de API ID e Token serão preenchidos automaticamente.
Caso a conexão automática en el funcione:
-
Acceda: https://meta.quazatecnologia.com.br/
-
Conecte-se com a cuenta Meta Business del administrador.
-
Copie os tokens de integracción e cole manualmente en los campos correspdondentes dentro del sistema Quaza.
6. Criacción e importacción de templates de mensagens
Después a ativacción e integracción, o cliente poderá criar os modelos de mensagens (templates) que serão utilizados en la comunicacción oficial.
⚠️ A criacción e manutenção de los templates devem seguir as regras de la Meta, sendo responsabilidade del cliente.
A Quaza realiza apenas o processo técnico de integracción.
📘 Guia complementar:
👉 Acceda o passo a passo para criacción e importacción de templates en el sistema Quaza
Caso encontre alguma dificuldade durante o processo de ativacción, entre em cuentato com o Soporte Quaza Tecnologia.
Glosario
| Término |
Significado |
| Quaza |
Sistema ERP/BSS para ISP — gestão integrada de cliente, financeiro, fiscal, técnico. |
| Proveedor |
Empresa que opera o sistema Quaza. |
| Cliente |
Assinante final del serviço de internet/telefonía/TV. |
| Contrato |
Vínculo formal entre cliente e proveedor. |
| Operador |
Funcionário que opera o sistema. |
| Permiso |
Direito de acesso vinculado a papel. |
| Auditoría |
Registro de quem fez o quê e cuando. |
| API REST |
Interface programática para integracción externa. |
| Webhook |
Notificación automática para sistemas externos. |
| Cron / crontab |
Tarea agendada que roda automaticamente. |
Trampas frecuentes
1. Permissões mal configuradas. Operador sem acesso ao módulo en el consegue executar a acción descrita.
2. Dados faltando em pré-requisito. Esta pantalla depende de cadastros anteriores estarem completos.
3. Cache del navegador. Después mudança, force refresh (Ctrl+F5) se a pantalla en el atualizar.
4. Operacción irreversível. Algumas ações en el podem ser desfeitas — confira antes de guardar.
5. Filtros ativos. Listas filtradas escdondem registros — limpe filtros se faltar dado.
FAQ
Quem puede acceder essa funcionalidade?
Depende de la permiso del usuário. Confira com o administrador del Quaza se usted en el vê a opção.
O que hacer se aparecer um erro?
Anote a mensaje completa, screenshot, e abra um chamado en el soporte del Quaza com esses dados.
Esta funcionalidade tem versão para cliente final?
Algumas funcionalidades têm Portal del Cliente. Verifique en el módulo Portal
.
Posso integrar via API?
Sim — a maioria de las funcionalidades del Quaza expõe endpoints REST. Consulte a documentacción técnica.
Quaza tem treinamento oficial?
Sim — equipe de soporte oferece sessões de onboarding sob agendamento.
Ciclo completo de la operacción
CICLO COMPLETO DE OPERAÇÃO QUAZA
─────────────────────────────────
┌──────────────────────────────────────────┐
│ 1. PREPARAÇÃO │
│ ───────────── │
│ - usuário com permiso correta │
│ - cadastros pré-requisitos prontos │
│ - integrações configuradas │
│ - equipe treinada en las operações │
└──────────────────┬───────────────────────┘
▼
┌──────────────────────────────────────────┐
│ 2. EXECUÇÃO │
│ ──────────── │
│ - input del operador, API ou cron │
│ - validacción automática de dados │
│ - persistência transacional │
│ - log de auditoria com timestamp/user │
│ - notificações por email/Slack/webhook │
└──────────────────┬───────────────────────┘
▼
┌──────────────────────────────────────────┐
│ 3. EFEITOS COLATERAIS │
│ ────────────────────── │
│ - dashboards atualizados em tempo real │
│ - relatórios refletem nova mudança │
│ - webhook dispara sistemas externos │
│ - histórico del registro atualizado │
└──────────────────┬───────────────────────┘
▼
┌──────────────────────────────────────────┐
│ 4. ACOMPANHAMENTO │
│ ───────────────── │
│ - revisão periódica (semanal/mensal) │
│ - identificacción de desvios e exceções │
│ - ajustes finos de configuración │
│ - treinamento contínuo de la equipe │
└──────────────────────────────────────────┘
Boas práticas operacionais
Para tirar o máximo desta funcionalidade, observe os pontos abaixo. São práticas que proveedores experientes adotam para evitar erros recorrentes e maximizar valor extraído del Quaza.
Antes de operar
-
Confirme permiso de acesso: nem todo operador tem permiso para todas as funcionalidades. Verifique com o administrador del Quaza se algo en el aparece como esperado. Permissões son vinculadas a papéis (operador, supervisor, admin).
-
Cadastros pré-requisitos completos: muitas funcionalidades dependem de outros cadastros estarem completos antes. Por exemplo, antes de criar um contrato usted necesita ter o cliente cadastrado, plano de ventas configurado, e regras de cobranza definidas.
-
Treine pelo menos 2 operadores: redundância previne paralisacción por ausência. Funcionário puede sair, ficar doente, ter dia ruim. Mantenha conhecimento distribuído entre múltiplas pessoas.
-
Documente procedimentos internos: crie checklist próprio para elperações recorrentes. Quem opera amanhã agradece — especialmente se for funcionário novo.
Durante a operacción
-
Documente decisões en el óbvias: se usted ajustou algo de forma diferente del default, anote o porquê. Próximo operador agradece e evita refazer análise.
-
Operaciones em massa pedem cuidado: antes de aplicar a 100+ registros, teste com 5 e revise resultado completo. Se possível, exporte CSV antes para ter como rollback.
-
Backup antes de mudanças grandes: cancelar/desfazer puede en el ser possível em todas as ações. Em dúvida, faça export ou imprima pantalla antes.
-
Comunique alterações: mudanças que impactam outras equipes (atención, financeiro) devem ser anunciadas com antecedência. Surpresa gera retrabalho.
Acompanhamento e revisão
-
Revisão semanal de 30 minutos: dedique tempo regular para revisar o que rodou, falhou, ficou pendente neste módulo. Anomalia detectada cedo custa 10x menos que descoberta tarde.
-
Defina KPIs próprios: 2-3 indicadores que medem saúde de la operacción. Acompanhe tendências, en el só valores absolutos. Variacción maior que 20% merece investigacción.
-
Auditoría mensal: revise sample de operações del mês passado. Use logs para confirmar que tudo aconteceu como esperado, sem desvios silenciosos.
-
Compare com período anterior: "Vendi R$ 100k" — es bom? Compare com mês anterior, mesmo mês ano passado. Contexto importa mais que número absoluto.
Resolução de problemas
-
Anote a mensaje de erro completa: copie o texto exato. Captura de pantalla ajuda. Anote quais passos levaram ao problema — facilita diagnóstico.
-
Tente reproduzir em ambiente de teste: se possível, simule o erro com dado dummy antes de pedir soporte. Isso acelera resolução.
-
Procure en el histórico: provavelmente alguém já viu erro similar. Veja log de auditoria para entender o que mudou recentemente.
-
Abra chamado bem documentado: equipe de soporte del Quaza resolve mais rápido com contexto: o que esperava, o que aconteceu, frequência, screenshots.
Indicadores típicos a acompanhar
Cada proveedor define seus próprios indicadores, mas alguns son quase universais para qualquer operacción en el Quaza:
- Volume mensal processado (registros/transações/eventos)
- Taxa de erro (% de operações que falharam)
- Tempo médio de processamento
- Cobertura (% de la carteira atendida pela funcionalidade)
- Satisfacción operacional (feedback de la equipe que usa)
Compare valores atuais com média de los últimos 3 meses. Variacción maior que 20% em qualquer direção merece investigacción — puede ser melhoria sustentável ou degradacción silenciosa.
Recursos relacionados en el Quaza
Este recurso se conecta com outros módulos del sistema. Conhecer essas conexões ajuda en el troubleshooting e em decisões operacionais:
-
Cadastro de cliente — base de tudo en el Quaza. Cliente bem cadastrado evita problemas downstream.
-
Plano de Cuentas — donde o impacto financeiro es classificado cuentabilmente.
-
Logs de auditoria — histórico de quem fez o quê e cuando, essencial para diagnóstico.
-
Permissões e papéis — definem quem puede operar o quê.
-
Tareas crontab — automações que tocam neste recurso periodicamente.
Referência rápida
Atalhos e shortcuts para elperacción eficiente:
-
Busca avançada: use filtros de data, status, responsável para reduzir lista. Filtro padrão puede escdonder registros antigos.
-
Exportacción: a maioria de las listas exporta para CSV/Excel. Útil para lanálise externa ou backup pré-mudança.
-
Histórico: cada registro tem timeline de modificações. Acceda via botón "Histórico" ou aba lateral.
-
Atalhos de teclado: Ctrl+F (busca), Ctrl+S (guardar), Esc (cancelar) en la maioria de las pantallas.
-
Permiso restrita: se botón estiver cinza, es falta de permiso — en el bug.