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 — vazaram, 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 — 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.