> ## Documentation Index > Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Requisitos de certificação de aplicativos > Veja aqui o que os Parceiros de aplicativos devem fazer para que o aplicativo seja certificado no Marketplace de aplicativos da HubSpot. 'Marketplace de aplicativos | Requisitos para a listagem de aplicativos'; 'Veja aqui o que os Parceiros de aplicativos devem fazer para que o aplicativo seja certificado no Marketplace de aplicativos da HubSpot.'; 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](https://developers.hubspot.com/docs) atende aos requisitos abaixo para segurança, privacidade, confiabilidade, desempenho, usabilidade, acessibilidade e valor. Os apps certificados destacam-se no [marketplace do app](https://ecosystem.hubspot.com/marketplace/apps) com uma reputação de qualidade e confiabilidade. O aplicativo também ganhará [benefícios especiais](#certification-benefits) e receberá feedback construtivo da equipe de Qualidade do ecossistema da HubSpot durante a revisão da certificação do aplicativo. * 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](https://developers.hubspot.com/docs). * 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. * As certificações de aplicativos são válidas continuamente por dois anos e devem ser renovadas. Se a certificação não for renovada, seu status de certificado será removido. * Uma notificação será enviada 3 meses antes da data da renovação de certificação do seu aplicativo. * Se o seu aplicativo não atender mais aos padrões de certificação, a equipe de Qualidade do Ecossistema da hubspot colaborará com você por até 60 dias para resolver problemas. ## 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](#review-criteria). 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](/apps/legacy-apps/authentication/working-with-oauth) e todos os escopos necessários. * Deve estar associado a um [domínio verificado](/apps/legacy-apps/public-apps/overview). * Os ativos públicos associados ao seu aplicativo devem seguir as práticas recomendadas de segurança. Seu aplicativo não pode usar [cartões de CRM clássicos](/api-reference/crm-public-app-crm-cards-v3/guide), pois não são mais suportados desde 16 de junho de 2025. Saiba mais sobre este anúncio no [Registro de alterações do desenvolvedor HubSpot](https://community.hubspot.com/t5/Developer-Announcements/Deprecating-Support-for-Classic-Legacy-CRM-Cards/m-p/1153039#M1048). Consulte a [lista detalhada de requisitos de segurança e privacidade](#security-privacy). A atividade do aplicativo é definida por solicitações autenticadas por OAuth para [APIs](/api-reference/overview) da HubSpot e [solicitações assinadas](/apps/legacy-apps/authentication/validating-requests) de [assinaturas de webhook](/api-reference/webhooks-webhooks-v3/guide) e extensões da HubSpot (por exemplo, solicitações de busca de dados do [cartão de CRM](/api-reference/crm-public-app-crm-cards-v3/guide)). 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](https://www.hubspot.com/partners/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](/apps/legacy-apps/authentication/working-with-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](/apps/legacy-apps/authentication/working-with-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](/apps/legacy-apps/authentication/working-with-oauth) solicitados para instalação (ou seja, nos parâmetros `scope` e `optional_scope` obrigatórios). * Ter as [configurações avançadas de escopo](/apps/legacy-apps/public-apps/overview#configure-scopes) 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](/apps/legacy-apps/public-apps/overview). * 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 Seu aplicativo atualmente requer quatro escopos: `contacts`, `timeline`, `forms` e `content`. No entanto, de acordo com nossos registros, ele somente fez solicitações para as APIs de contatos do CRM e eventos da linha do tempo nos últimos 30 dias. Uma vez que os escopos `forms` e `content` não são necessários para nenhuma dessas funções, remova-os conforme necessário das configurações do aplicativo para minimizar as permissões que os usuários devem aceitar. ### 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](#activity) nas contas de clientes da HubSpot não afiliadas à sua organização. * O app deve seguir as [diretrizes de uso da API](https://developers.hubspot.com/docs) 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](#activity) * 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](https://developers.hubspot.com/docs#activity). * 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](/api-reference/crm-public-app-crm-cards-v3/guide) e [ações de fluxo de trabalho personalizado](/api-reference/automation-actions-v4-v4/guide)) 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 A taxa de sucesso da API do seu aplicativo cai abaixo do limite de 95% exigido para certificação. Nossos registros mostram uma taxa de sucesso de 83% nos últimos 30 dias. A grande maioria destes pedidos retornaram erros `429` de limite de taxa de burst. Para reduzir essa taxa de erro, recomendamos que as solicitações de limitação sejam iguais a 100 por 10 segundos para cada conta. O aplicativo gera erros durante a tentativa de atualização de contatos usando um endereço de e-mail `undefined`, o que não funcionará com este ponto de extremidade. Seu aplicativo deve ignorar essas solicitações se um registro não tiver um endereço de e-mail. Seu aplicativo está fazendo solicitações usando tokens OAuth expirados e está recebendo erros `401` antes de atualizar o token. Para minimizar esses erros, recomendamos que seu aplicativo controle quando os tokens expiram ou atualize os tokens antes de fazer solicitações. Se forem exibidos erros `401` para todas as solicitações e você não conseguir atualizar o token de acesso, considere o aplicativo como desinstalado e pare de fazer solicitações para a conta até que um usuário autentique novamente o aplicativo. O aplicativo gera erros `403` quando se tenta usar a API das Listas de contatos com contas gratuitas do Marketing Hub, que não têm acesso às listas de contatos. Se o seu aplicativo continuar recebendo erros `403` por falta de escopos adequados, ele deve parar de fazer chamadas para recuperar listas dessa conta. As assinaturas de webhook do seu aplicativo frequentemente falham com os erros `500` e `503`. Certifique-se de que o servidor possa lidar com o volume de solicitações (atualmente limitado a 150 por segundo) para que os dados do cliente não sejam perdidos. O aplicativo está extraindo muitos contatos, um de cada vez, em vez de extraí-los em lotes. Recomendamos o uso de [pontos de extremidade em lote](/api-reference/crm-contacts-v3/guide). ### Usabilidade e acessibilidade | Aplicativo * Seu aplicativo deve estar [listado](https://developers.hubspot.com/docs) no [Marketplace de aplicativos](https://ecosystem.hubspot.com/marketplace/apps) da HubSpot por pelo menos seis meses. * O aplicativo deve apresentar as [práticas recomendadas de usabilidade](https://www.nngroup.com/articles/ten-usability-heuristics/). * 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 Seu aplicativo atualmente requer que os usuários configurem manualmente as ações de webhook do fluxo de trabalho para enviar mensagens de texto. Considere criar ações de fluxo de trabalho personalizadas por meio do aplicativo que sejam flexíveis o suficiente para acomodar muitos casos de uso. ### 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](https://www.hubspot.com/partners/apps/resources/how-to-make-a-great-app-demo-video) 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](https://developers.hubspot.com/docs). 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 Sua listagem no Marketplace de aplicativos inclui alguns detalhes específicos sobre a funcionalidade do seu aplicativo. Melhore a listagem com capturas de tela que descrevem a funcionalidade do aplicativo e inclua descrições mais detalhadas sobre casos de uso comuns e comportamento no aplicativo. Quando compram nossos produtos e serviços, os clientes do HubSpot estão acostumados com uma experiência “experimente antes de comprar”. Por esse motivo, recomendamos que seu aplicativo forneça uma experiência de avaliação gratuita ou assinatura freemium. Alguns parceiros de aplicativos que não possuem páginas de preços nem avaliações gratuitas criaram “planos da HubSpot”, oferecendo aos clientes uma política de preços transparente, inscrições sem intervenção e outros benefícios. ### 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](https://canvas.hubspot.com/). * 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 O guia de configuração do seu aplicativo inclui uma captura de tela que descreve os escopos necessários para a instalação do aplicativo. Esta captura de tela não mostra o escopo `business-intelligence`, que é selecionado nas configurações do seu aplicativo. Atualize a captura de tela para que ela reflita os escopos obrigatórios atuais. ### 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](#activity) 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 Seu aplicativo não manteve pelo menos 60 instalações ativas nos últimos seis meses. Portanto, seu status de certificado será removido. Você pode se inscrever novamente na certificação em seis meses. ## 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](https://developers.hubspot.com/docs) 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](https://developers.hubspot.com/docs) 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. 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](https://legal.hubspot.com/app-program-agreement), a HubSpot também se reserva o direito de cancelar a publicação do seu aplicativo a qualquer momento. ## Perguntas frequentes Não, não cobramos uma taxa para listar ou certificar seus aplicativos no Marketplace de aplicativos, nem uma taxa para instalações geradas através do Marketplace de aplicativos. Não há compartilhamento de receita. Estamos aqui para ajudá-lo a otimizar o seu aplicativo. Não. No momento, não temos notificações habilitadas para notificá-lo se e quando você poderá se inscrever novamente. Seu [Gerente de parceiros de aplicativos](#app-partner-manager) seria o melhor recurso para entrar em contato e perguntar se você está qualificado antes de se inscrever. Sinta-se à vontade para usar o modelo de comunicado à imprensa disponível [nesta página](https://www.hubspot.com/partners/app/resources) para compartilhar a notícia de que seu aplicativo foi certificado. Se você planeja publicar nas mídias sociais, certifique-se de marcar a HubSpot — adoramos comemorar com nossos parceiros de aplicativos! Recomendamos que você entre em contato com o [Gerente de parceiros de aplicativos](#app-partner-manager) para ver se a certificação é adequada para o seu aplicativo. Nosso objetivo é garantir que seu aplicativo seja bem desenvolvido para nossos clientes em comum e limite mudanças disruptivas, o que exige que seu aplicativo utilize as APIs estáveis mais recentes. Também adoramos ver e apoiar empreendedores, pioneiros na adoção e desenvolvedores interessados em testar as APIs beta mais recentes. Os benefícios de aparecer em destaque nas coleções e de permitir que os clientes filtrem facilmente por um aplicativo certificado no Marketplace de aplicativos estão em constante evolução. Gostaríamos de saber qual seria a melhor forma de destacar seu aplicativo (como no Marketplace de aplicativos, na comunidade HubSpot, em boletins de notícias curadas pela HubSpot, ou de outra forma). Seu [Gerente de parceiros de aplicativos](#app-partner-manager) seria o melhor contato para discutir possíveis benefícios futuros e iniciar esta conversa. Com o cliente médio usando mais de cinco integrações, os aplicativos essenciais são monitorados e mantidos de acordo com os padrões de privacidade, segurança e qualidade ao longo do tempo. Os ativos públicos serão avaliados utilizando informações já fornecidas durante um processo de listagem e as conclusões serão analisadas utilizando um método não invasivo. A equipe de Qualidade do Ecossistema da HubSpot entrará em contato se seu aplicativo não estiver em conformidade ou para a recertificação anual prevista para fornecer as próximas etapas. Incentivamos você a monitorar o desempenho do seu aplicativo, os requisitos de certificação, o [Registro de alterações do desenvolvedor](https://developers.hubspot.com/changelog) e quaisquer recursos adicionais da HubSpot relacionados a mudanças na tecnologia usada e como seu aplicativo pode permanecer atualizado. 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**. *** ## Recursos relacionados [Como solicitar a certificação do app](https://developers.hubspot.com/docs) [Como listar seu app](/apps/developer-platform/list-apps/listing-your-app/listing-your-app) [Requisitos de uma listagem de aplicativo](https://developers.hubspot.com/docs) [Fórum da comunidade para desenvolvedores](https://community.hubspot.com/t5/APIs-Integrations/bd-p/integrations) [Entre em contato com a equipe de Parceiros do aplicativo](https://www.hubspot.com/partners/app/join)