Obtendo certificação no Marketplace de aplicativos

A certificação do app envolve a equipe do Produto da HubSpot revisando e confirmando que o app 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 app também ganhará benefícios especiais e receberá feedback construtivo da equipe de Produtos da HubSpot durante a revisão da certificação do app.

Resumo dos requisitos de certificação do app:

Para mais detalhes, consulte os critérios de revisão abaixo.

O app:

  • Deve estar associado a um ID simples do app da HubSpot
  • 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 app devem seguir as práticas recomendadas de segurança

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

O app:

  • Não deve ser uma extensão do navegador
  • 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 tem 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.

  • Seu app deve estar listado no marketplace de app da HubSpot por, no mínimo, 6 meses
  • A lista do marketplace de apps deve descrever precisamente a funcionalidade atual do seu app
  • A lista do marketplace de apps deve conter informações de preços claras e precisas
  • A documentação de suporte do app deve ser clara, precisa e abrangente

Veja a lista detalhada de requisitos de usabilidade e acessibilidade.

  • O app deve ter, no mínimo, 6 instalações ativas exclusivas com atividade recente bem-sucedida

Veja a lista detalhada de requisitos de valor.

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

Instalações ativas são o número de contas de produção exclusivas do HubSpot que mostram atividades recentes bem-sucedidas.

Benefícios da certificação de ganhos

Além dos benefícios de anunciar seu app, os apps certificados:

  • Recebem um emblema "App certificado pela HubSpot", exibido em sua lista do marketplace de apps
  • Têm uma maior visibilidade no marketplace de app da HubSpot:
    • São incluídos no filtro de pesquisa "App certificado pela HubSpot"
    • São elegíveis para inclusão nas coleções com curadoria do marketplace de apps
  • Elegível para consideração prioritária para acessar novas APIs beta da HubSpot (privadas ou iniciais)

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 app da HubSpot
  • 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
  • Deve usar todos os escopos necessários para a instalação (ou seja, incluídos no parâmetro scope)
    • Os escopos estranhos devem ser removidos
    • Se determinados escopos se aplicarem apenas a um subconjunto da base de usuários do app, eles deverão ser incluídos como escopos 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:

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:
    • 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
    • APIs de visualização não documentadas, beta e do desenvolvedor são consideradas instáveis e não devem ser usadas em seu app de produção
  • Deve manter um volume razoável de atividade dos clientes
    • Se o seu app mostrar um volume de atividade baixo ou inexistente nos 30 dias anteriores à aplicação, ele será rejeitado
  • Uma maioria razoável da atividade do seu app deve vir de contas 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 no cache para chamadas repetidas quando possível
    • Use APIs em lote e assinaturas de webhook para reduzir o volume de solicitações quando possível
  • 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
  • O app não deve usar uma extensão de navegador ou meios semelhantes para inserir recursos ou componentes na UI da HubSpot

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 app
    • Se a funcionalidade mudar com base no produto ou no nível de assinatura do usuário, seja para a HubSpot ou 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 app, a listagem do marketplace de apps deve incluir, no mínimo, a opção menos cara
  • Incluir:
    • Recursos visuais informativos e atualizados, que podem incluir capturas de tela ou um vídeo
    • 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. 

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 ao público (ou seja, que não exija acesso pago ou login) e atenda a padrões atuais de acessibilidade, privacidade e GDPR
  • Estar atualizada e ser consistente com a versão atual do app
  • Descrever claramente:
    • A funcionalidade do app
    • Como instalar um app
    • Como configurar seu app depois que ele estiver instalado
    • Como usar o app, incluindo interações manuais e automatizadas
    • Como desinstalar o app, incluindo informações sobre como a desinstalação pode 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 app

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 de instalação, de retenção e do marketplace de app da HubSpot são avaliadas como indicadores do valor que os clientes mútuos encontram no seu app
    • O app deve ter, no mínimo, seis 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. Contas de teste também serão excluídas

Exemplo de feedback:

Your app has not maintained at least 6 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 produto da HubSpot responde às solicitações de certificação do app em até dez dias úteis. Todo o processo de revisão e feedback do app levará, no máximo, sessenta dias.

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 certificada por um ano, a equipe de produto da HubSpot analisará seu app para garantir que ele ainda atende aos rigorosos requisitos de certificação. Se o seu app não atender mais a esses padrões, a equipe colaborará com você por até sessenta dias para resolver problemas. Os apps devem passar por essas revisões anuais de recertificação para manter o status de certificado.

Se, a qualquer momento, o app deixar de atender aos requisitos de certificação listados acima, podemos iniciar imediatamente um processo de recertificação, mesmo se o app tiver sido certificado por menos de um ano. Conforme estabelecido no Contrato do Programa de Parceiros de Apps, também nos reservamos o direito de cancelar a publicação do seu app 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 Product 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.