Integrando no WhatsApp via Evolution API
Guia passo a passo para conectar seu agente ao WhatsApp utilizando a Evolution API
Integrando o Super Agentes ao WhatsApp via Evolution API
Este guia explica como conectar seu agente do Super Agentes ao WhatsApp utilizando a Evolution API, permitindo que seu agente interaja com usuários diretamente pelo WhatsApp.
A Evolution API, Z-API e Evolution-QR são alternativas não oficiais 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 Evolution API é uma alternativa não oficial para integração com WhatsApp que permite conectar seu agente do Super Agentes ao WhatsApp através de um QR Code, sem necessidade de aprovação da Meta ou processo de verificação de negócio.
Pré-requisitos
- Uma conta no Super Agentes
- Um agente configurado no Super Agentes
- Acesso a uma instância da Evolution API (você pode configurar sua própria instância ou usar um serviço de terceiros)
Configurando a Evolution API
Antes de conectar seu agente ao WhatsApp, você precisa configurar uma instância da Evolution API:
- Acesse sua instância da Evolution API ou crie uma nova
- Crie uma nova instância no painel da Evolution API
- Dê um nome à sua instância (ex: “super-agentes-test”)
- Salve a configuração
Conectando seu Agente ao WhatsApp
Passo 1: Acessar a Configuração de WhatsApp no Super Agentes
- Acesse seu agente no Super Agentes
- Vá para a aba Ambientes
- Clique em WhatsApp
- Clique em Adicionar Conta
Passo 2: Selecionar a Evolution API
- No modal de conexão, selecione Evolution API na lista de opções
- Clique em Gerar Webhook
Passo 3: Configurar o Webhook na Evolution API
- O Super Agentes gerará um URL de webhook
- Copie o URL do webhook exibido
- Acesse sua instância da Evolution API
- Vá para a seção Eventos
- Selecione Messages
- Cole o URL do webhook no campo WebHook
- Habilite a opção base64
- Clique em Salvar
Passo 5: Finalizar a Configuração
- Volte para o Super Agentes
- Clique em Finalizar
- Pronto! Seu agente agora está conectado ao WhatsApp
Verificando a Conexão
Para verificar se a conexão foi estabelecida corretamente:
- Envie uma mensagem para o número de WhatsApp conectado
- Seu agente deve responder automaticamente
- 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:
- Verifique se o URL do webhook foi copiado corretamente
- Certifique-se de que a opção WebHook Base64 está habilitada
- Verifique se a opção Messages está selecionada nos eventos
Conexão Perdida
Se a conexão com o WhatsApp for perdida:
- Verifique na sua instância da evolution se o QR Code está conectado.
Limitações e Considerações
- A Evolution 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
- O Super Agentes suporta a versão 1.8.2 da Evolution API
- A funcionalidade de conexão via Evolution API está disponível apenas para planos pagos
Perguntas Frequentes
P: Preciso ter um número de telefone dedicado para usar essa integração?
R: Sim, é recomendado usar um número dedicado para seu agente.
P: A Evolution API é gratuita?
R: A Evolution API em si é um projeto de código aberto, mas você precisará de um servidor para hospedá-la ou contratar um serviço de terceiros.
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 Evolution 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.