A Evolution API v2 permite integrar sua aplicação com a Cloud API oficial do WhatsApp para gerenciar mensagens, contatos, e outras funcionalidades diretamente através da API. A seguir, são detalhados os pré-requisitos e o processo de integração.
Antes de iniciar a integração com a Cloud API do WhatsApp, você deve garantir que os seguintes passos foram concluídos:
Para utilizar a Cloud API oficial do WhatsApp, você precisa de uma Business Manager (BM) aprovada. Este processo envolve:
Após a aprovação da sua BM, você precisa criar um aplicativo na plataforma Facebook Developers:
Após criar o aplicativo, você precisa configurar o número do WhatsApp:
Para evitar que o token de acesso expire, crie um token permanente para o usuário admin da sua BM:
Agora que você completou os pré-requisitos, siga os passos abaixo para configurar a integração com a Evolution API v2.
Para criar uma instância que utiliza a Cloud API do WhatsApp, você precisará acessar a rota /instance/create
da Evolution API v2 com o seguinte corpo de requisição:
instanceName
: Nome da instância que você está criando.token
: Token permanente gerado para o usuário admin da sua BM.number
: Number ID do WhatsApp que você configurou no aplicativo do Facebook Developers.businessId
: ID da conta de negócios associada ao WhatsApp.qrcode
: Defina como false
pois a integração é baseada em token, e não em QR Code.integration
: Use "WHATSAPP-BUSINESS"
para especificar que esta integração é com a API oficial do WhatsApp Business.Depois de criar a instância, é necessário configurar o webhook no aplicativo da Meta para receber eventos e mensagens do WhatsApp.
No painel do seu aplicativo no Facebook Developers, configure o webhook com a seguinte URL:
O token para validar o webhook deve ser configurado na variável WA_BUSINESS_TOKEN_WEBHOOK
no seu arquivo .env
:
Este token será usado pela Meta para validar as requisições enviadas para o seu webhook.
Com a instância criada e o webhook configurado, a sua Evolution API v2 está pronta para operar com a Cloud API oficial do WhatsApp. Todas as mensagens e eventos relacionados ao número configurado serão gerenciados automaticamente pela Evolution API.
Esta documentação fornece uma visão clara e detalhada de como integrar a Cloud API do WhatsApp com a Evolution API v2, desde a preparação necessária até a configuração final. Se você seguir todas as etapas, estará preparado para utilizar as funcionalidades do WhatsApp em sua aplicação através da Evolution API v2.