Configurando o Z-API
Neste guia, você vai aprender como conectar o WhatsApp ao Oráculo usando o serviço Z-API. Com isso, o sistema consegue monitorar seus grupos de WhatsApp e enviar notificações automáticas.
O que é o Z-API?
O Z-API é um serviço externo que faz a ponte entre o WhatsApp e outros sistemas. Ele permite que o Oráculo:
- Monitore grupos de WhatsApp — saiba quem entrou e quem saiu
- Envie notificações — relatórios, alertas e avisos automáticos
Pense no Z-API como um “tradutor” que permite que o Oráculo é o WhatsApp conversem entre si.
Importante: O Z-API é um serviço pago, separado do Oráculo. Você precisa criar uma conta no Z-API e contratar uma instância antes de configurar aqui.
O que é uma instância?
Uma instância é uma conexão entre um número de WhatsApp é o Z-API. Cada instância conecta um número de celular ao sistema.
No Oráculo, você pode ter mais de uma instância com finalidades diferentes:
- Disparo — usada para enviar notificações e relatórios via WhatsApp (uma instância global para todos os experts)
- Monitoramento — usada para escutar grupos de WhatsApp e rastrear quem entra e quem sai (uma por evento, com chip separado para evitar bloqueio)
Dica: Use chips diferentes para disparo e monitoramento. Isso reduz o risco de bloqueio pelo WhatsApp.
Como obter as credenciais no Z-API
Antes de configurar no Oráculo, você precisa de 3 informações do Z-API:
- Instance ID — O identificador único da sua instância
- Token — A chave de acesso da instância
- Client Token — O token da sua conta Z-API (diferente do token da instância)
Para encontrar essas informações:
- Acesse o painel do Z-API em app.z-api.io
- Selecione sua instância
- Na tela de detalhes da instância, você encontra o Instance ID é o Token
- O Client Token fica nas configurações da sua conta (menu do usuário)
Screenshot: [Painel do Z-API mostrando Instance ID e Token da instância selecionada]
Passo a passo para configurar no Oráculo
1. Acesse as configurações
- No menu lateral, clique em Configuração (ícone de engrenagem)
- Clique em Configurações
- Clique na aba WhatsApp
Screenshot: [Página de Configurações com as abas Equipe, WhatsApp e API Keys, com a aba WhatsApp selecionada]
2. Crie uma nova instância
Clique no botão Nova Instância no canto superior direito.
3. Preencha os dados
Na janela que se abre, preencha:
| Campo | O que colocar |
|---|---|
| Nome | Um apelido para identificar (ex: “Disparo Principal”, “Monitor Evento X”) |
| Finalidade | Escolha entre Disparo (enviar mensagens) ou Monitoramento (escutar grupos) |
| Evento | Se escolheu Monitoramento, selecione o evento que será monitorado (opcional) |
| Instance ID | Cole o Instance ID do Z-API |
| Token | Cole o Token da instância |
| Client Token | Cole o Client Token da sua conta |
Screenshot: [Formulário de nova instância Z-API com campos Nome, Finalidade, Instance ID, Token e Client Token]
4. Salve e teste
Clique em Criar. A instância aparecerá na lista.
Para verificar se está tudo certo, clique no ícone de raio ao lado da instância. Se aparecer “Conectada” em verde, está funcionando. Se aparecer um erro em vermelho, confira as credenciais.
5. Configure o webhook no Z-API
Para que o Oráculo receba as notificações de entrada e saída de membros nos grupos, você precisa configurar a URL de webhook no painel do Z-API.
A URL do webhook aparece na parte de baixo da tela de WhatsApp no Oráculo:
https://api.oraculo.work/webhook/zapiCopie essa URL e cole no painel do Z-API, na configuração de webhooks da sua instância.
Gerenciando instâncias
Depois de criada, você pode:
- Editar — Clique no ícone de lápis para alterar nome, finalidade ou credenciais
- Testar — Clique no ícone de raio para verificar se a conexão está ativa
- Desativar — Clique no ícone de lixeira para remover a instância
Atenção: Ao desativar uma instância de disparo, as notificações WhatsApp serão interrompidas. Ao desativar uma de monitoramento, o rastreamento de grupos será pausado.
Perguntas frequentes
Preciso de um chip só para o Oráculo?
Recomendamos que sim. Use um chip dedicado para cada instância, principalmente para monitoramento. Isso evita que seu número principal seja bloqueado pelo WhatsApp.
Quantas instâncias posso ter?
Não há limite no Oráculo. Você pode ter quantas instâncias precisar. O limite depende do seu plano no Z-API.
O Z-API é seguro?
Sim. O Z-API é um dos serviços mais utilizados no mercado para integração com WhatsApp. As credenciais são armazenadas de forma segura no Oráculo.
Posso usar outro serviço no lugar do Z-API?
No momento, o Oráculo só integra com o Z-API para funcionalidades de WhatsApp.