Central de Ajuda Quaza Provedores

Como fazer a configuração de integração com a telefonia móvel Tá Telecom (PT)

Como fazer a configuração de integração com a telefonia móvel Tá Telecom — Quaza

Nesse tutorial vamos te mostrar como fazer a configuração de integração com a telefonia móvel Tá Telecom.

 

Nesse tutorial vamos te mostrar como fazer a configuração de integração com a telefonia móvel Tá Telecom.

 

1º. Para configurar integração com a Tá Telecom, precisamos conceder as permissões necessárias para os grupos de usuário que terão acesso:

Essas permissões estão localizadas no menu Admin > Grupo, acessando o grupo desejado vamos no sub-menu Telefonia. as permissões necessárias são as destacadas na imagem:

 

2º. Depois de liberar as permissões esses menus utilizados já deverão estar disponíveis:

 

3º. Agora que já estamos com o menu disponível, podemos cadastrar as informações da integração e testar a conexão. Para isso, vamos acessar o menu Telefonia > Integrador e clicar no botão "+ Adicionar configuração".
Nesta tela, vamos preencher os campos de acordo com a integração e adicionar o "ID Cliente API".

 

4º. Depois de preencher, podemos testar a conexão da API e, se estiver tudo ok, teremos uma mensagem de sucesso!


 

5º. Agora que já temos o sistema integrado com a Tá Telecom, podemos importar as informações que já estão cadastradas na plataforma, como planos, simCards e números. Abaixo, imagens de como fazer a importação desses dados para o sistema:

Importação de planos:

Importação de SimCards:

 

Observação: 

  • Os SimCards serão importados como estão na plataforma. Podem estar cancelados, inativos ou ativos. 
    Se estiver ativo e já existir um cliente com um contrato ativo no sistema, esse vínculo com o cadastro do cliente será feito automaticamente, criando um usuário no menu Telefonia > Usuário. Se não possuir um cliente com contrato ativo, esse SimCard será importado sem um vínculo com cadastro de cliente. 
    Recomendamos fazer o cadastro do cliente e contrato para fazer essa ligação.

 

  • O integrador não tem ligação com a parte financeira do sistema e não faz nenhuma alteração de valor de contrato ou criação de débitos. Recomendamos criar um serviço de contrato para os produtos de telefonia e fazer o cadastro no contrato dos clientes que irão utilizar. Assim, pode se definir um valor fixo para esses serviços e gerar os financeiros referentes a esses serviços.

 

 

Após importar essas informações, já estará finalizada a configuração inicial para utilizar a integração com a Tá Telecom. Para saber mais sobre como utilizar essa integração, acesse a nossa documentação Como utilizar o integrador Tá Telecom.

 

 

Em caso de dúvidas ou problemas, não hesite em contatar nosso suporte. Estamos aqui para ajudar!

Agradecemos por utilizar nossa documentação!

Glossário

Termo Significado
Quaza Sistema ERP/BSS para ISP — gestão integrada de cliente, financeiro, fiscal, técnico.
Provedor Empresa que opera o sistema Quaza.
Cliente Assinante final do serviço de internet/telefonia/TV.
Contrato Vínculo formal entre cliente e provedor.
Operador Funcionário que opera o sistema.
Permissão Direito de acesso vinculado a papel.
Auditoria Registro de quem fez o quê e quando.
API REST Interface programática para integração externa.
Webhook Notificação automática para sistemas externos.
Cron / crontab Tarefa agendada que roda automaticamente.

Pegadinhas frequentes

1. Permissões mal configuradas. Operador sem acesso ao módulo não consegue executar a ação descrita.
2. Dados faltando em pré-requisito. Esta tela depende de cadastros anteriores estarem completos.
3. Cache do navegador. Após mudança, force refresh (Ctrl+F5) se a tela não atualizar.
4. Operação irreversível. Algumas ações não podem ser desfeitas — confira antes de salvar.
5. Filtros ativos. Listas filtradas escondem registros — limpe filtros se faltar dado.

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

CICLO COMPLETO DE OPERAÇÃO QUAZA ───────────────────────────────── ┌──────────────────────────────────────────┐ │ 1. PREPARAÇÃO │ │ ───────────── │ │ - usuário com permissão correta │ │ - cadastros pré-requisitos prontos │ │ - integrações configuradas │ │ - equipe treinada nas operações │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 2. EXECUÇÃO │ │ ──────────── │ │ - input do operador, API ou cron │ │ - validação 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 do registro atualizado │ └──────────────────┬───────────────────────┘ ▼ ┌──────────────────────────────────────────┐ │ 4. ACOMPANHAMENTO │ │ ───────────────── │ │ - revisão periódica (semanal/mensal) │ │ - identificação de desvios e exceções │ │ - ajustes finos de configuração │ │ - treinamento contínuo da equipe │ └──────────────────────────────────────────┘

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.