> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criando e integrando aplicativos

> Este guia é para desenvolvedores que desejam criar integrações de seus aplicativos ou soluções personalizadas dentro do ecossistema da Yampi.

<Info>
  Este conteúdo é direcionado a desenvolvedores parceiros que desejam criar integrações personalizadas dentro da Yampi.
</Info>

## Etapa 1: Configurar o aplicativo

Nessa etapa, configuramos o aplicativo e configuramos a URL de redirecionamento, que é essencial para o processo de autenticação OAuth 2.0.
[Clique aqui para mais detalhes sobre o OAuth 2.0](https://docs.yampi.com.br/api-reference/oauth)

<Accordion title="Configurar o aplicativo">
  <img src="https://mintcdn.com/yampi/aVuas9YGYMYd9zGw/images/apps/gerenciar-informacoes-do-aplicativo/permissoes.png?fit=max&auto=format&n=aVuas9YGYMYd9zGw&q=85&s=cd7857f137fd2814d7aac241e8d4f0a9" alt="" width="1281" height="818" data-path="images/apps/gerenciar-informacoes-do-aplicativo/permissoes.png" />

  <Steps>
    <Step title="Selecione: Configurar o aplicativo">
      Na página do app, selecione **Configurar o aplicativo** e preencha:

      * **URL de redirecionamento**: é o endereço para onde o usuário volta depois de autorizar seu app, já trazendo um código temporário usado para gerar o token de acesso. Em desenvolvimento, você pode usar `localhost`; para publicação, a URL precisa obrigatoriamente usar **HTTPS**.
      * **Permissões necessárias**: selecione apenas os escopos que seu app realmente precisa. Para mais detalhes consulte a página de [Permissões de um aplicativo](/apps/criacao-e-configuracao/permissoes-de-um-aplicativo).
    </Step>

    <Step title="Salvar as configurações">
      Clique em **Salvar**. O *Client ID* será gerado após esta ação.

      <Check>
        Importante: O Client ID só será disponível após salvar a URL de redirecionamento.
      </Check>
    </Step>
  </Steps>
</Accordion>

***

## Etapa 2: Gerenciar as informações

Agora, você define como o aplicativo aparecerá na Loja Yampi e quais informações serão exibidas para os lojistas.

<Accordion title="Gerenciar informações do aplicativo">
  <img src="https://mintcdn.com/yampi/aVuas9YGYMYd9zGw/images/apps/gerenciar-informacoes-do-aplicativo/informacoes-app.png?fit=max&auto=format&n=aVuas9YGYMYd9zGw&q=85&s=826c067a7965823c759f26b6b576870d" alt="" width="1282" height="853" data-path="images/apps/gerenciar-informacoes-do-aplicativo/informacoes-app.png" />

  <Steps>
    <Step title="Clique em: Gerenciar informações do aplicativo">
      Preencha os seguintes campos:

      * **Nome do aplicativo**: como aparecerá na Loja Yampi.
      * **Categoria**: escolha a mais adequada; se faltar, entre em contato com `partners@yampi.com.br`.
      * **Site do app** *(opcional)*: URL oficial.
      * **Resumo**: breve descrição (máx. 62 caracteres).
      * **Descrição**: recursos e diferenciais.
      * **Link de gerenciamento** *(opcional)*: URL onde o lojista faz ajustes ao app.
      * **URL do artigo tutorial** e **URL do vídeo tutorial**.
      * **Logotipo**: PNG ou JPEG, 512×512 px, até 2 MB.
      * **Funções do app**: destaque as ações que o lojista poderá realizar.
    </Step>

    <Step title="Salvar as informações">
      Clique em **Salvar** para registrar os dados.
    </Step>
  </Steps>

  ***

  Após salvar, o app assume o status **“Em desenvolvimento"**, onde você poderá testá-lo para validar todas as funcionalidades antes de submeter para a análise.
</Accordion>

***

## Etapa 3: Testar o aplicativo

Nesse passo, você testa o aplicativo em uma loja de testes para garantir que tudo funcione corretamente antes de enviá-lo para análise.
[Clique aqui para você encontrar mais dicas para os testes e validações necessárias.](/apps/testes-e-validacao/submissao-de-aplicativos-para-homologacao)

<Accordion title="Testar o aplicativo">
  * Caso ainda não tenha, clique em **Criar loja teste**.
  * Você será levado à tela de instalação OAuth: clique em **Instalar**.

      <img src="https://mintcdn.com/yampi/aVuas9YGYMYd9zGw/images/apps/como-testar-um-aplicativo/tela-oauth2.png?fit=max&auto=format&n=aVuas9YGYMYd9zGw&q=85&s=e59ce3cffadaf2cd641b5d624dd8e82c" alt="" width="671" height="819" data-path="images/apps/como-testar-um-aplicativo/tela-oauth2.png" />

  <Warning>
    Atenção: configure a URL de redirecionamento antes de testar o app.
  </Warning>

  O app será **instalado na sua loja teste e ficará disponível no topo do catálogo.**

  <Info>
    Veja aqui as [regras da loja teste](/apps/testes-e-validacao/como-testar-um-aplicativo#passo-a-passo-para-testar-seu-aplicativo).
  </Info>
</Accordion>

***

## Etapa 4: Enviar para análise

Nessa etapa é feita a homologação do App/Integração pelo time responsável, para garantir que o aplicativo atenda aos padrões de qualidade e segurança. Toda a tratativa dessa homologação e eventuais feedbacks são feitos diretamente pelo painel do parceiro tech.

<Accordion title="Envio para análise">
  * Complete as etapas de criação e com as informações já preenchidas.
  * Clique em **Enviar para análise** na página de status do app.
  * Preencha todos os campos exigidos.

  <Tip>
    Para um maior sucesso na análise do seu app, é importante que você siga essas dicas:
  </Tip>

  1. Forneça uma **documentação clara e completa sobre o funcionamento do app.**
  2. Inclua links para **vídeos ou artigos** que expliquem como instalar e usar o app.
  3. Descreva detalhadamente as **[permissões do app](/apps/criaca-e-configuracao/permissoes-de-um-aplicativo) e por que são necessárias.**
</Accordion>

***

## Etapa 5: Publicar na Yampi

Esse é o último passo, onde o aplicativo é submetido para publicação na Appstore após aprovação do time.

<Accordion title="Publicação">
  Após aprovação, o seu app fica disponível para a publicação na Appstore. A visibilidade pode levar alguns minutos!

  <img src="https://mintcdn.com/yampi/aVuas9YGYMYd9zGw/images/apps/publicacao-na-loja-de-aplicativos/publicar-app.gif?s=974421da0519977e147e43503b0c1e59" alt="" width="1656" height="781" data-path="images/apps/publicacao-na-loja-de-aplicativos/publicar-app.gif" />
</Accordion>

***

<Check>
  Certifique-se de que todas as etapas estejam completas antes de enviar para análise. Qualquer dúvida, contate nossa equipe no Discord ou via `integre@yampi.com.br`.
</Check>