Central de Ajuda Quaza Provedores

Definição do número a ser utilizado Antes de iniciar o processo técnico, o cliente deve definir qual número será ativado na API .

Aplicável para clientes Quaza Tecnologia

Este guia tem como objetivo orientar o provedor em todas as etapas necessárias para ativar a API Oficial do WhatsApp (Meta), garantindo uma integração estável e em conformidade com as regras da Meta.

1. Definição do número a ser utilizado

Antes de iniciar o processo técnico, o cliente deve definir qual número será ativado na API.

Regras e cuidados

• O número pode ser móvel ou fixo.

• Caso seja fixo, não pode haver URA ou gravação configurada no momento da ativação (a linha precisa receber a ligação de verificação da Meta).

• Caso seja móvel, o número deve receber SMS ou ligação.

• Em ambos os casos o número não pode estar ativo em nenhum aplicativo WhatsApp (pessoal ou Business).
  
  

  ⚠️ Importante:
  Se o número estiver ativo em um aplicativo WhatsApp, o cliente deve desconectá-lo antes da ativação, pois todo o histórico de conversas será perdido.
  Após a ativação, o número ficará vinculado exclusivamente ao chat da Quaza e não receberá chamadas via WhatsApp, apenas ligações normais da operadora.

2. Acesso ao Meta Business (Facebook Business Manager)

O cliente precisa ter acesso total (administrador) ao Meta Business Manager da empresa.

Acesso:

• Link direto: https://business.facebook.com/

• Login deve ser feito com a conta de administrador geral, preferencialmente o Facebook corporativo da empresa.

3. Localizando e validando a conta do WhatsApp

Etapas:

1. Dentro do Meta Business, acesse o menu lateral esquerdo (parte inferior).

2. Vá em Configurações do negócio.

3. Clique em Contas > Contas do WhatsApp.

4. Clique em Adicionar > Criar nova conta do WhatsApp.

Preencha o formulário conforme solicitado, garantindo que:

• O número que será ativado esteja corretamente vinculado.

• O nome da 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 da empresa esteja verificado (necessário para uso de mensagens personalizadas).

Adicione um método de pagamento válido (cartão de crédito internacional)

• No momento da adição, a Meta realiza uma transação de teste simbólica, que pode ficar bloqueada por até 48h.

4. Verificação da empresa

Para que a API funcione corretamente, a empresa precisa estar verificada no Meta Business.

Exigências:

• Informar CNPJ, Razão Social, endereço, site e telefone comercial.

• Enviar documentos sociais (contrato social ou documento equivalente) quando solicitado pela Meta.

• Ter um administrador com permissão total na conta.

• Ter nome e número comerciais válidos, compatíveis com os dados oficiais.

⏱️ O prazo de aprovação pode variar de minutos até 24h, dependendo da Meta.

Após a integração, a Meta iniciará automaticamente a validação do nome exibido e da imagem de perfil.

✅ Boas práticas para aprovação:

• O nome exibido deve coincidir com o CNPJ e o domínio do site da empresa.

• A foto de perfil deve conter o logotipo oficial, sem elementos promocionais.

• Caso o nome não seja aprovado, a Meta informará o motivo e o cliente deverá realizar o ajuste antes de prosseguir.

5. Ativação do número no sistema Quaza

Após a aprovação da conta e validação da Meta:

Acesse no sistema Quaza:

Módulo: Comunicação → Configuração de WhatsApp → Adicionar WhatsApp Configuração

Preencha:

• Nome da configuração

• Número vinculado

• Dados de integração

Em seguida, clique em “Conectar com Facebook Business”.
Isso abrirá uma nova aba para login na conta Meta do administrador geral (pessoa física).

➡️ Os campos de API ID e Token serão preenchidos automaticamente.

Caso a conexão automática não funcione:

1. Acesse: https://meta.quazatecnologia.com.br/

2. Conecte-se com a conta Meta Business do administrador.

3. Copie os tokens de integração e cole manualmente nos campos correspondentes dentro do sistema Quaza.

6. Criação e importação de templates de mensagens

Após a ativação e integração, o cliente poderá criar os modelos de mensagens (templates) que serão utilizados na comunicação oficial.

⚠️ A criação e manutenção dos templates devem seguir as regras da Meta, sendo responsabilidade do cliente.
A Quaza realiza apenas o processo técnico de integração.

📘 Guia complementar:
👉 Acesse o passo a passo para criação e importação de templates no sistema Quaza

Caso encontre alguma dificuldade durante o processo de ativação, entre em contato com o Suporte Quaza Tecnologia.

Glossário

Pegadinhas frequentes

FAQ

Quem pode acessar essa funcionalidade?

Depende da permissão do usuário. Confira com o administrador do Quaza se você não vê a opção.

O que fazer se aparecer um erro?

Anote a mensagem completa, screenshot, e abra um chamado no suporte do Quaza com esses dados.

Esta funcionalidade tem versão para cliente final?

Algumas funcionalidades têm Portal do Cliente. Verifique no módulo Portal .

Posso integrar via API?

Sim — a maioria das funcionalidades do Quaza expõe endpoints REST. Consulte a documentação técnica.

Quaza tem treinamento oficial?

Sim — equipe de suporte oferece sessões de onboarding sob agendamento.

Ciclo completo da operação

Boas práticas operacionais

Para tirar o máximo desta funcionalidade, observe os pontos abaixo. São práticas que provedores experientes adotam para evitar erros recorrentes e maximizar valor extraído do Quaza.

Antes de operar

• Confirme permissão de acesso: nem todo operador tem permissão para todas as funcionalidades. Verifique com o administrador do Quaza se algo não aparece como esperado. Permissões são 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 você precisa ter o cliente cadastrado, plano de vendas configurado, e regras de cobrança definidas.
• Treine pelo menos 2 operadores: redundância previne paralisação por ausência. Funcionário pode sair, ficar doente, ter dia ruim. Mantenha conhecimento distribuído entre múltiplas pessoas.
• Documente procedimentos internos: crie checklist próprio para operações recorrentes. Quem opera amanhã agradece — especialmente se for funcionário novo.

Durante a operação

• Documente decisões não óbvias: se você ajustou algo de forma diferente do default, anote o porquê. Próximo operador agradece e evita refazer análise.
• Operações 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 pode não ser possível em todas as ações. Em dúvida, faça export ou imprima tela antes.
• Comunique alterações: mudanças que impactam outras equipes (atendimento, 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 da operação. Acompanhe tendências, não só valores absolutos. Variação maior que 20% merece investigação.
• Auditoria mensal: revise sample de operações do mês passado. Use logs para confirmar que tudo aconteceu como esperado, sem desvios silenciosos.
• Compare com período anterior: "Vendi R$ 100k" — é bom? Compare com mês anterior, mesmo mês ano passado. Contexto importa mais que número absoluto.

Resolução de problemas

• Anote a mensagem de erro completa: copie o texto exato. Captura de tela 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 suporte. Isso acelera resolução.
• Procure no 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 suporte do Quaza resolve mais rápido com contexto: o que esperava, o que aconteceu, frequência, screenshots.

Indicadores típicos a acompanhar

Cada provedor define seus próprios indicadores, mas alguns são quase universais para qualquer operação no Quaza:

• Volume mensal processado (registros/transações/eventos)
• Taxa de erro (% de operações que falharam)
• Tempo médio de processamento
• Cobertura (% da carteira atendida pela funcionalidade)
• Satisfação operacional (feedback da equipe que usa)

Compare valores atuais com média dos últimos 3 meses. Variação maior que 20% em qualquer direção merece investigação — pode ser melhoria sustentável ou degradação silenciosa.

Recursos relacionados no Quaza

Este recurso se conecta com outros módulos do sistema. Conhecer essas conexões ajuda no troubleshooting e em decisões operacionais:

• Cadastro de cliente — base de tudo no Quaza. Cliente bem cadastrado evita problemas downstream.
• Plano de Contas — onde o impacto financeiro é classificado contabilmente.
• Logs de auditoria — histórico de quem fez o quê e quando, essencial para diagnóstico.
• Permissões e papéis — definem quem pode operar o quê.
• Tarefas crontab — automações que tocam neste recurso periodicamente.

Referência rápida

Atalhos e shortcuts para operação eficiente:

• Busca avançada: use filtros de data, status, responsável para reduzir lista. Filtro padrão pode esconder registros antigos.
• Exportação: a maioria das listas exporta para CSV/Excel. Útil para análise externa ou backup pré-mudança.
• Histórico: cada registro tem timeline de modificações. Acesse via botão "Histórico" ou aba lateral.
• Atalhos de teclado: Ctrl+F (busca), Ctrl+S (salvar), Esc (cancelar) na maioria das telas.
• Permissão restrita: se botão estiver cinza, é falta de permissão — não bug.