Visão geral
Veja abaixo uma visão geral dos requisitos de certificação do aplicativo. Para mais detalhes, consulte a seção Critérios de revisão. O app:-
Deve estar associado a um ID simples do aplicativo HubSpot.
- O seu aplicativo público listado deve ser único. Se você já tiver listado um aplicativo e quiser substituí-lo, deverá atualizar o aplicativo existente em vez de listar um novo.
- Não crie vários aplicativos que podem ser usados para resolver um mesmo caso de uso. Os aplicativos com funcionalidades semelhantes e que utilizam as mesmas APIs devem ser consolidadas em um único aplicativo.
- Deve usar a autenticação OAuth e todos os escopos necessários.
- Deve estar associado a um domínio verificado.
- Os ativos públicos associados ao seu aplicativo devem seguir as práticas recomendadas de segurança.
Benefícios da certificação de ganhos
Além dos benefícios de anunciar seu app, os apps certificados:- Um selo “Aplicativo certificado pela HubSpot” exibido na sua listagem no Marketplace de aplicativos.
- Têm uma maior visibilidade no marketplace de app da HubSpot:
- São incluídos no filtro de pesquisa “Aplicativo certificado pela HubSpot”.
- São elegíveis para inclusão nas coleções com curadoria do Marketplace de aplicativos.
- Acesso ao selo “Aplicativo certificado pela HubSpot” e as imagens nas redes sociais para compartilhar a conquista da certificação do aplicativo.
- Consideração favorável nas iniciativas de parceria e amplificação da HubSpot.
Critérios de revisão
Para obter a certificação, seu app deve demonstrar qualidade por meio de medidas quantitativas e descritores qualitativos de segurança, privacidade, confiabilidade, desempenho, usabilidade, acessibilidade e valor. Os requisitos abaixo são organizados por essas categorias e incluem exemplos de feedback construtivo que você pode receber.Segurança e privacidade
O app:- Deve estar associado a um ID simples do aplicativo HubSpot. Seu aplicativo deve autorizar as solicitações de API com o ID público do aplicativo HubSpot (e ID do cliente OAuth) associado à sua lista de aplicativos.
- Uma lista não deve ser redirecionada para um aplicativo público ou privado diferente.
- O seu aplicativo público listado não deve exigir o funcionamento de outro aplicativo público ou privado.
- Deve ser autenticado pelo fluxo de código de autorização OAuth
- Não é permitido solicitar aos usuários que copiem e colem códigos ou tokens OAuth. Os usuários somente devem ser solicitados a conceder acesso
- Os apps devem solicitar, gerenciar e atualizar tokens de acesso sem o envolvimento do usuário
- Use todos os escopos solicitados para instalação (ou seja, nos parâmetros
scopeeoptional_scopeobrigatórios).- Ter as configurações avançadas de escopo ativadas e selecionar todos os escopos obrigatórios, condicionalmente obrigatórios e opcionais que o aplicativo exige para instalação.
- Os escopos estranhos devem ser removidos.
- Se determinados escopos se aplicarem apenas a um subconjunto da base de usuários do aplicativo, eles deverão ser incluídos como escopos condicionalmente obrigatórios ou opcionais.
- Deve estar associado a um domínio verificado.
- Seus ativos públicos serão avaliados quanto às práticas recomendadas de segurança relacionadas a softwares desatualizados e a várias vulnerabilidades e descobertas de servidores da Web.
Exemplo de feedback
Confiabilidade e desempenho
O app:-
Deve estar em situação regular, ou seja:
- Em conformidade com todos os termos aplicáveis.
- Não ter a certificação rejeitada nos últimos seis meses.
- Não ter escalonamentos de suporte não resolvidos com clientes mútuos.
-
Deve usar versões estáveis e públicas das APIs e extensões da HubSpot.
- Recomenda-se o uso das versões públicas mais recentes.
- As APIs de visualização não documentadas, beta e de desenvolvedor são consideradas instáveis e não devem ser usadas no seu aplicativo de produção.
- Se o aplicativo usar APIs que não são estáveis ou públicas, informe isso durante a revisão da certificação ou à equipe do Gerente de parceiros de aplicativos para discutir as opções.
- Mantenha um volume razoável de atividades nas contas de clientes da HubSpot não afiliadas à sua organização.
-
O app deve seguir as diretrizes de uso da API e as práticas recomendadas, incluindo:
- Respeito aos limites de taxa (ou seja, 100 solicitações de entrada a cada 10 segundos por conta conectada da HubSpot).
- Atualização de tokens de acesso do OAuth antes da expiração.
- Armazenamento de dados em cache para chamadas repetidas quando possível.
- O uso de APIs em lote e assinaturas de webhook para reduzir o volume de solicitações quando possível.
- O uso de APIs para criar propriedades, fluxos de trabalho e ações de fluxo de trabalho personalizadas, em vez de exigir a ação do usuário.
-
Seu app deve manter uma taxa de sucesso média acima de 95% em todas as atividades
- As solicitações que resultam em respostas de erro são imputadas na taxa de sucesso.
- Alguns erros inevitáveis ou esperados podem ser excluídos ao calcular as taxas de sucesso em todas as atividades.
-
O aplicativo pode ter uma extensão de navegador para fornecer funcionalidades complementares e valor aos clientes:
- As extensões de navegador não devem ser criadas especificamente para a UI do HubSpot ou como uma solução alternativa para as APIs do HubSpot.
- As extensões de navegador não devem injetar capacidades ou componentes na UI do HubSpot.
- Extensões de UI oficialmente compatíveis (por exemplo, cartões CRM e ações de fluxo de trabalho personalizado) fornecem experiências de usuário mais consistentes para os clientes
- O aplicativo estará sujeito a uma avaliação de segurança adicional se incluir uma extensão de navegador.
Exemplos de feedback
Usabilidade e acessibilidade | Aplicativo
- Seu aplicativo deve estar listado no Marketplace de aplicativos da HubSpot por pelo menos seis meses.
- O aplicativo deve apresentar as práticas recomendadas de usabilidade.
- A instalação e o uso não devem causar confusão ou frustração para os clientes mútuos ou afetar negativamente a experiência do usuário do HubSpot.
Exemplo de feedback
Acessibilidade e usabilidade | Listagem do Marketplace de aplicativos
A listagem do marketplace de apps deve:- Descrever com precisão a funcionalidade atual do aplicativo.
- Se a funcionalidade mudar com base no produto ou no nível de assinatura do usuário, seja para a HubSpot ou para a sua solução, as diferenças devem ser esclarecidas.
- Conter informações claras e precisas sobre preços, incluindo um link para sua página de preços atual.
- Se vários pacotes oferecerem suporte ao seu aplicativo, a listagem do Marketplace de aplicativos deverá incluir, no mínimo, a opção menos custosa.
- Use dados de espaço reservado ou oculte dados para não exibir informações de identificação pessoal (PII).
- Incluir:
- Recursos visuais informativos e atualizados, que podem incluir capturas de tela ou um vídeo. Consulte a página Como fazer um ótimo vídeo de demonstração de aplicativo para obter as melhores práticas e exemplos de como criar um vídeo de demonstração.
- Um “URL de documentação de instalação” atualizado que leva diretamente a um guia de instalação completo para seu aplicativo. Você pode revisar os requisitos completos para a documentação de instalação. Este guia também inclui um modelo de exemplo que atende a todos os requisitos.
- Não inclui:
- Quaisquer dados ou estatísticas, a menos que um estudo de caso seja fornecido como um recurso.
Exemplos de feedback
Usabilidade e acessibilidade | Documentação de suporte
A documentação de suporte do app deve:- Estar em um URL ativo e acessível publicamente (ou seja, que não exija acesso pago ou login) e atenda a padrões atuais de acessibilidade, privacidade e GDPR.
- Esteja atualizado e seja consistente com a versão atual do aplicativo.
- Descrever claramente:
- A funcionalidade do seu aplicativo.
- Como instalar seu aplicativo e conectar uma conta da HubSpot com capturas de tela de cada etapa, incluindo a tela de aprovação do escopo.
- Como configurar o aplicativo depois que ele estiver instalado.
- Como usar o aplicativo, incluindo interações manuais e automatizadas.
- Como desconectar o HubSpot do aplicativo.
- Como desinstalar seu aplicativo de uma conta da HubSpot.
- Como a desconexão e a desinstalação podem afetar os dados e as contas da HubSpot dos usuários.
- Inclua imagens. Todas as imagens que contêm capturas de tela da UI da HubSpot devem estar atualizadas e ser consistentes com nosso sistema de design.
- Vídeos também são recomendados, mas não obrigatórios. Os vídeos devem ser atualizados regularmente e refletir a versão atual do aplicativo.
Exemplo de feedback
Valor
-
As análises ativas de contagem, retenção e Marketplace de aplicativos da HubSpot da instalação são avaliadas como indicadores do valor que os clientes mútuos encontram no seu aplicativo.
- O aplicativo deve ter, no mínimo, 60 instalações ativas e exclusivas para se qualificar e manter a certificação. As contas com instalações não devem ser afiliadas à sua organização. As contas de teste também serão excluídas.
- Se o aplicativo tiver menos de 60 instalações ativas, você deverá cancelar a solicitação de certificação.
- Se o aplicativo tiver menos do que as três instalações ativas necessárias para ser listado, ele poderá ser removido do Marketplace de aplicativos.
- O aplicativo deve ter, no mínimo, 60 instalações ativas e exclusivas para se qualificar e manter a certificação. As contas com instalações não devem ser afiliadas à sua organização. As contas de teste também serão excluídas.
- A lista de aplicativos deve ter respostas da sua equipe para quaisquer comentários negativos do aplicativo.
Exemplo de feedback
O processo de revisão de certificação e recertificação do app
A equipe de Qualidade do ecossistema da HubSpot responde às solicitações de certificação de aplicativos em até 10 dias úteis. Todo o processo de análise e feedback do aplicativo não deve demorar mais de 60 dias a partir do momento em que o feedback é compartilhado. Revise os critérios listados aqui para fornecer credenciais de teste ao aplicativo. Se o seu app atender a todos os requisitos, ele ganhará o status de certificado e um emblema “App certificado pela HubSpot” será exibido aos clientes e prospects no marketplace de apps. Seu app também aparecerá quando os usuários selecionarem o filtro “App certificado pela HubSpot”. Se a revisão do app não for concluída com sucesso, você poderá repetir a aplicação após seis meses. Depois de ser certificado por um ano, a equipe de Qualidade do ecossistema da HubSpot analisará seu aplicado para garantir ele ainda atende aos rigorosos requisitos de certificação. Se o aplicativo não atender mais a esses padrões, a equipe colaborará com você por até sessenta dias para resolver problemas.Perguntas frequentes
Há algum custo associado à certificação do aplicativo?
Há algum custo associado à certificação do aplicativo?
Serei notificado quando meu aplicativo se qualificar novamente para certificação se tiver sido rejeitado anteriormente?
Serei notificado quando meu aplicativo se qualificar novamente para certificação se tiver sido rejeitado anteriormente?
Como devo promover meu aplicativo certificado para meus clientes?
Como devo promover meu aplicativo certificado para meus clientes?
Gosto de experimentar as mais novas APIs em versão beta. A certificação do aplicativo é adequada para mim?
Gosto de experimentar as mais novas APIs em versão beta. A certificação do aplicativo é adequada para mim?
Gostaria que meu aplicativo aparecesse em destaque no Marketplace de aplicativos. É para isso que serve a certificação do aplicativo?
Gostaria que meu aplicativo aparecesse em destaque no Marketplace de aplicativos. É para isso que serve a certificação do aplicativo?
Por que e como meus ativos públicos serão avaliados em relação às práticas recomendadas de segurança?
Por que e como meus ativos públicos serão avaliados em relação às práticas recomendadas de segurança?
Meu aplicativo foi certificado há mais de um ano. O que devo fazer para manter meu status de certificação e o que significa ser recertificado?
Meu aplicativo foi certificado há mais de um ano. O que devo fazer para manter meu status de certificação e o que significa ser recertificado?