Conectar o WhatsApp pela Z-API
Passo a passo pra criar a conta na Z-API, parear o seu número e conectar na OctoSolve.
A Z-API é uma alternativa não oficial pra conectar o WhatsApp. A conta é sua: você contrata, cria a instância e pareia o número no painel deles. A OctoSolve só aponta pra essa instância, a gente nunca guarda a sua sessão.
Antes de seguir, entenda o risco: provedores não oficiais podem levar ao banimento do seu número pelo WhatsApp. A recomendação da casa continua sendo a API oficial (Meta), que é estável e sem esse risco. Se for usar mesmo assim, prefira um número novo, dedicado, e faça um aquecimento manual antes (use como pessoa normal por alguns dias) antes de ligar o agente.
Antes de começar
- A Z-API é paga, na faixa de R$100 por mês por número. Ela costuma oferecer alguns dias de teste grátis.
- Você vai precisar do celular com o número em mãos pra ler o QR Code.
- 1 instância = 1 número de WhatsApp.
Parte 1: na Z-API
1. Crie a conta e a instância
Acesse z-api.io, crie sua conta e entre em Instâncias Web. Clique em + Adicionar pra criar a instância do seu número.
2. Abra a instância criada
Clique no nome da instância na lista. Você cai na tela Dados da instância web, que tem tudo o que a gente precisa.
3. Guarde o ID e o Token da instância
Nessa tela ficam as duas credenciais que você vai colar na OctoSolve:
- ID da instância
- Token da instância
Trate essas credenciais como senha: quem tiver elas consegue enviar mensagem pelo seu número. Não compartilhe em grupo, print ou e-mail.
4. Pareie o seu número lendo o QR Code
No celular: WhatsApp → Aparelhos conectados → Conectar aparelho, e leia o QR que aparece na tela da Z-API. O QR expira rápido, então deixe o celular na mão antes de gerar.
5. Confirme que ficou Conectado
Assim que parear, o painel mostra Conectado. É esse estado que a OctoSolve espera.
Não precisa configurar webhook na Z-API. A OctoSolve configura isso sozinha quando você conectar, no passo seguinte.
Parte 2: na OctoSolve
6. Abra o cadastro de conexão
Vá em Configurações → Canais → Conectar canal → WhatsApp e abra Outras formas de conectar. Escolha o card Z-API.
7. Cole as credenciais
Preencha:
- Nome da conexão: um apelido pra você reconhecer depois
- ID da instância: o do passo 3
- Token da instância: o do passo 3
- Token de segurança (Client-Token): deixe vazio, a não ser que você tenha ligado a opção Segurança no painel da Z-API
8. Leia o aviso e finalize
Marque Entendi os riscos e clique em Finalizar. Como o número já está pareado lá, a conexão entra na hora, sem pedir QR aqui.
A conexão aparece na lista de canais com o selo Z-API, e o agente já começa a atender por ela.
Se der erro
| O que aparece | O que fazer |
|---|---|
| Instância Z-API não encontrada | O ID da instância está errado. Confira no painel da Z-API. |
| Token recusado | O Token da instância está errado. Confira no painel. |
| Menção a "null not allowed" | Você ligou a opção Segurança na Z-API. Volte lá, copie o Token de segurança e preencha esse campo na OctoSolve. |
| Conectou mas o agente não responde | Confira se a instância está Conectada no painel da Z-API. Se caiu, pareie o número de novo por lá. |
Desconectar
Pra parar de atender por esse número, use Desconectar no card da conexão em Canais. A gente invalida na hora o recebimento e o agente para de responder. A sua instância na Z-API continua intacta, a gente nunca mexe nela.