Chave de API: conectar um sistema ao Hub
Crie uma chave com o acesso do tamanho certo, guarde o segredo, consulte a documentação de cada app e revogue quando a integração sair do ar.
Navegar pela Central de Ajuda
Primeiros passos
Produtividade e trabalho
- Tarefas: organize o trabalho do time
- Criar e acompanhar uma tarefa
- Formulários de entrada: capture respostas que viram ação
- Gravador de Voz: a reunião vira texto pesquisável
- Registrar e revisar horas de trabalho
- Chat: a conversa do time dentro do Hub
- Solicitações internas que viram tarefa
- Lógica condicional: um formulário, caminhos diferentes
- A tarefa que nasce dentro do app onde o trabalho está
- E-mail: a sua caixa dentro do Hub
- Conectar a caixa com o Google
- Conectar a caixa por servidor próprio
- Escrever, responder e encaminhar
- Criar um bot no Chat
CRM e Vendas
- CRM: organize o processo comercial
- Cadastros: contatos, empresas, produtos e serviços em um lugar só
- Configurar um funil de vendas
- Criar e acompanhar uma oportunidade
- Criar uma oportunidade a partir do WhatsApp
- Operar oportunidades com o Marvin
- Do formulário ao funil: o lead que cai direto no CRM
- Do lead novo à primeira abordagem, com skills
- Base de argumentos de venda no Brain, com o Marvin
- Gerenciador de Anúncios: suas campanhas em um lugar só
- Venda do CRM vira operação de Comex sem redigitar
Atendimento e CS
- WhatsApp: um número da empresa, o time inteiro atendendo
- Central de atendimento compartilhada no WhatsApp
- Pesquisa de satisfação com formulários de entrada
- Implantação: acompanhe cada cliente até a ativação
- Ligar a transcrição automática dos áudios do WhatsApp
- Listas e responsável: organizar a caixa compartilhada
Financeiro e operação
- Tesouraria: o dinheiro da empresa, do recebível ao pago
- PDV: a venda de balcão do caixa ao financeiro
- Reservas: do agendamento ao pagamento, sem sair do app
- Do balcão ao financeiro: a venda que já entra como recebível
- Resultados Econômico-Financeiros: o fluxo de caixa do gestor
- Do lançamento ao fechamento do mês, sem a planilha paralela
- Comex: da venda ao acompanhamento da operação
- Contas e saldo inicial: o ponto de partida do dinheiro
- Plano de contas e centro de custo: dar sentido aos números
- Títulos, parcelas e baixas: o dia a dia do contas a pagar e a receber
Pessoas e cultura
- Gente e Cultura: o time inteiro em um só lugar
- Academy: do curso ao certificado
- Departamento Pessoal: da admissão ao desligamento
- Onboarding de colaborador: começar bem no Hub
- PDI, 1:1 e feedback: o acompanhamento de cada pessoa
- Admissão e desligamento como processo, não como aviso
- Do eNPS ao plano de ação, sem quebrar o anonimato
- A saída de uma pessoa, sem ponta solta
- Recrutamento e Seleção: da necessidade à vaga publicada
- Abrir uma solicitação de vaga
- Aprovar ou reprovar uma solicitação de vaga
- Publicar a página de carreiras
- Transferir um colaborador entre empresas
- Configurar os funis do Departamento Pessoal
IA e dados
- Marvin: a IA que opera o Hub com você
- Skills: transforme o que se repete em um comando
- Brain: o conhecimento da empresa em um lugar só
- Dashboards: os números da empresa em painéis
- MDC: seus dados externos dentro do Hub
- MCP: o Hub nas mãos da sua IA
- A reunião que vira conhecimento
- Conectar o Fireflies ao Hub via MDC
- Conectar o Marvee Hub ao Claude
- Um resumo que chega sozinho toda semana
- Padronize uma resposta ou processo com uma skill
- Da reunião às ações: resumo no Brain e tarefas, com skills
- Dúvida de atendimento vira FAQ no Brain, com skills
- Venda ganha vira onboarding em tarefas, com skills
- A reunião atualiza a oportunidade no CRM, com skills
- Cofres do Brain: quem vê o quê
- Limitar o alcance de uma chave de API
Arquitetura e Gestão na Era da IA
Automações e integrações
- Automações: o que roda sozinho entre os apps
- Criar a sua primeira automação
- O que dá para automatizar hoje
- Condição, espera e caminhos diferentes no mesmo fluxo
- Acompanhar execuções e consertar uma automação
- Descobrir que uma automação falhou
- Automação que roda em horário, não em evento
- Disparar uma automação a partir de um sistema de fora
- Chamar um sistema externo no meio do fluxo
- Chave de API: conectar um sistema ao Hub
- O negócio ganho abre a implantação sozinho
- Parcela vencida vira cobrança com dono e prazo
- A admissão monta o kit de entrada da pessoa
- A mensagem nova já chega triada
- Reserva confirmada gera o contrato e avisa o cliente
- Estoque zerado avisa quem compra
- A conexão do WhatsApp caiu e o time soube na hora
- Chamado aberto vira tarefa do time responsável
Conta e administração
- Membros e permissões: quem entra e o que cada um acessa
- Planos, assinatura e créditos de IA
- Precisa de ajuda? Abra e acompanhe chamados sem sair do Hub
- Notificações: onde cada aviso chega
- Minhas Empresas: mais de um CNPJ na mesma organização
- Proteger a sua conta: passkey, app autenticador e sessões
- O que consome crédito de IA, e o que não consome
Quando um sistema da sua empresa precisa ler ou escrever no Hub sem uma pessoa na frente, ele não usa login: usa uma chave de API. A chave carrega um acesso que você define app por app, e pode ser revogada a qualquer momento sem mexer na conta de ninguém.
O que é e quando usar
| Use uma chave de API para | Use outra coisa para |
|---|---|
| Um sistema seu ler ou gravar dados no Hub | Uma pessoa acessar o Hub: isso é conta e senha |
| Uma integração rodar sem ninguém logado | Um assistente de IA operar o Hub por você: isso é a conexão MCP |
| Dar acesso limitado a um fornecedor de tecnologia | Automatizar entre apps do próprio Hub: isso são as Automações |
Onde fica. Em Configurações > Desenvolvedor > API, com duas abas: Chaves de API e Documentação. As conexões de assistente de IA ficam ao lado, em Configurações > Desenvolvedor > MCP.
Não confunda com a chave do MDC. A chave desta tela dá acesso aos apps do Hub. O Marvee Data Connection tem chaves próprias, que servem para consumir os endpoints publicados sobre os seus bancos e APIs, pelo gateway dele. São duas coisas separadas, com telas separadas: veja limitar o alcance de uma chave de API quando o assunto for endpoint de dados.
Acesso. O recurso está disponível a partir do plano Colaborador. Criar chave é uma ação sensível: o Hub pede uma confirmação a mais na hora.
Crie uma chave
- Abra Configurações > Desenvolvedor > API.
- Clique em Criar chave de API.
- Dê um Nome da chave que diga onde ela é usada, no estilo “Integração do ERP”. Quando existirem seis chaves, é esse nome que evita revogar a errada.
- Escolha o acesso. Você pode aplicar um nível geral ou ajustar app por app:
| Nível | O que a chave pode |
|---|---|
| Somente leitura | Consultar. Não escreve nada |
| Ler e escrever | Consultar e alterar, sem os acessos sensíveis |
| Personalizado | Você escolhe app por app, incluindo os acessos sensíveis |
- Confirme a criação e conclua a verificação que o Hub pedir.
- Copie o segredo agora. Ele aparece uma vez. Guarde no cofre de senhas da empresa, não em conversa nem em planilha.
Consulte a documentação de cada app
A aba Documentação lista os apps que aceitam chamada por chave, cada um com o endereço da própria documentação. Ela mostra apenas as operações que uma chave consegue alcançar, então o que aparece ali é o que dá para integrar de verdade.
A chamada é autenticada com a chave no cabeçalho de autorização, e o app precisa saber em qual organização trabalhar. Os campos exatos ficam na documentação de cada app, que é a fonte a seguir na hora de escrever a integração.
Administre o que existe
Na lista de chaves você acompanha nome, responsável e o acesso que cada uma carrega. Quem administra a organização enxerga as chaves de todo mundo e pode filtrar entre Todas e Minhas.
Duas ações importam:
- Revogar chave derruba o acesso na hora, mantendo o registro de que ela existiu.
- Excluir chave remove o registro.
Revogue sempre que a integração sair do ar, que o fornecedor mudar, ou na menor suspeita de que o segredo vazou. Não existe motivo para manter chave sem uso.
Como saber que deu certo
- A chave aparece na lista com o nome e o acesso que você escolheu.
- A primeira chamada do sistema externo responde com dado em vez de recusa.
- Depois de revogar, a mesma chamada passa a ser recusada.
Limites e erros comuns
| Expectativa | Realidade hoje |
|---|---|
| Dá para ver o segredo depois | Não. Ele aparece uma vez, na criação. Perdeu, crie outra |
| A chave alcança tudo o que eu alcanço | Não. Ela alcança o que foi liberado nela, e nem todo app aceita chamada por chave |
| Uma chave serve para conectar o Claude ou o ChatGPT | Para assistente de IA existe a conexão MCP, na aba ao lado |
| Renomear a chave troca o segredo | Não. O segredo continua o mesmo |
| A chave continua valendo se a pessoa sair da empresa | Trate cada chave como acesso da empresa e revise a lista quando alguém sair |
Erros comuns de quem começa: criar uma chave com acesso total porque é mais rápido, e nomear a chave de “teste”, o que garante que ninguém saiba se pode revogar.
Próximo passo
- MCP: o Hub nas mãos da sua IA: quando o de fora é um assistente, não um sistema.
- Chamar um sistema externo no meio do fluxo: o caminho contrário, do Hub para fora.
- Proteger a sua conta: a passkey que tira a dependência do código por e-mail.
Continue por aqui
Não resolveu?
Abra um chamado pelo botão de suporte dentro do Hub. Nosso time responde e, quando é problema de produto, ele vira uma correção rastreável.