Começar
Tudo começa no portal do parceiro. A conta do portal é separada da sua conta de usuário do Botzetta, mesmo que o e-mail seja o mesmo.
1. Criar a conta e a organização
- Em Criar conta, informe nome, e-mail, senha e o nome da organização (a sua empresa de desenvolvimento). Ao criar, você aceita os Termos do Desenvolvedor e o DPA vigentes em nome da organização. Hoje eles estão em minuta provisória, sem valor jurídico: a versão final sai em uma nova URL versionada.
- Confirme o e-mail pelo link que chega na sua caixa.
- Entre no portal. Você é o dono da organização.
Os apps pertencem à organização, não a uma pessoa. Convide o seu time em Membros:
| Papel | Pode |
|---|---|
dono / admin | Tudo: publicar e ativar versões, enviar para revisão, editar o cadastro (URLs, webhook, suporte), gerar e revogar segredos, convidar membros, aceitar termos |
desenvolvedor | Criar apps, editar o rascunho, testar o webhook e ver os logs |
leitura | Só ver. Não acessa a sandbox |
2. Ativar a verificação em duas etapas (2FA)
Em Conta › Segurança, ative o 2FA com um aplicativo autenticador (TOTP). Gerar, rotacionar ou
revogar qualquer segredo (do app ou do webhook) exige uma sessão aberta com o código do 2FA. Sem ele
o portal recusa com ERR_2FA_OBRIGATORIO.
3. Entrar na sandbox
A sandbox é uma empresa de teste no Botzetta, criada automaticamente para a organização logo depois do cadastro. Na página Sandbox da organização:
- espere o status ficar pronta (leva poucos segundos);
- em Minha senha na sandbox, defina a sua senha. Cada membro tem um usuário próprio na sandbox, com o e-mail da conta do portal e perfil de administrador da empresa;
- use o link da página para abrir o Botzetta e entrar com esse e-mail e essa senha.
Anote a URL do Botzetta que aparece ali: é a origem que vai enquadrar a sua tela e para onde a
instalação redireciona (BOTZETTA_HOST_URL no exemplo). Em produção, é https://app2.botzetta.com.
A sandbox começa vazia. Crie pessoas, oportunidades e tickets de teste pelo próprio Botzetta (ou pela API, depois de instalar o app) para exercitar os seus fluxos. Use só dados fictícios.
4. Termos
Quando a Botzetta publica uma versão nova dos Termos ou do DPA, a organização fica com termos pendentes a partir da data de vigência, e um dono ou admin precisa aceitá-los em Termos. Veja Obrigações, Termos e DPA.