Crie seus próprios apps do zero
Um guia passo a passo para quem nunca escreveu código.
Você descreve a tarefa em palavras simples — a IA cria o app e o publica sozinha em um servidor seguro.
O que é vibe coding
É uma forma de criar software descrevendo a tarefa para uma IA em palavras — em vez de escrever código à mão. A IA escreve o programa. Você define a direção, avalia o resultado e o refina.
A IA escreve o código. De você — uma explicação clara da tarefa, como ao instruir um novo colega de equipe.
O que precisa acontecer, para quem, quais dados e o que conta como resultado. Quanto mais específico, melhor.
A IA escreve o código, cria um servidor e publica o app. Você avalia e refina.
Documentação e ajuda
Duas documentações diferentes: uma para você aprender sozinho, a outra para entregar a um modelo de IA.
Passo 1. Escolha uma ferramenta
Um app é criado em uma ferramenta de vibe coding — uma IA que sabe escrever arquivos e executar comandos. Um chat comum (ChatGPT na web) não serve.
Passo 2. Crie seu primeiro app
Um passo a passo detalhado — siga ponto por ponto, etapa por etapa.
- 1Entre com seu Bitrix24
Abra a plataforma e clique em “Entrar com o Bitrix24”. Autorize (um QR code também funciona) e escolha a conta certa na lista.
- 2Abra a criação de chave
Uma chave é o passe que seu app usa para trabalhar com seu Bitrix24. Há duas formas de criar uma:
- No painel — o botão “Criar chave de API”.
- Ou na seção “Chaves de API” (barra lateral esquerda) — o botão “Criar chave”.
- 3Preencha as configurações da chave
Na janela “Criar chave de API”, defina:
- Nome da chave — para você reconhecê-la depois (ex.: “Resumo de negócios”).
- Modo de acesso — “Somente leitura” se o app apenas exibe dados, ou “Leitura e escrita”.
- Permissões — todas vêm selecionadas por padrão; mantenha apenas as que o app precisa.
- Validade — “Sem limite”, 30 / 90 / 180 dias ou 1 ano.
- Opcional — “Configurações avançadas”: endereços IP permitidos e um limite de requisições por minuto.
- 4Crie a chave e copie o prompt
Clique em “Criar”. A chave é exibida UMA ÚNICA vez — copie já o texto de “Copiar prompt” (ele já inclui sua chave) ou “Copiar chave”.
- 5Cole o prompt na IA
Abra o Claude Code ou o Codex, cole o prompt copiado e acrescente, em palavras simples, qual app você precisa. Veja abaixo como é um prompt.
- 6Deixe a IA criar e publicar
A IA escreve o código, cria um servidor Black Hole e publica o app. Se faltar alguma permissão, ela informará quais adicionar — volte e edite a chave.
- 7Abra o app pronto
Vá até a seção “Servidores Black Hole”, encontre seu servidor e clique em “Abrir”. Se a incorporação estiver configurada, o app aparece direto dentro do Bitrix24 — no menu, em um card de CRM, em uma tarefa ou em um chat.
Minha chave de API da plataforma Vibecode: vibe_api_xxxxxxxxxxxx Documentação: https://vibecode.bitrix24.com/v1/me Crie para mim um app [descreva o app] e publique-o em um servidor
Para você mesmo e um único app. Funciona em seu nome — todos veem os mesmos dados. A chave é criada na seção “Chaves de API”.
Quando uma equipe usa o app ou ele precisa ser incorporado dentro do Bitrix24. Cada colaborador recebe suas próprias permissões. A seção “Chaves de autorização”.
A chave é exibida uma única vez. Você não poderá vê-la de novo — copie-a já. Perdeu ou fechou a janela? É só criar uma nova e revogar a antiga.
Como explicar à IA o que você quer — para obter o resultado perfeito
Trate a IA como um novo colega de equipe: dê contexto, discuta a ideia e avalie o que foi feito. Quanto mais claro você explicar, mais perto do perfeito fica o primeiro resultado.
O que fazer, para quem, quais dados usar e o que conta como resultado. “Um painel por semana”, não apenas “um painel”.
Antes de pedir código, converse sobre a ideia com a IA em palavras simples — como um gerente de produto, não um programador. E peça ao modelo que faça perguntas: cada pergunta revela um bug futuro.
Nada de “tudo de uma vez”. Em pequenos passos, em um ciclo de “prompt → avaliação → refino”. Corrija de forma cirúrgica em vez de reescrever o projeto inteiro.
O que evitar
- Um pedido vago demais — a IA segue pelo caminho errado.
- Esperar um resultado perfeito após um único prompt — é um processo iterativo.
- Aceitar o código sem testá-lo com dados de exemplo.
- Reescrever o projeto inteiro de uma vez em vez de fazer edições cirúrgicas.
- Colar dados reais de clientes no texto do prompt ou em capturas de tela.
Como é um bom prompt
“Crie um app de resumo de negócios para a equipe de vendas. Toda manhã às 9:00, envie ao gestor um resumo no chat sobre o dia anterior: total de novos negócios, top-5 vendedores por receita, negócios sem tarefas e negócios parados há mais de 7 dias. Pegue os dados do CRM, do pipeline “Vendas”; valores com a variação em relação ao dia anterior. Se não houve novos negócios — envie um breve “sem negócios ontem”. Adicione um botão “Atualizar agora”. Publique em um servidor e me envie o link.”
Tem tudo: o que é o app, para quem, quando dispara, quais dados e em que forma, o caso de exceção e o desfecho — a publicação. Quanto mais completo o parágrafo, mais perto do perfeito fica o resultado já na primeira tentativa.
Depois do lançamento
Seu primeiro app não é a linha de chegada. É fácil aprimorá-lo, incorporá-lo ao Bitrix24 e revertê-lo se uma alteração não der certo.
Volte à IA, descreva as edições em palavras simples — ela altera o código e republica o app.
Mostre o app onde for prático: no menu, em um card de CRM, em uma tarefa ou em um chat — escolha os pontos de incorporação.
A plataforma guarda uma versão do código a cada publicação (a seção “Fontes do app”). Se uma edição quebrou algo, você pode republicar uma versão anterior.
O que mais há na conta
Quando você se sentir à vontade com o primeiro app, a conta tem muito mais a oferecer. Cada seção entrega à IA um código pronto por meio de um botão “Usar”.
Sua tela inicial após entrar: saldo, requisições de hoje, taxa de sucesso e acesso rápido a cada seção.
As chamadas do seu app: quantas requisições, a taxa de sucesso, onde estão os erros. Aparece após as primeiras chamadas reais — uma seção vazia logo após a publicação é normal.
Saldo, recargas e o histórico de cobranças. Servidores e modelos de IA potentes consomem Vibe credits; ao zerar, eles param.
Chatbots para o mensageiro do Bitrix24 — eles respondem a mensagens e reagem a eventos da conta.
Um bot-funcionário de IA pronto, atuando dentro do Bitrix24 (a seção “Agentes”). O acesso é concedido mediante solicitação.
Armazenamento de arquivos para apps — pague pelo uso, isolado por chave. A seção “Armazenamento”.
Conexão de serviços externos: a plataforma emite uma chave comum e revogável. Aprove apenas o login que você mesmo iniciou.
Backups de servidor: um snapshot do disco inteiro, restauração em um novo servidor. Ativado nas configurações.
Hospedagem densa — vários apps em um servidor. Para quem está escalando suas soluções.
Trabalho em equipe e acesso
Se você for administrador da conta Bitrix24, pode configurar quem faz o quê na plataforma.
Duas configurações separadas: acesso à conta (login) e o direito de criar chaves, servidores e bots. Configuradas de forma independente.
Quantas chaves, servidores e bots um colaborador pode criar — definido pelo administrador da conta.
Um log de ações (quem, quando, de onde) e o tratamento de solicitações de acesso dos colaboradores — nas seções do administrador.
Se você “não tem permissão” para alguma ação, foi o administrador que provavelmente configurou assim. Mande uma mensagem a ele ou envie uma solicitação de acesso direto da conta.
Segurança
Algumas regras simples protegem você e os dados dos seus clientes. Aqui estão as três principais — leia a análise completa na página de segurança.
Um passo barra 99% das tentativas de roubo de conta. Ativa em um minuto.
Ela abre tudo a que você tem acesso. Não a coloque no código, não a encaminhe em chats.
É acesso total à internet sem login. Não o ative a menos que entenda as consequências.
Quando o app estiver pronto, peça à IA que revise o código gerado em busca de vulnerabilidades (melhor com um “olhar novo”, em uma nova sessão). Após a publicação, repita a verificação: produção pode revelar riscos que não existiam durante o desenvolvimento.
