Obtendo certificação no Marketplace de aplicativos

A certificação do aplicativo envolve a análise e confirmação pela equipe de Qualidade do ecossistema da HubSpot de que o aplicativo listado atende aos requisitos abaixo para segurança, privacidade, confiabilidade, desempenho, usabilidade, acessibilidade e valor.

Os apps certificados destacam-se no marketplace do app com uma reputação de qualidade e confiabilidade. O aplicativo também ganhará benefícios especiais e receberá feedback construtivo da equipe de Qualidade do ecossistema da HubSpot durante a revisão da certificação do aplicativo.

Observação:  

  • Esses requisitos estão sujeitos a alterações, pois a HubSpot está continuamente fazendo melhorias no Marketplace de aplicativos da HubSpot e no Ecossistema. A HubSpot pode rejeitar uma solicitação de certificação de aplicativo, a seu critério, se ele não atender aos padrões definidos.
  • A HubSpot não analisará seu aplicativo, a menos que você envie um vídeo de demonstração conforme as instruções ao solicitar a certificação do aplicativo.
  • Somente é possível enviar um aplicativo por vez para certificação. Se você enviar mais do que um aplicativo para certificação ao mesmo tempo, eles serão rejeitados com base na ordem de envio. 

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.

Consulte a lista detalhada de requisitos de segurança e privacidade.

O app:

  • Deve estar em situação regular:
    • Deve estar em conformidade com todos os termos aplicáveis.
    • Não deve ter rejeições de certificação recentes.
    • Não deve ter escalonamentos de suporte não resolvidos.
  • Deve usar versões estáveis e públicas das APIs e extensões da HubSpot.
  • Deve manter um volume razoável de atividade dos clientes.
  • Deve estar de acordo com as diretrizes de uso da API
  • Deve manter uma taxa média de sucesso acima de 95% em todas as atividades.

Consulte a lista detalhada de requisitos de confiabilidade e desempenho.

  • O aplicativo deve estar listado no Marketplace de aplicativos da HubSpot por, no mínimo, 6 meses.
  • A listagem do Marketplace de aplicativos deve descrever com precisão a funcionalidade atual do seu aplicativo.
  • A listagem do Marketplace de aplicativos deve conter informações de preços claras e precisas.
  • A documentação de suporte do aplicativo deve ser clara, precisa e abrangente.

Veja a lista detalhada de requisitos de usabilidade e acessibilidade.

  • O aplicativo deve ter, no mínimo, 60 instalações ativas e exclusivas com atividade recente bem-sucedida.

Veja a lista detalhada de requisitos de valor.

A atividade do aplicativo é definida por solicitações autenticadas por OAuth para APIs da HubSpot e solicitações assinadas de assinaturas de webhook e extensões da HubSpot (por exemplo, solicitações de busca de dados do cartão de CRM).

As instalações ativas são o número de contas de produção exclusivas da HubSpot, não afiliadas à sua organização, que mostram a atividade do aplicativo bem-sucedida nos últimos 30 dias.

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 scope e optional_scope obrigató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. 
  • Esteja 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

Your app currently requires four scopes: contacts, timeline, forms, and content. According to our logs, however, it only made requests to the CRM Contacts and Timeline Events APIs in the last 30 days. Since the forms and content scopes are not required for either of these functions, please remove them as required from the app’s settings to minimize the permissions users must accept.

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.
    • Observaçã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.
    • O aplicativo estará sujeito a uma avaliação de segurança adicional se incluir uma extensão de navegador. 

Exemplos de feedback

Your app’s API success rate falls below the 95% threshold required for certification. Our logs show a 83% success rate in the last 30 days. The vast majority of these requests returned 429 burst rate limit errors. To reduce this error rate, we recommend throttling requests to 100 requests per 10 seconds for each account.

Your app is generating errors around trying to update contacts using an undefined email address, which will not work with this endpoint. Your app should skip these requests if a record does not have an email address.

Your app is making requests with expired OAuth tokens and receiving 401 errors before refreshing the token. To minimize these errors, we recommend that your app keep track of when tokens expire or refresh tokens before making requests. If you start seeing 401 errors for 100% of requests and are unable to refresh the access token, consider the app uninstalled and stop making requests for the account until a user re-authenticates your app.

Your app is generating 403 errors from trying to use the Contact Lists API with Marketing Hub Free accounts, which do not have access to contact lists. If your app repeatedly gets 403 errors for missing the proper scopes, it should stop making calls to retrieve lists from that account.

Your app’s webhook subscriptions frequently fail with 500 and 503 errors. Make sure that your server can handle the volume of requests (currently limited to 150 per second) so that customer data is not lost.

Your app is pulling many contacts one at a time instead of pulling them in batches. We recommend using batch endpoints instead.

Usabilidade e acessibilidade | App

Exemplo de feedback

Your app currently requires users to manually configure workflow webhook actions to send text messages. Consider creating custom workflow actions via the app which are flexible enough to accommodate many use cases.

Acessibilidade e usabilidade | Listagem do marketplace de apps

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 configuração" atualizado que contém um subdomínio e leva diretamente à página que hospeda a documentação do app. Esse link não deve levar à sua página inicial. 
  • Não inclui:
    • Quaisquer dados ou estatísticas, a menos que um estudo de caso seja fornecido como um recurso.

Exemplos de feedback

Your App Marketplace listing includes few specific details about your app’s functionality. Please enhance the listing with screenshots which depict app functionality and include more thorough descriptions of common use cases and in-app behavior.

HubSpot customers are used to a “try before you buy” experience when purchasing our products and services. For this reason, we recommend your app provide a free trial or freemium sign-up experience. Some app partners who do not have pricing pages or free trials have created “HubSpot plans,” offering mutual customers transparent pricing, touchless sign-up, and other benefits.

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.
  • Incluir 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

The setup guide for your app includes a screenshot depicting the scopes your app requires for installation. This screenshot does not show the business-intelligence scope, which is selected in your app’s settings. Please update the screenshot so that it reflects the current required scopes.

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.
  • A lista de aplicativos deve ter respostas da sua equipe para quaisquer comentários negativos do aplicativo.

Exemplo de feedback

Your app has not maintained at least 60 active installs over the trailing six month period. As such, its certified status will be removed. You may re-apply for certification in six months.

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. 

Observação: se, a qualquer momento, seu aplicativo deixar de atender aos requisitos de certificação listados acima, a HubSpot pode iniciar imediatamente um processo de recertificação, mesmo se o aplicativo tiver sido certificado por menos de um ano. Conforme estabelecido no Acordo do Programa de Parceiros de Aplicativos, a HubSpot também se reserva o direito de cancelar a publicação do seu aplicativo a qualquer momento.

Perguntas frequentes

No, we do not charge you a fee to list or certify your apps in the App Marketplace, nor a fee for installs generated through the App Marketplace. There is no revenue sharing. We are here to support you to make your app of higher quality.

No. At this time we do not have notifications enabled to notify you if and when you will be eligible to re-apply at this time. Your App Partner Manager would be the best resource to contact and ask if you are eligible before applying.

Feel free to use the press release template on this page to share the news that your app has earned certification.

If you plan to post on social media, be sure to tag HubSpot — we love to celebrate alongside our app partners!

We recommend you reach out to your App Partner Manager to see if app certification is right for your app.

Our goal is to ensure your app is well built for our mutual customers and limits breaking changes, which requires your app uses the latest stable APIs. We also love seeing and supporting entrepreneurs, early adopters, and developers who are eager to experiment with the newest beta APIs. 

The benefits of being featured in collections and for customers to easily filter for a certified app within the App Marketplace are continuing to evolve. We’d like to learn more about how you would find being featured the most helpful (e.g. App Marketplace, HubSpot community, HubSpot curated newsletters or other forms).

Your App Partner Manager would be the best contact to discuss potential future benefits and start this conversation.

With the average customer using more than five integrations, it’s imperative apps are monitored and held to privacy, security, and quality standards over time. Any public assets will be assessed using information already provided during a listing process and findings will be analyzed using a non-invasive method.

The HubSpot Ecosystem Quality team will reach out if your app is out of compliance or due for annual recertification with next steps.

We encourage you to monitor your app’s performance, certification requirements, Developer Changelog, and any additional HubSpot resources related to any changes in technology used and how your app could stay up to date.

Encontre o seu Gerente de parceiros de apps e as respetivas informações de e-mail fazendo login na sua conta de desenvolvedor e navegando até Marketplace de apps > Listagens. Passe o cursor do mouse sobre o app, clique em Mais > Visualizar detalhes da listagem.


Este artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot..