Instalação

Instalar um app

Apps do marketplace conectam o MIX a serviços de terceiros (Slack, Calendly, Clicksign, etc.). A instalação é feita pelo app web: você não precisa mexer em código.

Quem pode instalar

Apenas usuários com role admin no workspace podem instalar apps. Membros sem essa permissão veem o catálogo mas não conseguem ativar.

Apps com OAuth 2.0

A maioria dos apps usa OAuth: você é redirecionado pro provider, autoriza, volta pro MIX com a integração ativa.

No app, vá em Marketplace (ícone na sidebar).
Clique no app desejado. Verá os scopes solicitados: quais permissões o MIX precisa no seu account do provider.
Clique em Conectar. Você é redirecionado pro provider (ex.: slack.com/oauth/v2/authorize?...).
Autorize no provider. Você volta pra app.usemix.app com a integração ativa.
Configure os detalhes (qual canal, qual board, etc.) e ative as actions/triggers que importam.

Em provider, autorize com a conta certa

Se você está logado no Slack com sua conta pessoal mas o workspace do MIX pertence à empresa, lembre-se de autorizar no Slack da empresa. Trocar depois exige desconectar e reconectar.

Apps com API key

Alguns providers (Clicksign, D4Sign) não oferecem OAuth: você gera uma API key na conta deles e cola no MIX.

No provider, vá em Configurações → API tokens (cada um chama de um nome diferente). Crie um token com permissões para enviar/ler documentos.
Copie a key.
No MIX, vá em Marketplace → [App] → Conectar. Cole a key no campo solicitado.
Salve. O MIX testa a key fazendo uma chamada autenticada. Se inválida, você recebe erro inline.

Não compartilhe a API key

API keys têm permissões totais na sua conta do provider. Se vazarem, vão precisar ser rotacionadas no provider e atualizadas em todas as ferramentas que usam.

Renovação de credenciais

Apps OAuth com refresh tokens (Google, Microsoft, Slack v2) renovam automaticamente. Apps OAuth sem refresh (alguns providers menores) podem expirar. Você é avisado por e-mail e precisa reconectar.

Apps com API key não expiram (a menos que o provider rotacione). Se sua key parar de funcionar, gere uma nova no provider e atualize no MIX.

Desinstalar

Em Marketplace → Apps instalados → [App] → Desconectar. Credenciais são apagadas no MIX. No provider, revogue o app adicionalmente em "apps autorizados" pra defesa em profundidade, porque desinstalar do MIX não revoga automaticamente lá.

Permissões e auditoria

Cada app instalado aparece no audit log com timestamp de instalação, quem instalou, e cada action executada por ele. Útil pra investigar comportamento inesperado.