Conectar uma linha de WhatsApp na Darwin — API vs Coexistence
🧩 Requisitos prévios
☎️ Somente para linha nova (API tradicional): o número a ser conectado não deve estar vinculado a uma conta ativa de WhatsApp ou WhatsApp Business. Caso esteja, exclua a conta, aguarde 5 minutos e inicie o processo. (Não se aplica à Coexistence).
🧰 É necessário ter acesso ao Meta Business Manager correto (o mesmo utilizado para campanhas).
📶 O chip (SIM) do número deve estar inserido em um telefone que possa receber SMS ou chamadas.
💳 Tenha em mãos um método de pagamento (cartão) para adicioná-lo no Business Manager.
🔀 Formas de conexão
API para Meta/WhatsApp: a conexão impede o uso desse número no aplicativo móvel do WhatsApp. A partir da conexão, você só poderá acessar as conversas e responder por essa linha através da plataforma Darwin.
WhatsApp Coexistence: permite usar a linha do WhatsApp Business simultaneamente no aplicativo e na API. Assim, você poderá contatar usuários pelo app e pela plataforma; a IA responderá por essa linha e você também poderá utilizá-la no celular/web.
🚀 Passo a passo (comum a ambos os casos)
🔐 Acesse o Darwin
Abra: https://app.getdarwin.ai/login🧭 Menu lateral
Canais > Todos os canais > Conectar novo canal > Adicionar canal do WhatsApp.✅ Confirme o popup
Leia a instrução e confirme para avançar.🔵 Inicie sessão com o Facebook
Use a conta do Facebook associada ao Business Manager onde será conectada a linha.🗂️ Selecione o portfólio comercial
Escolha o portfólio do Business Manager onde ficará a linha.
Importante: utilize o mesmo portfólio que será usado nas campanhas.
Se necessário, complete o site da empresa.
Dica: se houver vários portfólios, verifique qual é o correto.
🔀 Escolha o tipo de conexão
Para Coexistence: “Connect your existing WhatsApp Business app”.
Para API tradicional (somente plataforma): “Start with a new WhatsApp phone number”.
A) 🔌 API para Meta/WhatsApp (somente plataforma Darwin)
A1) 🏷️ Criar a conta e o perfil do WhatsApp Business
Em “Escolha uma conta do WhatsApp Business”, selecione “Criar uma nova conta do WhatsApp Business”.
Em “Selecione um perfil”, escolha “Criar um novo perfil do WhatsApp Business”.
A2) 🧾 Completar os dados
Nome da conta (interno, apenas no Business Manager).
Nome de exibição do WhatsApp Business (deve coincidir com o nome da empresa).
Categoria (selecione a que melhor descreve o negócio).
A3) 📞 Verificar o número de telefone
Selecione “Adicionar novo número” e insira o número a ser conectado.
Escolha como receber o código: SMS ou chamada.
Digite o código recebido no telefone com o chip.
A4) 💳 Adicionar método de pagamento no Business Manager
No popup, selecione “Adicionar método de pagamento” (você será redirecionado ao Business Manager).
No Business Manager: “Método de pagamento > Adicionar método de pagamento” → insira os dados do cartão.
A5) 🎉 Confirmar no Darwin
Retorne ao Darwin > Canais e verifique se o número aparece na lista.
A partir desse momento, a IA responderá via WhatsApp apenas pelo Darwin.
Video Demo
B) 🤝 WhatsApp Coexistence (app + API simultâneos)
B1) Selecione “Connect your existing WhatsApp Business app”.
B2) Digite o número de telefone a ser conectado.
B3) Você receberá um código no WhatsApp Business desse número; insira-o e continue.
B4) Será exibido “WhatsApp Business Account Name” (nome padrão do seu WhatsApp Business) e o campo de fuso horário (geralmente já configurado). Clique em Continuar.
B5) Aparecerá um QR Code para escanear.
No WhatsApp Business, você receberá um botão (do mesmo número que enviou o código de verificação) que permitirá escanear o QR.
Selecione “Share chats” para preservar o histórico de conversas.
Abra a câmera e escaneie o QR.
B6) Clique em Finalizar.
🎉 Pronto
Em Coexistence, você poderá usar a linha tanto no aplicativo WhatsApp Business quanto no Darwin; a IA e sua equipe poderão responder pela mesma linha de forma simultânea.
Na modalidade API tradicional, a linha só poderá ser usada no Darwin.
ℹ️ Nota (limitações oficiais da Coexistence segundo a Meta)
Consulte a documentação oficial da Meta para ver as alterações e limitações vigentes da Coexistence:
https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/