Rocket.chat - Superadmin
Esta documentação detalha o processo para integrar um servidor Rocket.Chat ao Z-PRO, permitindo que os agentes acessem o chat interno do Rocket.Chat diretamente pelo painel, sem precisar alternar entre plataformas.
Configuração global vs. por tenant: os apps cadastrados aqui ficam disponíveis para todos os tenants. A conexão e o gerenciamento do número WABA de cada tenant é feito individualmente pelo Administrador em Configurações → Integrações
Pré-requisitos:
Um servidor Rocket.Chat instalado e acessível via URL pública.
Acesso de administrador no servidor Rocket.Chat.
Acesso de Super Admin na sua instalação do Z-PRO.
Página de referência da tela do admin: Apps — Rocket.Chat
Como funciona a integração
Após a configuração, os agentes passam a acessar o Rocket.Chat embutido diretamente no Z-PRO via Comunicação e Marketing → Redes Sociais → Rocket.Chat, sem precisar abrir outra aba ou sistema.
Diferente das integrações de marketplace (Mercado Livre, OLX), o Rocket.Chat não cria tickets no painel de atendimento. O acesso é direto ao chat interno do servidor RC.
Etapa 1: Criar o Bot User no Rocket.Chat
No painel de administração do seu servidor Rocket.Chat:
Acesse Administração → Usuários → Novo Usuário.
Crie um usuário dedicado para a integração com as seguintes roles (funções):
botlivechat-agent
Anote o Username e o User ID deste usuário.
Use um usuário exclusivo para a integração — evita conflitos e facilita o monitoramento da conta no RC.
Etapa 2: Gerar o Personal Access Token
Ainda no servidor Rocket.Chat, gere o token que o Z-PRO usará para autenticar:
Faça login com o usuário admin (ou com o bot user criado na Etapa 1).
Clique no avatar do usuário → Perfil → Tokens de Acesso Pessoal.
Clique em Adicionar e dê um nome ao token (ex: "Z-PRO Integration").
Copie e guarde o User ID e o Token gerados — eles não serão exibidos novamente.
Etapa 3: Habilitar Iframe Integration no Rocket.Chat
Para que o Rocket.Chat seja embutido corretamente no Z-PRO:
No painel de administração do RC, acesse Administração → Geral.
Localize a seção Iframe Integration.
Ative a opção Enable Send e/ou Enable Receive conforme necessário.
Salve as configurações.
Sem esta configuração habilitada no servidor Rocket.Chat, o iframe não carregará corretamente dentro do Z-PRO.
Etapa 4: Configurando no Painel Super Admin
Com as informações do servidor em mãos, acesse o Z-PRO:
Faça login com o usuário Super Administrador.
No menu lateral, localize Redes Sociais / Marketplace → App Rocket.Chat.
Clique em + Novo App RC e preencha:
Tenant
Selecione Global ou um tenant específico
URL do servidor
URL base do servidor Rocket.Chat — ex: https://chat.suaempresa.com
Admin User ID (X-User-Id)
User ID obtido na Etapa 2
Admin Auth Token (X-Auth-Token)
Personal Access Token obtido na Etapa 2
Descrição
Identificação opcional — ex: "RC principal da empresa"
Criar usuários automaticamente
Quando ativo, cria automaticamente uma conta no RC para cada agente que acessar o chat pela primeira vez
Ativo
Mantenha ativado
Clique em Criar.
Global vs. Tenant específico: A configuração Global funciona como fallback — qualquer tenant sem configuração própria utilizará a global. Para clientes individuais (revendedores SaaS), o ideal é configurar por tenant.
Etapa 5: Ativando para o Tenant no Painel Admin
Após criar a configuração no Super Admin, é necessário ativar a integração para o tenant no painel administrativo:
Acesse o painel administrativo do tenant.
Vá em Configurações → Integrações → Rocket.Chat.
Ative o toggle Habilitar Rocket.Chat.
Salve.
Etapa 6: Acesso dos Agentes
Após a ativação, os agentes passam a visualizar o Rocket.Chat embutido no Z-PRO:
Caminho de acesso: Comunicação e Marketing → Redes Sociais → Rocket.Chat
O chat interno do servidor RC ficará disponível diretamente nessa seção, sem necessidade de abrir outro sistema.
Se "Criar usuários automaticamente" estiver ativo, a conta no RC é criada automaticamente na primeira vez que o agente acessar esta seção.
Resumo das Funcionalidades
Configurar integração com Rocket.Chat
Super Admin > App Rocket.Chat
Configurar credenciais por tenant
Painel Admin > Configurações > Apps > Rocket.Chat
Ativar para o tenant
Painel Admin > Configurações > Integrações > Rocket.Chat
Acessar o chat interno
Painel Admin > Comunicação e Marketing > Redes Sociais > Rocket.Chat
Possíveis Erros e Soluções
Iframe não carrega dentro do Z-PRO
Causa: Iframe Integration desabilitada no servidor Rocket.Chat.
Solução: Acesse Administração → Geral → Iframe Integration no RC e habilite as opções de Send/Receive.
Erro de autenticação ao salvar a configuração
Causa: User ID ou Auth Token incorretos.
Solução: Gere um novo Personal Access Token no RC (Perfil → Tokens de Acesso Pessoal) e atualize a configuração no Z-PRO.
Agentes não visualizam o Rocket.Chat no menu
Causa: Toggle de ativação não foi habilitado para o tenant.
Solução: Acesse Configurações → Integrações → Rocket.Chat no painel admin e ative o toggle Habilitar Rocket.Chat.
Atualizado
Isto foi útil?