Aplicativos no painel
Aplicativos (Dashboard Apps) são widgets de terceiros embutidos dentro do painel — abrem como uma aba lateral em conversas.
Onde fica
Configurações → Aplicativos.
Diferença pra "Integrações"
| Aplicativo | Integração | |
|---|---|---|
| Onde aparece | Sidebar do atendente, na conversa | Configuração nível conta |
| Quem usa | Atendente em tempo real | Sistema (sync, OAuth) |
| Exemplo | "Ver pedido no ERP" embutido | "Mandar pra Slack" |
Instalar
- URL do app (precisa ser HTTPS)
- Nome que aparece na aba
- Icone (opcional)
- Permissões — quais dados da conversa o app pode ler
API JS exposta ao app
O app embedado recebe o contexto da conversa via window.cosmoContext:
js
{
conversation: { id, inbox_id, ... },
contact: { id, name, ... },
account: { id, name }
}E pode escutar mudanças com cosmoContext.on('change', cb).
Casos de uso
- CRM embedado — mostrar pipeline do cliente
- ERP — pedidos, faturas, estoque
- Help center interno — busca rápida em base de conhecimento
Permissões granulares
read:conversation— ler conversaread:contact— ler contatowrite:notes— postar notas internas
Você revisa essas permissões ao instalar.