​

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.

​

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.