Central de Ajuda Quaza Provedores

Ativacción de la API Oficial del WhatsApp (Meta) — Quaza (ES-AR)

Ativacción de la API Oficial del WhatsApp (Meta) — Quaza — Quaza

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:

  1. Dentro del Meta Business, acceda o menu lateral esquerdo (parte inferior).

  2. Vá em Configuraciones del negócio.

  3. Clic em Cuentas > Cuentas del WhatsApp.

  4. 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)

  • No momento de la adição, a Meta realiza uma transacción de teste simbólica, que puede ficar bloqueada por até 48h.

 

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:

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

  2. Conecte-se com a cuenta Meta Business del administrador.

  3. 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.