Neste artigo, você vai aprender:
Quem pode gerar a chave
Como fazer o processo passo a passo
O que observar para garantir segurança
Onde consultar a documentação oficial
🧑💼 Quem pode gerar a chave de API?
Apenas gestores de workspace (administradores da conta MeetRox) têm permissão para gerar novas chaves de API.
🚀 Passo a passo: como gerar a chave de API
Acesse sua conta na MeetRox.
No menu lateral, vá até:
Configurações > Configurações > API.Clique no botão “Criar Chave de API”.
Dê um nome para a chave (ex: integração_HubSpot ou CRM_TimeComercial).
Clique em Criar.
A chave será gerada e mostrada em uma janela (modal).
Copie imediatamente, pois ela não poderá ser visualizada novamente por segurança.
⚠️ Importante: A chave não pode ser recuperada depois que a janela for fechada. Caso isso aconteça, será necessário gerar uma nova.
🛡️ Segurança: boas práticas
Armazene a chave em um local seguro (como um gerenciador de senhas ou ambiente de back-end).
Nunca envie a chave por e-mail ou em ferramentas públicas.
Se a chave for comprometida, use a opção “Revogar chave” imediatamente.
📊 Acompanhamento e Logs
Na tela de API, você pode:
Editar o nome da chave
Visualizar quem a criou
Ver a data da última utilização
Acessar o histórico de uso (data, hora, tipo de chamada e status)
Exemplo: se um sistema usou a chave para consultar as reuniões (GET /calls), esse acesso aparece no log com status 200 (sucesso) ou 500 (erro).
🧯 Como revogar uma chave
Se uma chave não for mais usada ou estiver comprometida:
Clique no botão “Revogar” ao lado da chave.
A data de revogação será registrada automaticamente.
Essa chave deixará de funcionar instantaneamente.
📚 Documentação oficial da API
Após a geração da chave, basta integrá-la seguindo a documentação oficial da MeetRox:
Essa documentação contém:
Como autenticar usando a chave
Lista completa de funcionalidades disponíveis
Exemplos de requisição e resposta
Recomendações para integração com CRM, BI e mais
✅ Conclusão
Esse processo foi desenvolvido para ser rápido, seguro e transparente, permitindo que a própria empresa cliente tenha controle total sobre suas integrações.
Se tiver dúvidas ou quiser apoio para fazer a integração, entre em contato com o seu CSM da MeetRox ou com o nosso suporte via Intercom.
Perguntas frequentes
A API pública da MeetRox informa o grupo primário do usuário?
Sim. A API pública informa o grupo primário de cada usuário na lista de usuários e do dono da conversa, tanto no detalhe de uma conversa quanto na lista de conversas. O formato é o mesmo já enviado pelo webhook de conversa processada, então você pode consultar o grupo primário a qualquer momento pela API, sem depender de ter guardado o webhook. Os detalhes de cada campo estão na documentação oficial da API.
Fechei a janela e não copiei a chave de API. Consigo recuperar?
Não. Por segurança, a chave de API só é exibida uma vez, no momento da criação. Gere uma nova chave em Configurações > Configurações > API e revogue a anterior, se ela não for mais usada.
Ficou com alguma dúvida? Fale com a gente clicando em Suporte, no menu lateral da MeetRox.