Criar Apps

Um app de parceiro estende o Botzetta: aparece no menu das empresas que o instalam, recebe eventos por webhook e chama a API da Plataforma em nome de cada empresa, dentro dos escopos que ela autorizou. O app roda na sua infraestrutura, com a linguagem que você quiser.

Este guia usa só HTTP: OAuth 2.0, JSON, HMAC e postMessage. Os exemplos são em Node.js sem dependências, mas qualquer linguagem com cliente HTTP e criptografia serve.

O caminho

Passo	Página	O que você faz
1	Conceitos	Entende instalação, escopos, tokens e o que o app pode fazer
2	Começar	Cria a conta no portal, a organização e ativa o 2FA. Ganha uma empresa sandbox
3	Cadastrar o app	Cria o app no portal: URLs, credenciais, escopos e eventos
4	Instalação e OAuth	Implementa a URL de instalação, o callback e a renovação de tokens
5	Chamar a API	Usa o token da empresa, trata erros, limites e idempotência
6	Webhooks	Recebe eventos, confere a assinatura e deduplica
7	Tela em iframe	Mostra a sua página dentro do Botzetta e valida o usuário no seu backend
8	Menu do Botzetta	Define como o app aparece no menu
9	Chaves de integração	Conhece a alternativa para integrações de uma empresa só
10	Publicar	Publica versões, envia para revisão e distribui
11	Obrigações, Termos e DPA	Confere o que o parceiro se compromete a cumprir
12	Exemplo ponta a ponta	Roda um app completo em Node, sem bibliotecas

Endereços

O quê	Onde
Portal do parceiro	https://partners.botzetta.com
API da Plataforma	https://api.botzetta.com/plataforma/v1
Botzetta (onde o cliente usa o app)	A URL aparece no portal, na página Sandbox da organização
Esta documentação	https://developers.botzetta.com/docs/

Versão do contrato

Cada página deste guia indica a versão do contrato da Plataforma que descreve (hoje, 1.10). A API /plataforma/v1 só recebe mudanças compatíveis: campos e endpoints novos podem aparecer, e o seu código deve ignorar o que não conhece.