​
Integrando o Super Agentes ao WhatsApp via Z-API

Este guia explica como conectar seu agente do Super Agentes ao WhatsApp utilizando a Z-API, permitindo que seu agente interaja com usuários diretamente pelo WhatsApp.
A Z-API é uma alternativa não oficial para integração com WhatsApp. Existe o risco de que números conectados através de APIs não oficiais possam ser banidos pelo WhatsApp. Use por sua conta e risco.

​
Visão Geral

A Z-API é uma solução que facilita a integração com WhatsApp sem necessidade de aprovação da Meta ou processo de verificação de negócio. Esta é uma das várias opções disponíveis no Super Agentes para conectar seu agente ao WhatsApp, junto com a API oficial da Meta e a Evolution API.

​
Pré-requisitos

  • Uma conta no Super Agentes
  • Um agente configurado no Super Agentes
  • Uma conta na Z-API com uma instância configurada
  • Um número de WhatsApp para conectar ao seu agente

​
Configurando a Z-API

Antes de conectar seu agente ao WhatsApp, você precisa configurar uma instância na Z-API:
  1. Acesse sua conta na Z-API
  2. No menu lateral esquerdo, clique em Instâncias da Web
  3. Selecione uma instância existente ou crie uma nova
  4. Escaneie o QR Code exibido usando seu WhatsApp (vá em Configurações > Dispositivos Conectados > Conectar um Dispositivo)
  5. Aguarde a confirmação da conexão

​
Conectando seu Agente ao WhatsApp

​
Passo 1: Acessar a Configuração de WhatsApp no Super Agentes

  1. Acesse seu agente no Super Agentes
  2. Vá para a aba Ambientes
  3. Clique em WhatsApp
  4. Clique em Adicionar Conta

​
Passo 2: Selecionar a Z-API

  1. No modal de conexão, selecione Z-API na lista de opções
  2. Você verá dois campos para preencher:
    • API da instância
    • Token de segurança da conta

​
Passo 3: Obter a API da Instância

  1. Na sua conta da Z-API, vá para Instâncias da Web
  2. Selecione a instância que você deseja conectar
  3. Copie a API da instância exibida
  4. Cole este valor no campo API da instância no Super Agentes

​
Passo 4: Obter o Token de Segurança

  1. Na sua conta da Z-API, vá para a seção Segurança
  2. Se você ainda não tem um token, gere um novo
  3. Copie o Token de segurança da conta
  4. Cole este valor no campo Token de segurança da conta no Super Agentes

​
Passo 5: Gerar o Webhook

  1. Após preencher os campos, clique em Gerar Webhook
  2. O Super Agentes gerará um URL de webhook
  3. Copie o URL do webhook exibido

​
Passo 6: Configurar o Webhook na Z-API

  1. Volte para sua conta na Z-API
  2. Vá para a instância que você está conectando
  3. Clique em Editar
  4. Vá para a seção WebHooks
  5. Selecione a opção Ao receber
  6. Cole o URL do webhook que você copiou do Super Agentes
  7. Clique em Salvar

​
Passo 7: Finalizar a Configuração

  1. Volte para o Super Agentes
  2. Clique em Finalizar
  3. Pronto! Seu agente agora está conectado ao WhatsApp via Z-API

​
Verificando a Conexão

Para verificar se a conexão foi estabelecida corretamente:
  1. Envie uma mensagem para o número de WhatsApp conectado
  2. Seu agente deve responder automaticamente
  3. Você também pode verificar o status da conexão na aba Ambientes > WhatsApp

​
Solução de Problemas

​
Webhook Não Funcionando

Se o webhook não estiver funcionando corretamente:
  1. Verifique se o URL do webhook foi copiado corretamente
  2. Certifique-se de que a opção Ao receber está selecionada na Z-API
  3. Verifique se a instância está ativa e conectada

​
Erro de Autenticação

Se você receber erros de autenticação:
  1. Verifique se a API da instância está correta
  2. Confirme se o token de segurança está válido e foi copiado corretamente
  3. Tente gerar um novo token de segurança e atualizar a configuração

​
Conexão Perdida

Se a conexão com o WhatsApp for perdida:
  1. Verifique o status da instância na Z-API
  2. Se necessário, escaneie o QR Code novamente na Z-API
  3. Após reconectar na Z-API, verifique se o webhook ainda está configurado corretamente

​
Limitações e Considerações

  • A Z-API é uma solução não oficial e não é endossada pela Meta (Facebook)
  • Existe o risco de que números conectados através de APIs não oficiais possam ser banidos pelo WhatsApp
  • Recomenda-se usar um número dedicado para seu agente, não seu número pessoal

​
Perguntas Frequentes

P: É possível conectar múltiplos agentes ao mesmo número de WhatsApp?
R: Não, cada número de WhatsApp só pode ser conectado a um agente por vez. P: A Z-API é gratuita?
R: A Z-API é um serviço pago. Consulte o site oficial para informações sobre preços. P: Quais tipos de mensagens meu agente pode enviar e receber?
R: Seu agente pode enviar e receber mensagens de texto, imagens, áudios e documentos. P: É possível usar a API oficial do WhatsApp em vez da Z-API?
R: Sim, o Super Agentes também oferece integração com a API oficial do WhatsApp Business. Essa opção requer aprovação da Meta e um processo de verificação de negócio. Consulte nossa documentação de integração com WhatsApp oficial para mais informações. P: Qual a diferença entre Z-API e Evolution API?
R: Ambas são soluções não oficiais para integração com WhatsApp. A Z-API é um serviço pago com interface amigável, enquanto a Evolution API é de código aberto e pode ser hospedada por você mesmo. Consulte nossa documentação da Evolution API para mais informações.