Configurações
Integrações
Conectar serviços externos: GitHub, Freshdesk e WhatsApp.
A tela Integrações conecta o Hub aos serviços externos que ampliam o sistema. Numa página única, com um card por serviço, você liga o GitHub (deploy e pull requests), o Freshdesk (importação de dados) e o WhatsApp (atendimento pela Z-API ou pela Evolution API). Cada integração tem suas credenciais e opções próprias. É o painel central de conectividade — o que habilita boa parte da automação do produto.
Os provedores de inteligência artificial (Claude e OpenAI) têm tela própria: Configurações → IA. Eles não ficam mais aqui.
Onde fica
Em Configurações, abra Integrações.
GitHub
Conecta repositórios para deploy e acompanhamento de pull requests. Gere um Personal Access Token com a permissão repo, cole no card, informe o Repositório padrão (owner/repo) e clique em Validar e Salvar. Para receber os PRs, configure o webhook do card no GitHub (evento Pull requests) com o mesmo Secret.
Freshdesk
Importa chamados, contatos e empresas do Freshdesk. Em Nova Importação, um assistente de 5 passos conecta (domínio + API Key), configura o que importar, pré-visualiza, importa e conclui. Registros já existentes são ignorados; a importação pode ser desfeita no Histórico.
Conecta números de WhatsApp ao Hub. Cada número é uma instância, e cada instância usa um Provedor: a Z-API (serviço contratado) ou a Evolution API (servidor próprio). Para o atendimento não muda nada — o inbox, os alertas e os chamados funcionam igual nos dois. Em Configurar → Adicionar instância, escolha o provedor, dê um Nome da instância, marque os Grupos vinculados e preencha os dados do provedor.
Instância pela Z-API
Informe o Instance ID (Z-API) e o Token (Z-API) — o Client-Token é opcional. Ao salvar, o Hub mostra uma URL de webhook: clique em Copiar e cole no painel da Z-API, em Configurações → Webhook.
Instância pela Evolution API
- Crie a instância no seu servidor da Evolution API — o Hub não cria por você.
- No Hub, escolha Evolution API e informe o Endereço do servidor, o Nome da instância (Evolution), exatamente como foi criada lá, e a API Key (o token da instância basta).
- Clique em Salvar. O Hub configura o webhook no servidor sozinho e confirma com Webhook configurado no servidor da Evolution API. Se aparecer O webhook não foi configurado, a mensagem diz o motivo (chave recusada, instância que não existe); corrija e use Configurar de novo.
- Feche a janela e clique em Conectar para ler o QR Code.
O provedor é escolhido na criação e não muda depois: para trocar um número de provedor, cadastre uma instância nova. A API Key não volta a ser exibida — ao editar, deixe o campo em branco para manter a atual. Servidor acessado pela internet precisa ser https.
Número principal
Os avisos que o Hub manda por conta própria — deploy, automações e alertas a agentes — saem pelo Número principal. Para escolher, edite a instância e ligue Número principal; ela passa a aparecer na lista como Principal, e a anterior deixa de ser. Sem nenhum principal marcado, vale o número conectado mais antigo. Se o principal estiver desconectado, o aviso sai por outro número conectado. As respostas dentro de uma conversa não mudam: saem sempre pelo número em que o cliente escreveu.
Número que só conversa, sem abrir chamado
Por padrão, toda conversa nova abre um chamado e o cliente recebe uma mensagem automática com o número dele. Para um número em que a equipe só quer receber e responder, edite a instância e desligue Abrir chamado automaticamente. A conversa continua chegando ao inbox e sendo distribuída a um agente do grupo, mas não vira chamado e o cliente não recebe o aviso. Na lista, a instância aparece marcada como Sem chamado automático.
Número com agente fixo
Para que toda conversa nova de um número vá sempre para a mesma pessoa, edite a instância e escolha o Agente responsável. Sem agente fixo, vale a distribuição do grupo. O agente precisa ser de um dos Grupos vinculados. Se ele estiver de férias ou desativado, a conversa segue para a distribuição do grupo. Conversas já abertas não mudam de dono.
Cada instância aparece numa linha com o estado atual: Conectado (com o número), Aguardando conexão ou Desconectado. O Hub confere esse estado sozinho a cada 5 minutos.
Conectar ou reconectar o número
O QR Code é lido aqui mesmo, nos dois provedores — você não precisa entrar no painel da Z-API nem no da Evolution API.
- Clique em Conectar (primeira vez) ou Reconectar (número que caiu). O painel abre na própria linha com o QR Code.
- No celular, abra o WhatsApp em Configurações → Aparelhos conectados → Conectar aparelho e aponte a câmera para o código.
- Assim que o aparelho parear, o painel se fecha sozinho e o estado vira Conectado.
O código se renova sozinho enquanto o painel estiver aberto — o do WhatsApp expira em poucos segundos. Se o painel ficar aberto parado por muito tempo, a renovação automática pausa; Gerar novo código retoma. Reiniciar sessão é para quando a instância trava sem conectar e sem mostrar código. Verificar consulta o estado na hora, sem abrir o painel.
Quando a conexão cai
Com o número fora do ar, o Hub não envia nem recebe mensagem nenhuma: o inbox para de receber, as respostas não saem e os alertas automáticos para os agentes deixam de chegar. Por isso, assim que a queda é detectada, todos os administradores recebem um aviso no sino de notificações (e no pop-up do desktop, para quem usa o agente do Activity). O aviso abre esta tela já com o QR Code na frente.
Os grupos vinculados na instância do WhatsApp definem quais agentes veem as conversas no inbox. Remover uma instância pede confirmação e interrompe o envio e o recebimento por aquele número — as conversas já registradas continuam no inbox.