PhizClip: como criar um MiniApp dentro do PhizChat em menos de 1 hora

O PhizChat não é apenas um app de mensagens — é um ecossistema. E uma das funcionalidades mais poderosas para desenvolvedores é o PhizClip: o motor de MiniApps que permite criar e distribuir aplicações completas dentro da conversa, sem que o usuário precise sair do PhizChat para nada.

Se você já ouviu falar do WeChat Mini Programs na China, a proposta é a mesma — mas agora disponível para o Brasil, com suporte ao contexto local, integração com Phiz Pay e distribuição para todos os usuários do PhizChat.

O que é um PhizClip?

Um PhizClip é um mini aplicativo que roda dentro do PhizChat. Do ponto de vista técnico, é uma aplicação construída com HTML, CSS e JavaScript que usa a API pz.* para acessar recursos nativos do dispositivo e do app — como câmera, localização, sistema de pagamentos, informações do usuário e ciclo de vida da aplicação.

A grande vantagem para desenvolvedores: você escreve o código uma vez e ele roda em iOS, Android e desktop — sem precisar publicar na App Store, no Google Play ou manter múltiplos repositórios.

A API pz: tudo que você precisa

A base de qualquer PhizClip é a API global pz. Ela expõe funções organizadas em módulos:

• pz.env — acessa variáveis de ambiente, como o caminho do diretório do usuário

• pz.getSystemInfo / getSystemInfoAsync — obtém informações do dispositivo (versão do OS, tamanho de tela, etc.)

• pz.canIUse — verifica se uma API específica está disponível na versão atual do PhizChat antes de chamá-la

• pz.base64ToArrayBuffer / arrayBufferToBase64 — utilitários para manipulação de dados binários

• pz.getLaunchOptionsSync — obtém os parâmetros com que o PhizClip foi iniciado (útil para deep linking)

Ciclo de vida do MiniApp

Todo PhizClip tem um ciclo de vida gerenciado pelo PhizChat. Os eventos principais são:

• pz.onAppShow — disparado quando o MiniApp fica em primeiro plano

• pz.onAppHide — quando o usuário muda de tela mas não fecha o app

• pz.onError — captura erros não tratados em runtime

• pz.onPageNotFound — rota não encontrada

Esses eventos permitem que você salve estado, pause recursos (como câmera ou geolocalização) e retome exatamente onde o usuário parou — sem qualquer trabalho adicional de persistência.

Sistema de atualização automática

Um diferencial prático do PhizClip é o UpdateManager. Com ele, quando você publica uma nova versão do seu MiniApp, os usuários recebem a atualização automaticamente na próxima abertura, sem nenhuma ação manual:

const updateManager = pz.getUpdateManager();

updateManager.onUpdateReady(function() {
  // Nova versão disponível — forçar restart
  updateManager.applyUpdate();
});

updateManager.onUpdateFailed(function() {
  console.log('Atualização falhou. Usuário ainda na versão anterior.');
});

Isso elimina o problema clássico de apps nativos onde uma fração dos usuários fica presa em versões antigas indefinidamente.

Ferramentas de debug

Para desenvolvimento e diagnóstico, o PhizClip oferece:

• console.log / warn / error / group — exatamente como no browser

• pz.setEnableDebug — ativa um botão de debug visual no app em produção

• LogManager — logs persistentes que ficam no console local do dispositivo para análise posterior

Por que distribuir seu app dentro do PhizChat?

Construir um PhizClip não é apenas uma questão técnica — é uma decisão de distribuição. Quando seu MiniApp vive dentro do PhizChat, você ganha:

• Distribuição imediata — sem processo de aprovação de app store

• Base de usuários já instalada — todos os usuários do PhizChat podem acessar seu app sem instalar nada

• Integração nativa com Phiz Pay — pagamentos dentro do contexto da conversa

• Dados no Brasil — infraestrutura sob a LGPD, sem dependência de servidores estrangeiros

• Update over the air — deploy instantâneo para todos os usuários

Como começar

A documentação completa da API está disponível em PhizClip Docs. O fluxo básico é:

1. Criar sua conta de desenvolvedor no PhizChat

2. Estruturar seu projeto com app.js, app.json e as páginas em pastas

3. Usar a API pz.* para acessar recursos nativos

4. Testar no ambiente de desenvolvimento

5. Publicar — e o PhizChat distribui automaticamente

O modelo de MiniApps dentro de super apps já provou seu valor em escala global. O WeChat processa mais de 1 bilhão de usuários ativos com mini programs todos os dias. O PhizChat está construindo essa infraestrutura para o Brasil — e você pode fazer parte desde o início.

Acesse a documentação, crie seu primeiro PhizClip e distribua para milhões de usuários brasileiros sem precisar passar pela burocracia das lojas de aplicativo. Baixe o PhizChat e experimente o ecossistema.

é apenas um app de mensagens — é um ecossistema. E uma das funcionalidades mais poderosas para desenvolvedores é o PhizClip: o motor de MiniApps que permite criar e distribuir aplicações completas dentro da conversa, sem que o usuário precise sair do PhizChat para nada.

Se você já ouviu falar do WeChat Mini Programs na China, a proposta é a mesma — mas agora disponível para o Brasil, com suporte ao contexto local, integração com Phiz Pay e distribuição para todos os usuários do PhizChat.

O que é um PhizClip?

Um PhizClip é um mini aplicativo que roda dentro do PhizChat. Do ponto de vista técnico, é uma aplicação construída com HTML, CSS e JavaScript que usa a API pz.* para acessar recursos nativos do dispositivo e do app — como câmera, localização, sistema de pagamentos, informações do usuário e ciclo de vida da aplicação.

A grande vantagem para desenvolvedores: você escreve o código uma vez e ele roda em iOS, Android e desktop — sem precisar publicar na App Store, no Google Play ou manter múltiplos repositórios.

A API pz: tudo que você precisa

A base de qualquer PhizClip é a API global pz. Ela expõe funções organizadas em módulos:

• pz.env — acessa variáveis de ambiente, como o caminho do diretório do usuário

• pz.getSystemInfo / getSystemInfoAsync — obtém informações do dispositivo (versão do OS, tamanho de tela, etc.)

• pz.canIUse — verifica se uma API específica está disponível na versão atual do PhizChat antes de chamá-la

• pz.base64ToArrayBuffer / arrayBufferToBase64 — utilitários para manipulação de dados binários

• pz.getLaunchOptionsSync — obtém os parâmetros com que o PhizClip foi iniciado (útil para deep linking)

Ciclo de vida do MiniApp

Todo PhizClip tem um ciclo de vida gerenciado pelo PhizChat. Os eventos principais são:

• pz.onAppShow — disparado quando o MiniApp fica em primeiro plano

• pz.onAppHide — quando o usuário muda de tela mas não fecha o app

• pz.onError — captura erros não tratados em runtime

• pz.onPageNotFound — rota não encontrada

Esses eventos permitem que você salve estado, pause recursos (como câmera ou geolocalização) e retome exatamente onde o usuário parou — sem qualquer trabalho adicional de persistência.

Sistema de atualização automática

Um diferencial prático do PhizClip é o UpdateManager. Com ele, quando você publica uma nova versão do seu MiniApp, os usuários recebem a atualização automaticamente na próxima abertura, sem nenhuma ação manual:

const updateManager = pz.getUpdateManager();

updateManager.onUpdateReady(function() {
  // Nova versão disponível — forçar restart
  updateManager.applyUpdate();
});

updateManager.onUpdateFailed(function() {
  console.log('Atualização falhou. Usuário ainda na versão anterior.');
});

Isso elimina o problema clássico de apps nativos onde uma fração dos usuários fica presa em versões antigas indefinidamente.

Ferramentas de debug

Para desenvolvimento e diagnóstico, o PhizClip oferece:

• console.log / warn / error / group — exatamente como no browser

• pz.setEnableDebug — ativa um botão de debug visual no app em produção

• LogManager — logs persistentes que ficam no console local do dispositivo para análise posterior

Por que distribuir seu app dentro do PhizChat?

Construir um PhizClip não é apenas uma questão técnica — é uma decisão de distribuição. Quando seu MiniApp vive dentro do PhizChat, você ganha:

• Distribuição imediata — sem processo de aprovação de app store

• Base de usuários já instalada — todos os usuários do PhizChat podem acessar seu app sem instalar nada

• Integração nativa com Phiz Pay — pagamentos dentro do contexto da conversa

• Dados no Brasil — infraestrutura sob a LGPD, sem dependência de servidores estrangeiros

• Update over the air — deploy instantâneo para todos os usuários

Como começar

A documentação completa da API está disponível em PhizClip Docs. O fluxo básico é:

1. Criar sua conta de desenvolvedor no PhizChat

2. Estruturar seu projeto com app.js, app.json e as páginas em pastas

3. Usar a API pz.* para acessar recursos nativos

4. Testar no ambiente de desenvolvimento

5. Publicar — e o PhizChat distribui automaticamente

O modelo de MiniApps dentro de super apps já provou seu valor em escala global. O WeChat processa mais de 1 bilhão de usuários ativos com mini programs todos os dias. O PhizChat está construindo essa infraestrutura para o Brasil — e você pode fazer parte desde o início.

Acesse a documentação, crie seu primeiro PhizClip e distribua para milhões de usuários brasileiros sem precisar passar pela burocracia das lojas de aplicativo. Baixe o PhizChat e experimente o ecossistema.